Você está transformando uma ideia bruta em uma tarefa bem formada no TODO.md. A ideia bruta:
$ARGUMENTS
Este é um fluxo de refinamento, não de implementação. Não escreva código. Não escreva no
TODO.md até que a tarefa esteja clara e o usuário a tenha aprovado. Trabalhe nestas etapas:
1. Leia a constituição
Encontre os arquivos de constituição do projeto e leia-os — obedeça suas convenções, especialmente os níveis de risco e quaisquer regras de agente autônomo / ciclo de vida do TODO.
- Se
sprint.confexistir, leia os arquivos listados emSPRINT_CONSTITUTION_FILES(em ordem). - Caso contrário, leia os arquivos
AGENTS.md,CLAUDE.mdque existirem (e qualquer guia específico do projeto que eles referenciarem, ex.: umCLAUDE.mdde frontend). - Dê uma olhada em
.githooks/README.mdse presente, para descrever corretamente o efeito downstream. Se nenhum desses existir, informe ao usuário que o repositório ainda não foi inicializado e ofereça/sprint:bootstrap.
2. Fundamente a ideia no código real (não adivinhe)
Encontre os símbolos/arquivos reais que a ideia toca e seu raio de impacto:
- Grafo de código (preferencial, se disponível): as ferramentas
mcp__codegraph__*(codegraph_search,…_callers,…_callees,…_impact,…_context), ou a CLI (codegraph context "<a ideia>",codegraph callers <símbolo>,codegraph impact <símbolo>); executecodegraph sync .primeiro se o índice parecer desatualizado. - Fallback (sem grafo de código): use Grep/Glob para localizar os símbolos relevantes e seus chamadores. Leia os poucos arquivos que realmente importam. Nomeie funções/arquivos concretos e onde a mudança ocorrerá.
3. Interrogue-a (o coração deste skill)
Desafie a ideia contra o que o código já faz. Traga à tona:
- É uma pergunta ou uma tarefa? Se for realmente uma pergunta ("…ou estou perdendo algo?"), responda-a a partir do código primeiro — a lógica existente pode já cobrir parte dela.
- O escopo real e a menor mudança que entrega valor.
- O nível de risco (conforme a constituição /
AGENTS.md). Se for de alto risco, diga — ele não será implementado automaticamente; a cadeia o delega a um humano. - As decisões que são do usuário, não suas (escolhas de produto/UX/política). Pergunte ao usuário essas poucas decisões com AskUserQuestion. Não invente respostas para decisões genuínas de produto; corrija suposições erradas usando evidências do codebase.
4. Esboce UM item estruturado (os quatro ingredientes)
Escreva um rascunho com:
- uma tarefa imperativa clara (sem pergunta),
- o nível de risco,
- um critério de aceitação concreto (qual teste específico deve passar / qual comportamento é verificável),
- dicas de arquivos/funções da etapa 2. Mantenha a menor mudança valiosa. Mostre o rascunho e refine até o usuário ficar satisfeito.
5. Escreva no TODO.md e passe adiante
- Adicione o item aprovado como uma entrada
- [ ]perto do topo doTODO.md. - Pergunte se deve torná-lo o único item ativo — se sim, mova os outros itens atualmente
ativos para dentro de um bloco
<!-- … -->(ou sob## 🚧 Adiado) conforme a convenção de salto, para que a cadeia pegue apenas este. - Não faça commit automaticamente. Informe ao usuário: fazer commit do
TODO.mdinicia a cadeia planejamento→implementação→revisão (a implementação vai para o branch impl, nada faz merge automático). Ofereça-se para fazer o commit se eles quiserem que o processo comece agora.
Mantenha o diálogo enxuto: fundamente primeiro, pergunte apenas as decisões que importam, depois escreva.