code-ai-template: Skill for Claude Code

Interrogue o dono até chegarem a entendimento compartilhado — e só sobre o que ainda não está decidido. Modele o assunto como uma árvore de decisão: toda decisão ramifica nas decisões que penduram nela. Pergunta repetida, pergunta já respondida num doc, e pergunta cuja resposta não muda o trabalho são o custo que esta skill existe pra evitar.

Passo zero — o tamanho da fase decide o tamanho do grilling

Antes da primeira pergunta, classifique a fase e diga ao dono qual é:

• Correção ou ajuste — achado do dono em caminho que já existe, defeito medido, mudança que não cria modelo nem tela: zero ou uma rodada. Corrija o que ele descreveu. O que você consegue fechar auditando vira suposição declarada, num bloco único que ele veta numa resposta só. Achado dele não vira varredura transversal: a generalização, se houver, é uma linha de ROADMAP.md, não pergunta.
• Modelagem ou tela nova — muda schema, contrato entre pacotes, ou cria fluxo que o dono vai ver: grilling completo, em rodadas.

Antes de perguntar, procure

Achar fato é seu trabalho, nunca do dono. Toda pergunta candidata passa por três filtros antes de sair:

1. Já está decidido? grep em docs/DECISOES.md, CONTEXT.md, nas regras R-NNN de docs/reference/ e no arquivo da fase de origem em docs/history/fases/. Decisão gravada vira citação na spec, não pergunta. Achado que contradiz um ADR aceito: procure o outro ADR que decide a mesma grandeza — conflito entre decisões é a hipótese principal, e ADR mal feito se corrige por emenda ou superseded, não se re-pergunta.
2. É fato do ambiente? Código, filesystem, gh, banco do lab, laudos já feitos em docs/scratch/: dispare um subagente e olhe. Só as perguntas a jusante da exploração esperam por ela; o resto da fronteira sai agora. Número que não fecha se resolve com o documento (o extrato, o PDF, a linha do banco), não com um menu de hipóteses pro dono confirmar — peça o documento.
3. A resposta muda o trabalho? Pergunta é pra decisão que muda o que o dono vai ver ou o que você vai construir. Recomendação óbvia sem alternativa real vira suposição declarada. O inverso também vale: o que o dono vê na tela — rótulo, subtipo, cadastro, o que um formulário pede — é decisão dele, e sai como pergunta com alternativas, nunca como linha solta dentro da recomendação. Descartar uma alternativa exige o mesmo grep que a recomendação teve.