LLM Wiki — Synaptic Lattice

regras-de-agentes-a-partir-de-livros

Properties1
tagsvibe-coding, orchestration, technical-literacy, research-note

Leitura de 3 min

Regras de Agentes a partir de Livros Clássicos

Definition

Regras de agentes a partir de livros é a prática de destilar livros clássicos de engenharia de software em regras executáveis (AGENTS.md / skills) que um agente de IA segue ao gerar, revisar ou refatorar código. O repositório agent-rules-books implementa isso para 14 obras, cada uma em 3 formatos (full/mini/nano), com matriz de compatibilidade e guias de entrega (always-on, on-demand, scoped, MCP).

Key Points

  • Por que regras concretas vencem menção vaga: o experimento do repo mostrou 74/100 com mini rules de A Philosophy of SD vs 46/100 só dizendo “obedeça o livro” — instrução vaga é pior que silêncio, como já formaliza agents-md-como-instrucao-operacional.
  • 4 clusters para o founder (em vez de 14 páginas soltas):
  • Escolha do formato: mini é o default para tasks reais; nano quando o budget de contexto aperta; full como referência canonical — ver docs/USAGE.md e docs/COMPATIBILITY.md no raw.
  • Não substitui leitura: as regras são acordos leves de trabalho, não resumo do livro; evitam reproduzir texto protegido e focam em decisões práticas.

Catálogo completo (14 livros) — cada um com página dedicada

Como um founder/PM usa na prática

  • AGENTS.md enxuto (60-150 linhas): cole o mini de 1-2 livros que combinem com a fase do produto (ex.: Clean Code para MVP, DDIA para escala). Isso respeita a zona ideal de agents-md-como-instrucao-operacional.
  • Skills sob demanda: transforme o mini em skill refactoring ou ddd que só carrega quando a tarefa pede — reduz taxonomia e ruído.
  • Scoped rules: aplique regras de DDD só em src/domain/**, regras de Release It! só em src/infra/**.
  • Comparação viva: docs/COMPATIBILITY.md lista sinergias (ex.: Clean Code + Pragmatic Programmer) e tensões (ex.: DDD ceremony vs agilidade de MVP).

Implications

Este hub muda o papel do founder de “pedir código limpo” para operar um contrato verificável: o agente recebe critérios objetivos (ex.: “funções pequenas em um nível de abstração”, “separar commands de queries”, “módulos profundos”) e pode ser cobrado por eles no plano e no PR. Liga orquestração (ciclo-issue-branch-pr-merge) à alfabetização técnica (system-design) sem exigir que o founder vire engenheiro.

Open Questions

  • Qual mini é o melhor default para um MVP vibe-coded sem domínio complexo — Clean Code solo ou Clean Code + Philosophy of SD?
  • Como dosar DDD (cerimônia) em produto early-stage sem over-engineering, usando DDD Distilled como rampa?

Sources

Visão de gráfico

Backlinks