C
ChaoBro

Agent Rules Books набирает силу: превращение «Чистой архитектуры» и DDIA в поведенческие руководства для ИИ-агентов

Agent Rules Books набирает силу: превращение «Чистой архитектуры» и DDIA в поведенческие руководства для ИИ-агентов

Что произошло

В начале мая 2026 года на GitHub появился проект открытого исходного кода под названием Agent Rules Books (автор @ciembor), быстро набравший 931 звезду.

То, что делает этот проект, просто, но значимо:

Выделяет ключевые принципы классических книг по программной инженерии и превращает их в файлы правил, которые ИИ-агенты кодирования (Codex, Cursor, Claude Code) могут непосредственно читать и выполнять.

Охваченные классические произведения:

  • «Чистая архитектура» — Роберт Мартин
  • «Рефакторинг» — Мартин Фаулер
  • «Эффективная работа с унаследованным кодом» — Майкл Физерс
  • «Высоконагруженные приложения (DDIA) — Мартин Клеппманн

Каждый файл правил поставляется в размерах mini, nano и full, адаптируясь к различным окнам контекста.

Почему это важно

1. От «книг, которые читают люди» к «правилам, которые выполняют агенты»

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

ИИ-агент кодирования не может непосредственно «прочитать» 400-страничную книгу и затем сознательно применять её принципы. Но если извлечь ключевые правила из книги и превратить их в структурированные файлы правил, агент может автоматически применять эти принципы каждый раз при кодировании:

# Правила чистой архитектуры (мини-версия)
- Направление зависимостей: внутренние слои не зависят от внешних
- Разделение интерфейсов: высокоуровневые стратегии не зависят от низкоуровневых деталей
- Единая ответственность: у каждого модуля только одна причина для изменения
- Явные границы: определяйте границы архитектуры интерфейсами

2. Инженерное значение трёх размеров

РазмерИспользование контекстаПрименимый сценарийГранулярность правил
nano~500 токеновЛёгкие правила, прилагаемые к каждому запросу5-10 самых ключевых принципов
mini~2000 токеновФайлы .clinerules / .cursorrules уровня проектаКлючевые принципы + примеры
full~8000 токеновГлубокий код-ревью / архитектурный ревьюПолные правила + подробные описания

Это отражает ключевую инженерную задачу ИИ-инструментов кодирования в 2026 году: как максимизировать инъекцию инженерных знаний в ограниченном окне контекста.

3. От «промпт-инженерии» к «инженерии правил»

За последний год лучшей практикой ИИ-кодирования было «писать хорошие промпты». Но промпты временны, ручны и легко забываются.

Agent Rules Books представляет парадигмальный сдвиг:

2025: Каждый раз вручную писать промпты → Нестабильные результаты
2026: Предварительно настраивать файлы правил → Агенты автоматически применяют каждый раз

Файлы правил (такие как .cursorrules, AGENTS.md, .clinerules) становятся стандартными конфигурациями для репозиториев кода, так же как .gitignore и README.md.

Охваченные классические произведения и соответствующие правила

Классическое произведениеИзвлечённые ключевые правилаВлияние на поведение агента
«Чистая архитектура»Инверсия зависимостей, определение границ, слоистая архитектураГенерируемый код автоматически следует принципам слоёв
«Рефакторинг»Выделение методов, устранение дублирования, улучшение именованияАвтоматически идентифицирует сегменты кода, подлежащие рефакторингу
«Эффективная работа с унаследованным кодом»Защитная инкапсуляция, идентификация зависти к функциямБезопасно модифицирует унаследованный код
«Высоконагруженные приложения (DDIA)Выбор модели данных, торговля согласованностьюБолее разумные предложения по проектированию баз данных

Оценка ландшафта

Почему этот проект появляется сейчас

  1. Зрелость ИИ-инструментов кодирования: Codex, Cursor, Claude Code теперь могут понимать и выполнять сложные правила
  2. Своевременность стандартизации файлов правил: Платформы начинают поддерживать файлы правил уровня проекта (.cursorrules и др.)
  3. Бутылочное горло инъекции инженерных знаний: Одних промптов недостаточно для передачи инженерных знаний
  4. Традиция сотрудничества сообщества open source: Структурирование и распространение инженерных знаний — сила сообщества open source

Прогнозы тенденций

ВремяПрогноз
2026 Q2Больше классики будет правилофицировано: паттерны проектирования, SOLID, TDD и др.
2026 Q3ИИ-инструменты кодирования встраивают рынки правил, установка лучших практик отрасли в один клик
2026 Q4Предприятия начинают кастомизировать свои собственные Agent Rules, формируя внутренние стандарты кодирования
2027Agent Rules становятся стандартом для репозиториев кода, требования к вакансиям включают «умение писать Agent Rules»

Связь с тенденциями Harness для ИИ-агентов

Эта тенденция полностью согласуется с недавним открытием LangChain (одна и та же модель, только замена Harness даёт прирост 13.7 балла):

  • Инженерия Harness оптимизирует «рамки выполнения» агента
  • Инженерия правил оптимизирует «поведенческие руководства» агента

В сочетании — вот истинные причины скачка в способностях ИИ-кодирования в 2026 году.

Рекомендации к действию

Для разработчиков:

  • Добавьте .cursorrules или AGENTS.md в ваши проекты, внедряя инженерные принципы, которые вы признаёте
  • Начните с nano-версии Agent Rules Books, постепенно расширяя по мере потребностей команды

Для руководителей команд:

  • Рассмотрите преобразование стандартов кодирования вашей команды в файлы Agent Rules
  • Это эффективнее, чем писать объёмные документы разработки — потому что агенты будут фактически выполнять эти правила

Для технических писателей:

  • Если вы читали какие-либо классические произведения по программной инженерии, рассмотрите их преобразование в Agent Rules
  • Это новый способ распространения знаний: не писать книги, а писать правила

Для разработчиков инструментов:

  • Рассмотрите поддержку стандартных форматов для Agent Rules
  • Предоставьте функции визуального управления и сравнения версий для файлов правил