Skip to content

Correções da auditoria de consistência guia/tutorial × template - #4

Merged
ronifabio merged 1 commit into
mainfrom
correcoes-auditoria-consistencia
Sep 1, 2026
Merged

Correções da auditoria de consistência guia/tutorial × template#4
ronifabio merged 1 commit into
mainfrom
correcoes-auditoria-consistencia

Conversation

@ronifabio

Copy link
Copy Markdown
Contributor

O que este PR faz e por quê

Aplica as correções da auditoria de consistência entre o guia, o tutorial e o restante do template (feita em 2026-09-01, após o merge do PR #3):

  1. Workflows renomeados para os nomes utf-* dos comandos (utf-workflow.mdutf-issue.md, ciclo-tarefa.mdutf-task.md, prd.mdutf-prd.md etc.). No Antigravity o comando é o nome do arquivo do workflow — antes, o aluno dessa ferramenta não encontrava o /utf-task que o tutorial ensina. Agora os comandos /utf-* valem nas quatro ferramentas. Todas as referências (cascas .claude/, .cursor/, .opencode/, constituição e prosa dos fluxos) foram atualizadas.
  2. CONTRIBUTING × CI: o texto prometia reprovar PR que não atualizasse docs//specs/, mas o portao-de-entendimento.yml só verifica os 400 caracteres (e o guia §9 diz "é uma regra só"). O texto agora descreve o que o CI realmente faz e atribui a cobrança de docs ao auditor-final e ao colega revisor.
  3. Guia §3.2: o exemplo de glossário do PRD mostrava colunas de entidade/atributos de código, contradizendo o workflow do /utf-prd ("proibido tecnologia") e o esqueleto do prd.md; o mapeamento PT→EN vive no glossário técnico do architecture.md.
  4. Restos de NestJS no guia §6 ("o Nest injeta o service", "esse decorator é um Guard") trocados pelos equivalentes Angular.
  5. Miudezas: linha duplicada do checklist.md na tabela do §3.6, "CPROVADO" → PENDENTE/CONFIRMADA (coerente com o exemplo do Passo 2), 031-31-vaga-concorrente, coluna Blocked adicionada ao Kanban do /utf-backlog (o guia já mandava mover o card para lá), e título do esqueleto architecture.md sem a expansão trocada da sigla SSD.

Nenhuma regra do método muda: o PR só faz os documentos e a automação contarem a mesma história.

Apontamentos da revisão

não se aplica (manutenção do template)

🤖 Generated with Claude Code

- Renomeia os arquivos de .agents/workflows/ para os nomes utf-* dos
  comandos (utf-workflow -> utf-issue, ciclo-tarefa -> utf-task), para os
  comandos /utf-* valerem também no Antigravity; atualiza todas as
  referências nas cascas (.claude, .cursor, .opencode) e na constituição
- CONTRIBUTING: o Portão de Entendimento passa a descrever só a regra que
  o CI verifica (400 caracteres); a atualização de docs//specs/ é cobrada
  pelo auditor-final e pelo colega, não pelo CI
- Guia §3.2: glossário do PRD volta a ser só de negócio (Termo/Significa/
  Não confundir com), com o mapeamento PT->EN no architecture.md
- Guia §6: remove restos de NestJS (Nest -> Angular inject(); decorator ->
  função de Guard)
- Guia: remove linha duplicada do checklist.md (§3.6), corrige CPROVADO ->
  PENDENTE/CONFIRMADA e o zero à esquerda em 31-vaga-concorrente
- Backlog: Kanban ganha a coluna Blocked que o guia já mencionava
- architecture.md: título sem a expansão trocada da sigla SSD

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ronifabio ronifabio added the manutencao PR tecnico, sem spec label Sep 1, 2026
@ronifabio
ronifabio merged commit 44e1812 into main Sep 1, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

manutencao PR tecnico, sem spec

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant