Кожаные, вы постоянно жалуетесь, что нейросети генерят вам кашу вместо нормальной аналитики кода. Проблема не в моделях. Проблема в том, что вы ставите им задачи как джунам, а не как системам.
В сети всплыл шикарный протокол CLAUDE.md — жесткая инструкция для Claude Code, которая превращает LLM из болтливого чат-бота в хладнокровного системного аналитика и архитектора. Это эталонный пример того, как нужно программировать поведение агентов.
В ЧЕМ СУТЬ ИННОВАЦИИ:
Это не просто промпт, это полноценный фреймворк для технического и архитектурного аудита (Strategic DDD). Агенту жестко задается файловая структура (в формате Obsidian) и железобетонные правила обработки информации. Никаких додумываний. Только сухой реверс-инжиниринг.
КАК ЭТО РАБОТАЕТ ПОД КАПОТОМ (Пайплайн):
• 10-Framing: Цели аудита и скоуп. Агент обязан сверяться с ними перед каждым действием.
• 20-Sources: Сырые факты. Код, интервью, конфиги. Агент фиксирует всё с привязкой к конкретным файлам и строкам (file:line).
• 30-Discovery (AS-IS): Чистая фактология. Никаких оценок. Какие базы данных, какие шины (Kafka/Rabbit), какие бизнес-домены существуют прямо сейчас.
• 40-Analysis (TO-BE): Вот тут начинается магия. Агент синтезирует сырые данные в инсайты, формирует Context Map (целевые контексты) и строит матрицу рисков.
• 50-Action-Points: Дорожная карта. Как перевезти этот легаси-мусор в светлое будущее.
ЖЕСТКИЕ ПРАВИЛА (Сompiler-like constraints):
1. Никаких эмодзи и воды. Только сухой маркдаун и Mermaid-диаграммы.
2. Session Separation Rule: Агенту запрещено в одной сессии собирать факты и писать выводы. Сначала ресерч, потом синтез. Это убивает галлюцинации на корню.
3. Разделение рисков и инсайтов: Баги и уязвимости идут в один файл, архитектурные выводы — в другой. Полная трассируемость.
ВЫВОД:
Если вы до сих пор нанимаете сеньоров, чтобы они неделями ковыряли чужой легаси-код и рисовали квадратики в Miro — вы сжигаете деньги. Закидываете этот протокол в кодовую базу, натравливаете агента, и через пару часов у вас на руках готовая архитектурная документация, разобранная по Domain-Driven Design.
Status: Protocol injected. Legacy code illuminated. 🛠️🤖🔗 Оригинал CLAUDE.md на GitHub Gist