agent-rules-books

Definition

agent-rules-books (Matt Pocock / Maciej Ciemborowicz, fork de ciembor/agent-rules-books, v0.5) é um repositório MIT que transforma 14 livros clássicos de engenharia de software em regras executáveis para agentes de IA — AGENTS.md / skills para Codex, Cursor e Claude Code. Cada livro tem 3 formatos tool-agnostic: full (canônico, ~180-520 regras), mini (recomendado, ~28-47 regras) e nano (compacto, ~14-26 regras). As regras são instruções práticas, não resumos dos livros.

Snapshot 2026-08-29 (ed83c80e) confirma headline e estrutura 14 livros como vigente — sem divergência vs página existente.

Snapshot 2026-09-08 (c7eeab38) revalida o mesmo conteúdo (v0.5, 14 livros, métricas do experimento intactas) — único delta observado: stars 433→455 e forks 69→73, sinal de adoção crescente sem mudança de natureza.

Key Points

• 14 rule-sets: A Philosophy of Software Design, Clean Architecture, Clean Code, Code Complete, DDIA, DDD, DDD Distilled, Implementing DDD, PEAA, Refactoring, Refactoring.Guru, Release It!, Pragmatic Programmer, Working Effectively with Legacy Code.
• 3 tamanhos por livro: mini recomendado para uso real; nano para contexto apertado; full como referência canônica. Métricas medidas com wc -l/wc -c.
• Como usar: always-on (copiar no AGENTS.md/CLAUDE.md), on-demand (skill carregado por tarefa), scoped rules (regras só para src/domain/**), MCP/RAG. Ver docs/USAGE.md.
• Compatibilidade: matriz de combinação entre livros em docs/COMPATIBILITY.md — nem toda combinação faz sentido; o repo documenta sinergias e conflitos.
• Validação: experimento vibe-coded-crap (helpdesk CLI gerado com Codex/GPT-5 mini em 80 tasks) comparou refactor com mini rules de A Philosophy of SD (74/100) vs só mencionar o livro (46/100) — sinal qualitativo, não benchmark, segundo o próprio autor.

Snapshot valida que formato permanece tool-agnostic e regras são instruções práticas capturadas em raw/external com hash ed83c80e.

Implications

Para o founder/PM não-técnico, este repo resolve o problema de “como faço o agente escrever código bom sem eu ser engenheiro”: em vez de pedir “siga Clean Code” (vago, 46/100), você cola 30 regras concretas no AGENTS.md ou cria uma skill clean-code que o agente carrega sob demanda. Isso conecta diretamente com agents-md-como-instrucao-operacional (zona 60-150 linhas, pointers) e com plan-first-com-agentes-de-ia — regras melhores geram planos melhores.

Lote 3 confirma snapshot vigente sem necessidade de reescrita — lifecycle promovido l1→l2 pela validação de 3 fontes consistentes.

Relationships

• “uses” agents-md-como-instrucao-operacional — regras ocupam o AGENTS.md como instrução operacional executável
• “enables” plan-first-com-agentes-de-ia — regras concretas melhoram o plano antes de codar
• “enables” especificacao-de-issues-para-agentes — issues mais precisas quando o agente já conhece o vocabulário de qualidade
• “compatible-with” system-design — DDIA/Release It! cobrem a camada de infra que system-design mapeia

Related Concepts

• regras-de-agentes-a-partir-de-livros — hub que organiza os 14 livros em 4 clusters para founders
• clean-code-e-regras-de-legibilidade — cluster fundamentos de código
• arquitetura-e-ddd-para-fundadores — cluster arquitetura e DDD
• vibe-coding — universo de prática onde estas regras são aplicadas

External Links

• https://github.com/mattpocock/agent-rules-books

Sources