Claude Md Auditor

---
name: claude-md-auditor
description: Use when auditing CLAUDE.md length and structure — trims, path-specific rules, HTML comments, prompt-for-next-session. Triggers on "claude md auditor", "claude md trim", "claude md path specific rules", "doctor claude", "/doctor".
metadata:
  origin: AUTORAL
  source_docs:
    - https://www.youtube.com/watch?v=icM0ewXGvAw (Simon Scrapes - 19 Claude Code Mistakes)
    - https://docs.anthropic.com/en/docs/claude-code/settings
    - https://docs.anthropic.com/en/docs/claude-code/memory
  platforms: [claude-code, opencode, cursor, codex, gemini-cli, hermes, openclaw]
  requires_adapters: [hooks, commands]
---

# Claude.md Auditor — Auditoria Automatizada do CLAUDE.md/AGENTS.md

Auditoria automatizada do **CLAUDE.md/AGENTS.md** - mede linhas/palavras, sugere trims, path-specific rules, HTML comments, prompt-for-next-session. Baseado no vídeo do Simon Scrapes "19 Claude Code Mistakes".

## Quando usar (gatilhos concretos)

- "Claude.md auditor"
- "Claude.md length auditor"
- "Claude.md trim"
- "Claude.md path specific rules"
- "Claude.md html comments"
- "Claude.md prompt for next session"
- "Doctor claude"

## Quando NÃO usar

- General context budget → use `context-budget`
- Strategic compact → use `strategic-compact`

## Contents

| Topic | Reference |
|---|---|
| Problemas 1-5 do pipeline | `references/pipeline-problems.md` |
| Analise de comprimento | `references/pipeline-analysis.md` |
| CLI, hooks, settings patch | `references/cli-hooks.md` |
| Integracao /doctor, validacao | `references/doctor-integration.md` |

## Regra unhobbling (Batch 17f, #77)

80% do system prompt removido sem perda: procure pares conflitantes
("documente conforme apropriado" vs "nao adicione comentarios") e
regras que so faziam sentido para modelos que precisavam de guardrails
para nao errar. Remover atrito > adicionar regra.

## Checklist de Entrega

- [ ] `claude-md-auditor.js` — Core auditor class
- [ ] `cli.js` — CLI commands (audit, trim, add-path-rule, add-prompt-next)
- [ ] `hooks/claude-md-auditor.js` — Stop hook
- [ ] `settings-patch.json` — Settings.json patch
- [ ] Integration with `/doctor` command
- [ ] Testes de integração

---

## Adapters (Por Plataforma)

```
adapters/
├── opencode/
│   ├── hooks/
│   ├── commands/
│   └── README.md
├── cursor/
│   ├── hooks/
│   └── README.md
├── codex/
│   ├── hooks/

## Ponte: regras Claude 5 (leva YouTube rodada 7)

Este auditor mede TAMANHO e estrutura — não semântica de constraints. Para a reescrita das regras (goal+why+done, sem over-triggers/rituais, boundaries answer-vs-action), rode em seguida claude5-prompt-rewrite (7 regras Fable/Opus 5 + scanner regex de anti-padrões + diff para aprovação). Ordem: audite tamanho aqui → reescreva semântica lá.

## Ponte: AGENTS.md-indice + lookup condicional (auditoria semanal 13-18/09)

Quando o AGENTS.md trava o agente (grande demais): vire indice — 1 linha por area apontando para o artefato, com condicao de lookup ("consulte memoria/ apenas ao resolver bug"). Audite aqui o tamanho; o padrao de distribuicao vive em agent-harness-construction (guides-vs-sensors).