code-ai-template: Skill for Claude Code

Ritual de abertura do plan mode. As regras vivem em AGENTS.md (§O loop, §Docs vivos, §Inbox de achados); aqui está a ordem de execução.

Entre em plan mode antes do passo 1 — esta passada raciocina e escreve spec, e não toca em código.

1. Esvazie o inbox. gh issue list --label achado --state open e leia o que houver. Deixe a triagem pro passo 9: o achado pode caber na fase que você está prestes a desenhar, e você só saberá depois de auditar.
2. Carregue os vivos quentes. docs/SETUP.md (a fase atual — se tiver spec aberta, a fase ainda não fechou: pare e diga isso ao dono), docs/ROADMAP.md (o que vem) e CONTEXT.md (o vocabulário, uma linha por termo; o texto cheio está em docs/reference/dominio.md, frio — leia só o termo que a fase toca). Toque em área com débito conhecido? Some docs/DEBITO-TECNICO.md. CHANGELOG, DECISOES, as regras R-NNN e docs/history/fases/ são frios: grep pelo ID quando precisar de um.
3. Confira o ID da fase. Próximo = maior F-NNN presente em docs/CHANGELOG.md, docs/history/SETUP-HISTORICO.md e docs/ROADMAP.md, mais um — não "o último que eu vi mais um": ID reusado só aparece na revisão de fecho.
4. Audite o código real. A fase candidata mexe em schema, enum ou estado persistido? Leia migrations, tipos e dados antes de qualquer pergunta — spec que presume estado inexistente custa uma fase inteira. Nomes de arquivo e símbolo que entrarem na spec saem daqui verificados. Antes de disparar um agente de auditoria, confira docs/scratch/: laudo já feito sobre o assunto se lê, não se refaz. Dispare subagentes pra varrer em paralelo — subagent_type: varredura (.claude/agents/varredura.md) pra "onde isto está / quantos são / quais os pontos": roda em modelo leve por configuração e devolve só bullets arquivo:linha, que é o que a auditoria precisa. O que exige raciocínio — decidir, comparar desenhos, debugar — fica com você ou com um agente forte; resumo barato não carrega linha confiável.
5. Declare seu model/effort ao dono e, se ele estiver sub ou superdimensionado pra esta fase, peça a troca antes de seguir — sem esperar ele perguntar (CLAUDE.md §Model e effort).
6. Rode o grilling com o material dos passos 1–4 na mão. O passo zero dele — correção (zero ou uma rodada) ou modelagem (rodadas) — decide quanto interrogatório a fase merece; os achados abertos entram na árvore como galhos candidatos ao escopo. O grilling fecha gravando a spec (em docs/SETUP.md, ou no arquivo de plano quando a ferramenta não deixa o plan mode escrever no repo — CLAUDE.md; nesse caso a cópia pro SETUP.md é o passo 8).
7. Aprove a spec com o dono — ExitPlanMode é a aprovação (não pergunte "posso gravar?"). Os passos 8 e 9 escrevem, então só rodam depois de sair do plan mode.
8. Grave no repo, sem commitar. A spec vai integral pro docs/SETUP.md e a fase entra em ## Atual no ROADMAP.md. Copiar é tarefa daqui, não do code mode: a execução pode ser de outro agente, que não lê o arquivo de plano do Claude Code. O commit é da execução, junto com o primeiro código.
9. Feche o inbox. Cada achado lido no passo 1 tem agora um destino: escopo da spec, linha nova no ROADMAP.md, item de DEBITO-TECNICO.md, regra R-NNN, ou ADR — inclusive ADR rejeitado, quando a resposta foi "não vamos fazer" e a recusa é arquitetural. Grave o destino primeiro (issue fechada com o conteúdo em lugar nenhum é triagem pela metade), depois gh issue close em cada um, citando pra onde foi.
10. Entregue ao dono: a spec gravada, os achados fechados e o que cada um virou, e o Model/effort de execução recomendado. Ele dá /clear, e a execução é outra sessão.

Pronto = a spec aprovada e gravada no docs/SETUP.md, zero issue achado aberta sem destino, e o dono sabendo qual model/effort abrir.