agent-rules-books: классика программирования как правила для агента
Агент пишет работающий код, но легко плодит мелкие абстракции, смешивает слои и рефакторит вперемешку с новыми функциями. Здесь 14 наборов правил по известным книгам о дизайне, архитектуре, DDD и legacy-коде. Каждый выпущен в трёх размерах: mini для повседневной работы, nano для тесного контекста и full как полный справочник.
Правила по Clean Code и Code Complete: имена, короткие функции, ответственность, защитное программирование и тесты.
Архитектурные наборы: Clean Architecture, Patterns of Enterprise Application Architecture и три книги о предметно-ориентированном проектировании.
Работа со старым кодом по Майклу Физерсу: характеризационные тесты, швы, разрыв зависимостей, sprout method и wrap method.
Набор release-it по книге Майкла Найгарда: таймауты, повторы, circuit breaker, bulkhead, обратное давление и наблюдаемость.
Каждый SKILL.md по умолчанию загружает версию mini и держит full под рукой как справочный материал.
Когда пригодится
Перед большим рефакторингом, когда агент должен идти маленькими шагами и не менять поведение кода.
Проект на DDD, где агент должен думать о bounded contexts и агрегатах, а не о таблицах и DTO.
Ревью сервиса с очередями и внешними API, где важны таймауты, повторы и отказоустойчивость.
Попросите агента
Отрефактори модуль billing по правилам refactoring: маленькие шаги, тесты после каждого
Проверь этот сервис по правилам release-it и найди вызовы без таймаутов и лимита повторов
Разбей legacy-класс OrderManager, но сначала напиши характеризационные тесты
Вопросы
Как установить agent-rules-books?
Все наборы: npx skills add ciembor/agent-rules-books --all. Один набор: добавьте --skill и имя, например --skill refactoring. Флаг --list покажет список без установки.
Работает ли agent-rules-books в Cursor и Codex?
Да. Правила написаны как обычный Markdown для AGENTS.md и скиллов; настройка под Codex, Claude Code и Cursor описана в docs/USAGE.md.
Чем mini отличается от full?
full — каноничный полный текст правил, mini — рекомендуемая сокращённая версия для реальных задач, nano — самая компактная на случай очень маленького контекста.
