BK-239 - Revisao documental de docs/ com unificacao README + AGENTS

Objetivo

Revisar a camada documental de /docs/ para refletir o estado real do repositório após o rename para docs/AGENTS.md, a limpeza de arquivos legados e a necessidade de reduzir duplicação entre onboarding, mapa documental e instruções para agentes.

Escopo previsto

• docs/README.md
• docs/00_SITEMAP_DOCUMENTACAO.md
• docs/AGENTS.md

Motivacao

• docs/README.md e docs/00_SITEMAP_DOCUMENTACAO.md ficaram desatualizados e ainda apontam para arquivos removidos ou inexistentes.
• docs/AGENTS.md veio do antigo docs/AGENT.md, mas continua com instruções antigas e links quebrados.
• O onboarding documental hoje está fragmentado e parcialmente duplicado entre README, SITEMAP e AGENTS.
• A limpeza recente de legados em docs/arquivo_v2026/ e fora de docs/ exige reconciliação documental.

Hipotese de direcao

• docs/AGENTS.md deve virar a fonte principal para orientação operacional de agentes dentro de docs/.
• docs/README.md deve ser absorvido total ou parcialmente por docs/AGENTS.md, evitando dois pontos de entrada quase redundantes.
• docs/00_SITEMAP_DOCUMENTACAO.md deve virar um mapa enxuto e factual, sem prometer arquivos ausentes nem estrutura já removida.

Itens para analisar na proxima rodada

1. Levantar quais seções úteis de docs/README.md ainda merecem sobreviver.
2. Identificar todas as referências quebradas em docs/README.md, docs/00_SITEMAP_DOCUMENTACAO.md e docs/AGENTS.md.
3. Decidir se docs/README.md será:

• removido após migração total do conteúdo útil para docs/AGENTS.md; ou
• mantido como stub curto apontando para docs/AGENTS.md.

1. Reescrever o docs/00_SITEMAP_DOCUMENTACAO.md com base no estado real de docs/.
2. Validar se existem outras docs órfãs que dependem desses links quebrados.

Evidencias ja confirmadas

• docs/AGENT.md foi renomeado para docs/AGENTS.md em 2026-04-08.
• docs/README.md ainda referencia arquivos não encontrados, incluindo PROCESSO_DEPLOY.md, README_FOTOS.md, GUIA_RAPIDO_FOTOS.md e .claude/CLAUDE.md.
• docs/00_SITEMAP_DOCUMENTACAO.md ainda descreve partes do acervo documental como se estivessem completas e consistentes, apesar de divergirem do estado real.

Execucao da rodada

• docs/AGENTS.md foi reescrito como ponto de entrada principal de /docs/.
• docs/README.md foi reduzido a stub minimo de redirecionamento.
• docs/00_SITEMAP_DOCUMENTACAO.md foi reconciliado para descrever apenas o estado real atual de /docs/.
• os links principais referenciados pela nova versao foram rechecados no disco e existem no repositorio atual.
• a segunda opiniao externa trazida pelo usuario via OpenCode confirmou a direcao geral de manter AGENTS como fonte principal e deixar README apenas como stub, embora parte do top 10 de links stale dele misturasse links realmente quebrados com arquivos que continuam existindo.

Dependencias e regras

• Antes de editar, seguir docs/LOCK.md.
• Aplicar a nova regra global de backup incremental da VPS: criar um backup versionado mais novo bkp_original ao lado do arquivo antes da alteração e preservar também o backup mais antigo ainda útil da trilha.

Resultado

• onboarding de /docs/ consolidado em docs/AGENTS.md;
• duplicacao reduzida entre AGENTS, README e SITEMAP;
• referencias obvias a arquivos ausentes removidas do fluxo principal;
• README deixado como stub minimo em vez de removido, para evitar quebra de entradas antigas.

Proximo passo operacional

• publicar changelog desta frente quando o fechamento documental for autorizado;
• depois revisar se docs/arquivo_v2026/ merece nova rodada de arquivamento fino ou somente manutencao como acervo historico.