agents-maintenancelisted

# Agents Maintenance ## Overview Mantém consistência entre arquivos de instrução (CLAUDE.md, AGENTS.md, READMEs) em monorepos. Valida estrutura, links bidirecionais, timestamps e detecta redundâncias/conflitos. **Princípio central**: Cada nível do monorepo tem um par `CLAUDE.md → [[AGENTS.md]]`, formando hierarquia navegável. ## When to Use **Use quando**: - Iniciar sessão em monorepo com múltiplos apps/packages - Criar/mover/renomear apps ou packages - Suspeitar de instruções desatualizadas ou conflitantes - Links quebrados entre arquivos de instrução - Após refatorações que movem código entre módulos **Não use quando**: - Projeto single-app sem subdiretórios - Apenas editando código (não instruções) ## Estrutura Esperada ``` raiz/ ├── CLAUDE.md ─────→ [[AGENTS.md]] ├── AGENTS.md (índice geral de agentes) │ ├── apps/ │ └── app1/ │ ├── CLAUDE.md ─→ [[AGENTS.md]] │ ├── AGENTS.md ─→ [[../../AGENTS.md]] (link pai) │ └── README.md │ └── packages/ └── shared/ ├── CLAUDE.md ─→ [[AGENTS.md]] ├── AGENTS.md ─→ [[../../AGENTS.md]] (link pai) └── README.md ``` **Regras**: 1. Todo CLAUDE.md DEVE ter `[[AGENTS.md]]` 2. Todo AGENTS.md filho DEVE linkar para pai 3. AGENTS.md raiz lista todos os agentes/apps ## Checklist de Validação Execute na ordem: ### 1. Descoberta e Identificação de Candidatos **1.1 Encontrar arquivos existentes**: ```bash find . -name "CLAUDE.md" -o -name "AGENTS.md" -o -name "README.md" ``` **1.2 Iden