Переход от правил CLAUDE.md к обеспечению соблюдения на уровне инфраструктуры с помощью Citadel

Проблема накопления правил

Когда Клод игнорировал инструкции, инстинктивной реакцией было добавление новых правил в CLAUDE.md. Начиная с 45 строк, файл разросся до 190 строк за три месяца, но соблюдение правил ухудшилось. Инструкции после 100-й строки стали восприниматься как рекомендации, а не как обязательные правила. Аудит выявил 40% избыточности — правила, повторяющие одно и то же разными словами, противоречащие друг другу и устаревшие правила. Сокращение до 123 строк сразу улучшило соблюдение.

Сдвиг в сторону инфраструктуры

Настоящим решением стало понимание, что CLAUDE.md — это точка входа для ознакомления (проектные соглашения, технологический стек, ключевые приоритеты), а не постоянное хранилище всех правил. Всё остальное должно загружаться только по необходимости. Ключевой сдвиг: перенос контроля с инструкций на окружение.

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

Система прогрессии

Автор описывает пятиуровневую прогрессию:

• Уровень 1: Простые промпты (ничего не сохраняется, ошибки повторяются)
• Уровень 2: CLAUDE.md (правила помогают, но достигают потолка около 100 строк)
• Уровень 3: Навыки (модульная экспертиза, загружаемая по требованию, ноль токенов при бездействии)
• Уровень 4: Хуки (окружение обеспечивает качество, а не инструкции)
• Уровень 5: Оркестрация (параллельные агенты, постоянные кампании, скоординированные волны)

Большинству проектов достаточно Уровня 2 или 3. Ключевое понимание: когда CLAUDE.md перестаёт работать, решение не в добавлении правил, а в переносе контроля в инфраструктуру.

Конкретные реализации

Автор внедрил три ключевые системы:

• Навыки: Файлы Markdown, содержащие шаблоны, ограничения и примеры для конкретных областей. Агент загружает соответствующие навыки для текущей задачи, избегая траты токенов на нерелевантный контекст.
• Файлы кампаний: Структурированные документы, отслеживающие что построено, принятые решения и что осталось. Они сохраняются между сессиями, устраняя ежедневные повторные объяснения.
• Автоматические хуки: Проверка типов при каждом редактировании, сканирование антипаттернов в конце сессии, автоматическое отключение агента после 3 повторных ошибок в одной проблеме и защита от сжатия, сохраняющая состояние перед тем, как Клод сжимает контекст.

Citadel: Открытая система

Полная система, названная Citadel, была открыта по адресу https://github.com/SethGammon/Citadel. Она включает систему навыков, хуки, сохранение кампаний и команду /do, которая автоматически направляет задачи на нужный уровень оркестрации. Созданная на основе 27 задокументированных сбоев у 198 агентов в кодовой базе на 668K строк, каждое правило связано с чем-то, что сломалось.