← all repositories
ciembor/agent-rules-books

Classic software books distilled for AI agent context windows

Because AI agents code fast but not necessarily well, these rule sets inject classic software engineering wisdom straight into their system prompts.

agent-rules-books
Velocity · 7d
+124
★ / day
Trend
accelerating
star history

What it does This repository translates fourteen classic software engineering books—covering architecture, refactoring, DDD, and legacy code—into drop-in AGENTS.md rules for Codex, Cursor, and Claude Code. Instead of hoping your agent stumbles onto good design, you prepend distilled principles from Fowler, Martin, and others to steer the output.

The interesting bit Every book is released in three context-aware sizes: nano for tight token budgets, mini as the recommended daily driver, and full for canonical reference. The maintainer even catalogs Reddit criticism in CRITICISM.md, which is a level of self-awareness rarely found in prompt-engineering repos.

Key highlights

  • Fourteen rule sets drawn from books like Clean Code, Designing Data-Intensive Applications, and Working Effectively with Legacy Code.
  • Three tool-agnostic Markdown sizes per book, with exact line, rule, and byte counts generated via standard Unix tools.
  • Works across Codex, Cursor, and Claude Code without vendor-specific lock-in.
  • Includes a compatibility matrix and a living document of external criticism.

Caveats

  • The project is explicitly labeled v0.5, so the rule sets are still settling.
  • The README openly points to Reddit criticism rather than claiming infallibility.
  • Compression is extreme—Domain-Driven Design drops from 979 lines to 39—so fidelity to the original text is an act of trust.

Verdict A handy resource if you want AI-generated code that respects boundaries, abstractions, and failure modes. If you do not use agent-specific rules or prefer to read the originals, this is just a well-organized shelf of compressed wisdom.

Frequently asked

What is ciembor/agent-rules-books?
Because AI agents code fast but not necessarily well, these rule sets inject classic software engineering wisdom straight into their system prompts.
Is agent-rules-books open source?
Yes — ciembor/agent-rules-books is open source, released under the MIT license.
How popular is agent-rules-books?
ciembor/agent-rules-books has 2.7k stars on GitHub and is currently accelerating.
Where can I find agent-rules-books?
ciembor/agent-rules-books is on GitHub at https://github.com/ciembor/agent-rules-books.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.