Pular para conteúdo

As instruções do Claude Code diziam o que o repositório já desmente

O /tweak não tem portão nem numeração — a régua continua sendo a mesma do CLAUDE.md da raiz ("Ajuste pequeno — o caminho curto"). Este registro nasce depois do merge, escrito pelo próprio skill a partir da mensagem de commit.

Motivação

Uma auditoria dos CLAUDE.md, das skills e das rubricas contra o modelo que os lê e contra o próprio repositório achou instruções que o código já desmente — e que levam a erro de verdade: o /devremote-rebuild reconstruía a api e deixava o worker com código velho, a régua dos portões dizia coisas diferentes em três lugares, e o /make recusaria /make preflight.

Comportamento atual

  • /devremote-rebuild mandava reconstruir só api quando apps/api/ mudava, e descrevia Caddy, porta 8180 e containers de banco que saíram do dev-remote em 2026-09-07.
  • rubrics/README.md dizia "até 3 rodadas, sem nota" para os seis portões; o CLAUDE.md dizia "não espere estourar as três" logo depois de "até 10 rodadas".
  • Os passos de fechamento do /spec e do /fix pediam "veredictos com as rodadas", que o Como relatar dos mesmos arquivos proíbe.
  • O /make trazia uma lista de alvos embutida e desatualizada.
  • Fatos vencidos nos CLAUDE.md dos apps (regra de payment_due_day, alembic sem -c, persons/personSeed), e parágrafos que descreviam o que não existe mais.

Comportamento desejado

As instruções descrevem o repositório de hoje e não se contradizem.

Escopo

CLAUDE.md da raiz e dos três apps; as skills spec, fix, tweak, devremote-rebuild, make, run-test, ship, api-monit e web-monit; as rubricas README, detalhamento, correcao e implementacao. Três conflitos entre arquivos decididos pelo usuário: a regra de commit sai dos CLAUDE.md dos apps (vale a da raiz, com as exceções), o e2e roda só contra o dev-remote, e o contrato da API se lê pelo cache do /api-docs.

Fora do escopo

Encurtar os parágrafos de incidente do /spec (carregam o motivo das regras), e a string do seed no infra/prd/Makefile, que não é instrução do Claude Code.

Alterações propostas

Ver o commit. Nenhum arquivo de produto foi tocado.

Impactos

Remove parte dos avisos históricos que o tweak claude-md-da-api, do mesmo dia, havia acrescentado ao CLAUDE.md da API — os que citavam nomes de entidades e rotas inexistentes. O texto corrigido que eles acompanhavam continua.

Critérios de aceite

Sem comportamento testável.

Validação

make preflight limpo e scripts/docs_lint.py ok. Os caminhos, alvos e containers citados foram conferidos contra o repositório e o docker ps na auditoria.

Documentos relacionados

FIX-0022 — achado na mesma auditoria.