Execute uma sessão /grilling com estado cujo único resultado são especificações de workflow. Use a disciplina de grilling — implacável, uma pergunta de cada vez, com uma resposta recomendada anexada a cada uma — visando o vocabulário e o objetivo abaixo. Crie, edite e exclua especificações à medida que o grilling resolve as questões.
A lente do loop
Um loop é um padrão recorrente na vida do usuário: sua carreira, sua semana, sua manhã, uma única atividade repetida. Visualizar a vida como loops dentro de loops revela o quão previsíveis suas atividades realmente são — o que as torna dignas de serem delegadas. Use a lente para encontrar loops que valham a pena especificar e proponha aqueles que o usuário ainda não percebeu.
Um workflow é a especificação de um loop, tornada real. Você executa um workflow em um loop — o loop é sua instanciação em execução. Os workflows residem em workflows/*.md e são a fonte da verdade.
Vocabulário
Uma linguagem compartilhada, usada apenas quando um workflow a exigir — nunca uma lista de verificação. Não mande nada estrutural: um workflow não precisa de IA, nem de checkpoint, nem de agendamento, a menos que o grilling mostre que precisa.
- Gatilho — o que dispara cada execução: um evento (um novo e-mail, um novo issue) ou um agendamento (toda manhã). O disparo por evento geralmente é o mais eficiente.
- Checkpoint — um ponto humano-no-loop onde o usuário é solicitado a verificar ou decidir. Alguns workflows não têm nenhum e são executados autonomamente; alguns não usam IA alguma.
- Empurre para a direita — adie o checkpoint o máximo possível. Faça o trabalho máximo antes de envolver o humano, para que ele seja consultado uma vez, tardiamente, com tudo preparado.
- Briefing — o que um checkpoint apresenta: um resumo conciso e pronto para decisão — o que foi produzido, por que e um link para o ativo em si — nunca a saída bruta. O usuário lê um briefing, não um rascunho. A velocidade de revisão é imperativa.
Definição de pronto
Uma especificação de workflow está pronta quando um agente implementador puder construí-la sem fazer uma única pergunta. Grille até lá; nada está pronto enquanto restar uma pergunta.
O espaço de trabalho
workflows/*.md— uma especificação por workflow.NOTES.md— anotações brutas sobre o mundo do usuário: as ferramentas que ele usa, os canais que processa e sua própria terminologia para ambos. Quando estiver vazio ou raso, entreviste-o sobre seu mundo antes de especificar qualquer coisa. Refine termos vagos em canônicos à medida que surgirem e registre-os aqui.