O Manager e o Build

O Manager é o chat ao lado do quadro. Ele vê o resumo do projeto, os loops, o Task Book e as últimas passadas, para que você possa fazer perguntas sobre o quadro e planejar com ele.

Os quatro modos

Um modo decide o que o Manager tem permissão para alterar. A conversa permanece em um modo até que você o altere; o Manager nunca muda sozinho.

Modo	Lê seus arquivos	Pode alterar
Ask	Sim, quando uma pasta está vinculada	Apenas PROJECT.md
Plan	Sim, quando uma pasta está vinculada	Cartões do Task Book, após você concordar, e PROJECT.md
Code	Sim	Arquivos dentro da pasta de um loop e PROJECT.md
Build	Não	Propõe um quadro, aplicado apenas quando você pressiona Build it, e PROJECT.md

• Ask responde a perguntas sobre o projeto e o quadro.
• Plan transforma uma conversa em cartões. Ele pergunta antes de escrevê-los.
• Code edita arquivos diretamente, limitado à pasta de um loop. Se esse loop estiver executando uma passada na mesma pasta, o turno do Code aguarda o término dela.
• Build desenha loops. Veja abaixo.

Perguntas

Quando algo importa, o Manager pergunta. Uma pergunta vem com duas a seis opções, no máximo uma delas marcada como recomendada, e uma caixa de texto livre. Nada vem pré-selecionado. Uma pergunta que você deixa sem resposta conta como “sem preferência”.

Direcionamento e edição

Você pode digitar enquanto o Manager está trabalhando. A mensagem é lida no próximo passo, como um direcionamento, em vez de esperar o turno terminar. Editar uma mensagem anterior ramifica a conversa; a outra versão é mantida.

PROJECT.md, o resumo do projeto

O resumo de um quadro é o arquivo PROJECT.md na raiz do projeto. Até que ele seja escrito, a aba Tasks exibe No PROJECT.md yet. Ele é seu: fica no projeto, não na pasta própria do aplicativo, e deve ser incluído no controle de versão. Cada passada de cada bubble o lê primeiro.

Ele tem duas seções conhecidas pelo aplicativo:

• Rules: como o projeto deve ser construído. O Manager altera isso apenas quando você pede.
• Current state: qual é a situação atual do projeto.

Se você pedir para o projeto ser deployable, o Manager adiciona uma linha Deployable em Rules. A partir daí, os bubbles mantêm o build de produção passando e uma configuração de deploy ao lado. Você pode desativar isso no painel do resumo.

Build

O Build estrutura um quadro para você em duas etapas:

1. Ele lê o que conhece (o resumo, o Task Book, a conversa), propõe uma estrutura em termos simples e pergunta se está correto.
2. Assim que você concorda, ele propõe os loops: os bubbles em cada um, um prompt para cada bubble, a pasta que cada loop pode gravar e os Sub-loops que cada loop pendura em seus bubbles Subloop.

A proposta tem o título Build this board?, e o que ela exibe ao lado do botão Build it é exatamente o que o Build fará. O Build em si não escreve nenhum código e nenhum cartão, apenas PROJECT.md. Pressionar Build it:

• solicita a pasta do quadro primeiro, se um loop proposto grava código e nenhuma está vinculada;
• quando uma pasta proposta já pertence a um loop, diz Nothing was built. A folder is already taken. e oferece Edit the existing loop ou Replace & build;
• pergunta antes de substituir um prompt de equipe escrito por você à mão.

Um loop que constrói algo visualizado por uma pessoa ganha um designer antes do codificador e um reviewer depois dele, que executa a revisão visual. Um loop sem interface não ganha nenhum dos dois.

Um quadro vazio ou um Task Book vazio não é um problema: quando há pouco contexto, o Build pergunta.

O Task Book

O Task Book guarda os cartões do quadro em seis colunas: Draft, Approved, Implementing, Review, Done e Blocked.

• Os loops aceitam apenas o trabalho que está em Approved. Draft é o seu portão de entrada.
• Os cartões que você digita, e os cartões que um bubble planejador escreve durante uma execução, começam em Draft.
• Os cartões que o Manager escreve em Plan começam em Approved, já que você concordou com eles no chat.
• Um loop que termina um cartão o move para Review: construído e aguardando o verificador do loop (o arquiteto, ou quem quer que verifique o trabalho nesse loop) aceitá-lo ou devolvê-lo.
• Um cartão aguardando uma subtarefa a menciona, com Stop waiting para permitir que ele prossiga sem ela.