Agent Rules Books — наборы правил для AI-агентов из классических книг

· 2 мин чтения
agent-skills agent-rules code-quality refactoring ddd
📂 Исходный код на GitHub

AGENTS.md правила и skills для AI-агентов: Codex, Cursor и Claude Code, основанные на классических книгах по программированию.

Agent Rules Books — наборы правил для AI-агентов из классических книг

Agent Rules Books — репозиторий с готовыми наборами правил и skills для AI-кодирующих агентов: Codex, Cursor, Claude Code и GitHub Copilot. Правила дистиллированы из классических книг по программированию: Clean Code, Refactoring, Domain-Driven Design, Clean Architecture и Designing Data-Intensive Applications.

Проект MIT-лицензирован и содержит 14 наборов правил, каждый из которых доступен в трёх форматах: mini, nano и full. Установка происходит через Agent Skills CLI — один терминальный вызов, без ручного копирования файлов.

Что внутри

Каждый набор правил соответствует одной книге или ресурсу по разработке программного обеспечения. Вот полный список:

  • A Philosophy of Software Design (John Ousterhout) — борьба с комплексностью через глубокие модули, простые интерфейсы и information hiding
  • Clean Architecture (Robert C. Martin) — проектирование вокруг стабильных границ и dependency rule
  • Clean Code (Robert C. Martin) — читаемость, именование, маленькие функции, ответственность
  • Code Complete (Steve McConnell) — широкий спектр практик по построению ПО: от проектирования функций до defensive programming
  • Designing Data-Intensive Applications (Martin Kleppmann) — надёжность, масштабируемость, консистентность, репликация, транзакции
  • Domain-Driven Design (Eric Evans) — доменное моделирование, ubiquitous language, bounded contexts
  • Domain-Driven Design Distilled (Vaughn Vernon) — краткое введение в DDD без излишней церемонии
  • Implementing Domain-Driven Design (Vaughn Vernon) — практическое применение DDD: агрегаты, доменные события, контексты интеграции
  • Patterns of Enterprise Application Architecture (Martin Fowler) — каталог паттернов: layers, service layer, domain model, data mapper, repository, unit of work
  • Refactoring (Martin Fowler) — безопасные способы улучшения структуры кода без изменения поведения
  • Refactoring.Guru — каталог code smell'ов и рефакторинг-техник
  • Release It! (Michael Nygard) — устойчивость в продакшене: failures, overload, timeouts, circuit breakers, bulkheads, backpressure
  • The Pragmatic Programmer (Andrew Hunt, David Thomas) — прагматичный подход: DRY, ортогональность, автоматизация, быстрая обратная связь
  • Working Effectively with Legacy Code (Michael Feathers) — безопасная работа с устаревшим кодом: characterization tests, seams, dependency breaking

Три формата

Каждый набор правил выпускается в трёх версиях:

  • mini — рекомендуемая версия для повседневного использования. Баланс между полнотой и компактностью.
  • nano — ультракомпактная версия для ситуаций с жёстким лимитом контекста.
  • full — канонический полный источник и справочная версия.

Формат mini наиболее практичен: он содержит достаточно конкретных правил для того, чтобы агент мог применять принципы из книги при генерации, рефакторинге или ревью кода.

Установка

Для установки нужен Node.js с npm. Skills CLI запускается через npx без отдельной установки:

# Установить все наборы правил
npx skills add ciembor/agent-rules-books --all

# Посмотреть доступные skills
npx skills add ciembor/agent-rules-books --list

# Установить один конкретный набор
npx skills add ciembor/agent-rules-books --skill refactoring

Каждый каталог книги содержит стандартный SKILL.md entrypoint. По умолчанию загружается mini-версия, full-файл остаётся доступным как справочный материал.

Эффективность

Автор провёл эксперимент с проектом vibe-coded-crap — намеренно сгенерированным CLI-проектом для тестирования different AGENTS.md файлов. Два рефакторинга одного и того же приложения сравнивались по принципам A Philosophy of Software Design:

  • Ветка с mini-правилами получила оценку 74/100 от ChatGPT.
  • Ветка с единственной инструкцией «OBEY A Philosophy of Software Design» получила 46/100.

Вывод: конкретные правила из книги значительно эффективнее простого упоминания названия книги. Разница проявилась в architectural judgment: глубина модулей, границы ответственности, information hiding — а не в raw counts code smell'ов (1083 vs 1077 по Reek).

Совместимость

Правила designed для работы с:

  • Codex — через AGENTS.md файл проекта
  • Cursor — через project rules или AGENTS.md-style инструкции
  • Claude Code — через CLAUDE.md как project memory или отдельные skills
  • GitHub Copilot — через custom instructions, prompt files

Наборы правил—are tool-agnostic Markdown. Они не привязаны к конкретному редактору и могут быть адаптированы под любой кодирующий агент, который поддерживает project-level инструкции.

Важная оговорка

Правила—inspired by книги, а не являются официальными материалами авторов или издателей. Это practical engineering инструкции, написанные для AI-инструментов. Они намеренно не воспроизводят текст книг — используйте их как lightweight working agreements, а не как конспекты или учебные заметки.

Ссылки

Источник: https://github.com/ciembor/agent-rules-books

Похожие материалы