Prompts essenciais

Prompts calibrados para a IA executar as operações recorrentes do Manifesto. Copie, troque o que estiver entre [colchetes] e rode. São atalhos — a fonte da verdade continua sendo o Manifesto.

Nenhum deles é obrigatório para o dia a dia: a IA orquestra sozinha pela regra de Tarefa ou ADR. Basta dizer o que se quer.

---

Pedir um trabalho (a IA orquestra)

[Descreva o que você quer, em uma ou duas frases. Se houver, cite a tarefa: KBP-12.]

Orquestre pelo Manifesto (manifesto/02-fluxo-adr/04-tarefa-ou-adr.md): decida se é ADR, ache ou
crie a ADR, vincule à tarefa, ande a tarefa no Gestor e mantenha o 004 vivo. No fim, diga o que
decidiu e o que ficou para mim.

Abrir uma ADR

Abra uma nova ADR para: [descreva o trabalho].

1. Peça ao Gestor o número reservado e o esqueleto (sem o Gestor: o maior número em .specs/adr/
   + 1, e o modelo em manifesto/04-templates/01-template-adr.md).
2. Crie a pasta .specs/adr/NNN-slug-em-portugues/ com os seis arquivos e confira o formato. Se
   houver tarefa no Gestor, vincule a ADR a ela (implementa).
3. Produza o 001-executive.md em plan mode: me entreviste sobre o quê e o porquê, o escopo
   (entra agora / pode adiar / fica de fora) e os prazos. Nada técnico nesta fase.
4. Pare para a minha aprovação do executive antes de seguir para o 002 e o 003.

Planejar (003-plan + quiz)

Para a ADR .specs/adr/[NNN-slug]/, escreva o 003-plan.md em plan mode.

- Leia o repositório e a documentação relevante antes de propor
  (manifesto/architecture/01-organizacao.md).
- Estruture: contexto, decisão, consequências, tarefas e o quiz de decisões.
- No quiz, agrupe por tema; em cada pergunta proponha a resposta recomendada (X) e mantenha as
  alternativas descartadas marcadas (❌ + motivo). Faça quantas perguntas fizerem sentido.
- Não escreva código ainda. Espere a minha confirmação de cada decisão do quiz.

Executar um passo da ADR

Execute o passo [T_] da ADR [NNN-slug], seguindo o 003-plan aprovado.

- Atualize o 004-tasks.md (situação do passo, bibliotecas com versão e porquê, decisões, estratégia
  da IA). Com tarefa no Gestor, ela fica Em andamento.
- Contrato primeiro: schema Zod → trecho do OpenAPI → teste da rota contra o contrato (vermelho)
  → implementação (verde) → smoke do domínio (manifesto/architecture/08-testes.md).
- Autorização por escopo em toda rota (manifesto/architecture/10-seguranca.md).
- Sem `any`; sem cor ou medida escrita na UI (use os tokens). Commit seletivo, Conventional Commits,
  com `Tarefa:` e `ADR:` no rodapé.
- Ao final: pnpm lint && pnpm typecheck && pnpm test && pnpm build.

Rodar a auditoria de projeto

Execute a auditoria de projeto seguindo manifesto/architecture/13-auditoria.md.

- Abra uma tarefa de auditoria no Gestor (levantamento, sem refatorar nada); o relatório vai anexo
  a ela. Só abra uma ADR se o relatório for um estudo que outras ADRs vão seguir.
- Rode os 11 eixos (ou só o eixo [N], se focada). Classifique cada achado por severidade
  (CRÍTICO / ALTO / MÉDIO / BAIXO).
- Consolide as 10 ações principais e sugira ADRs de refatoração para os achados CRÍTICO e ALTO
  (cada correção no código é uma ADR).

Fechar uma ADR (005 e 006 → PDF)

Feche a ADR [NNN-slug].

1. Escreva o 005-relatorio-tecnico.md: resumo, commits (hash + mensagem), as tarefas do Gestor
   vinculadas (copiadas do Gestor), testes e smoke criados, arquivos tocados e por quê,
   bibliotecas, validações.
2. Escreva o 006-relatorio-executivo.md: resumo humano, zero técnico
   (Entregue · Impacto · Próximos passos), sem status de prazo.
3. Marque o 001-executive como Concluído, com os prazos reais; atualize o 004 e o índice
   em .specs/readme.md.
4. Rode pnpm adr:pdf [NNN-slug], confira o formato e commite tudo.
5. No Gestor, mova a tarefa para Revisão com um comentário interno (a ADR, os commits, o que ficou
   de fora) e me avise "PDFs prontos para envio".

Sincronizar os tokens com o Figma (dentro de uma ADR)

Atualize os design tokens a partir do Figma (arquivo [fileKey], página [nome]).

- O repositório é canônico (princípio 4): leia o Figma, atualize o tema (globals.css) e o espelho
  em .specs/design/tokens.md. Em conflito, o repositório vence até esta ADR decidir.
- Uma chamada por vez; se a ferramenta limitar as chamadas, pare e diga o que faltou.
- Registre na ADR cada token que mudou (antes → depois).
- Confira que nenhum componente passou a usar cor ou medida escrita na UI (eixo 7 da auditoria).

Atualizar o Manifesto num projeto

Atualize o Manifesto deste projeto para a versão mais nova do jhowdev.

1. Abra (ou use) a ADR em que isso acontece.
2. Rode pnpm manifesto:pull (ou pnpm manifesto:pull --dry-run para só ver o que muda; para ficar
   numa versão publicada, pnpm manifesto:pull --versao X.Y.Z).
3. Leia as seções novas do manifesto/CHANGELOG.md que o comando mostrou e o git diff manifesto/.
4. Diga o que muda para este projeto (regras novas que ele ainda não cumpre viram ADR, quando
   mexem no código, ou tarefa).
5. Só então commite: docs(manifesto): atualiza para a X.Y.Z.

Mudar o Manifesto (no jhowdev)

Mude o Manifesto: [o que mudar e por quê].

1. Abra uma ADR no jhowdev (o Manifesto só muda por ADR, e só lá).
2. Edite manifesto/, suba a versão em manifesto/VERSION (maior: regra muda de sentido ou sai;
   menor: entra capítulo, regra ou modelo; correção: texto, link, exemplo) e escreva a seção
   da versão no manifesto/CHANGELOG.md, com a data e a ADR.
3. Rode pnpm manifesto:check (links, versão e o bloco da regra) e pnpm pdf.
4. Feche a ADR como qualquer outra e, depois do merge na main, crie a etiqueta manifesto-vX.Y.Z
   no commit que publicou a versão (é ela que o manifesto:pull --versao lê).