Requisição 183 — Documentação do Core: Conceitos, Novidades e Limpeza do Legado (FEAT-014, fase 2, onda 5)

Origem: Humano, 2026-09-26: uma requisição por onda, cada uma para um agente em outra infraestrutura. Ondas irmãs: req-182 (onda 4, guias, CLI e API) e req-184 (onda 6, SDD e pipeline). Lote Vinculado: BATCH-187. Status: approved. Autonomia: Nível 2. Commit e push autorizados pelo Humano. Sem pipeline e sem deploy: a publicação no Lab é do agente da req-184. Leitura obrigatória antes de começar:

• skill c2f-documentation;

• req-179.md: regras (§1), mapa de conceitos (§2.3) e descartes (§2.5);

• ai-workspace/pt-br/docs/guides/documentation.md (o contrato);

• BATCH-184.md: achados já registrados;

• exemplos do rigor esperado: concepts/request-lifecycle.md, concepts/resources.md, concepts/hooks.md.

1. Premissa (Humano)

As docs legadas foram escritas por uma geração anterior de agentes, que errava muito. Parta do princípio de que toda doc legada está errada e refaça a partir do código. Use os comentários do código (req-xxx, DEC-xxx), mas confirme cada afirmação lendo a implementação. Há muita coisa implementada sem documentação, e ela também deve entrar.

2. Escopo (pt-br e en, mesmo caminho, na mesma passagem)

O mapa detalhado de cada legado está na req-179 §2.3. Achados que devem entrar (detalhes no BATCH-184): o deploy não atualiza o sitemap.xml (em projects); os achados de segurança A1–A11 da req-181 devem ser apontados em ai-security, sem detalhes de exploração.

3. Regras de convivência (obrigatórias)

1. Só edite ai-workspace/{pt-br,en}/docs/concepts/ (os quatro conceitos da onda 1 só para correção de link), whats-new/, os legados da tabela §2 e sdd/implementation/BATCH-187.md. Os índices (BATCH-INDEX.md, CURRENT.md, VALIDATION-CHECKLIST.md) são do agente da req-179.

2. Não rode c2f docs:build, project:update-all, css:rebuild nem resources:sync: o pipeline é exclusivo do agente da req-184. docs:audit e docs:extract podem ser rodados.

3. Git: git fetch e git rev-list --count HEAD..origin/main antes de cada push (se houver commits novos, git pull --rebase só com a sua árvore limpa); git add só com os seus caminhos (nunca -A nem .); commits pequenos com docs(core): <escopo> (BATCH-187 / req-183) e a linha Co-Authored-By; push após cada commit.

4. Heredoc do Git Bash corrompe barras invertidas e aspas. Use as ferramentas de arquivo (Write/Edit) ou um script salvo em arquivo.

5. Links só para .md existentes; link quebrado aborta o build. A limpeza final não pode deixar link apontando para arquivo apagado.

6. Conteúdo público: sem hosts, IPs, credenciais ou caminhos de servidor reais.

4. Critério de aceite

1. docs:audit --json: 0 erros, nenhum item de concepts/ ou whats-new/ com score > 0 e, depois da limpeza final, legacy = 0 nos dois idiomas.

2. BATCH-187.md com as docs, os achados do código por doc e os hashes dos commits.