Портативная инженерная система для Claude Code с хуками, специализированными агентами и возможностью самообучения.

Разработчик, уставший от постоянного повторения инструкций для Claude Code, создал портативную инженерную систему, которая находится в ~/.claude/ и автоматически применяется к каждому проекту. Система решает две основные проблемы: цикл повторения, когда Claude Code сталкивался с той же ошибкой через несколько дней и решал её с нуля, и разрыв между проектами, когда правила, отточенные в одном проекте, отсутствовали в другом.

Компоненты системы

Система включает несколько ключевых компонентов:

• Конституция (CLAUDE.md) – 650 строк правил с иерархией ценностей, границами принятия решений и тремя режимами выполнения в зависимости от сложности задачи
• Хуки, которые детерминированно применяют правила – Не предложения, которые ИИ может проигнорировать, а bash-скрипты, которые физически блокируют опасные команды, такие как принудительные пуши, неправильное использование менеджера пакетов или rm -rf
• Три специализированных агента – Оркестратор, который делегирует, но никогда не пишет код, сборщики, которые работают в изолированных копиях репозитория, и рецензент только для чтения, который не может исправлять проблемы (только сообщает о них)
• Конвейер навыков – От планирования к сборке, отправке и развертыванию в продакшн, в основном автономный с одним обязательным этапом: развертывание в продакшн всегда требует подтверждения
• Иммунная система – Каждая ошибка регистрируется с указанием первопричины И подходов, которые не сработали. Одна и та же ошибка в 2+ проектах становится постоянным правилом, развивая антитела
• Верификация против парадокса Гудхарта – Пять вопросов, на которые каждый агент должен ответить перед заявлением "готово", потому что "все тесты пройдены" не означает, что приложение работает

Составной инженерный подход

Система построена на Составной Инженерии: Планирование → Работа → Обзор → Составление. Этот четвертый шаг – где система улучшает сама себя. Разработчик упоминает конкретные правила, которые ему раньше приходилось повторять ежедневно: "используй pnpm, а не npm", "не удаляй прошедшие тесты" и "запускай тесты перед коммитом".

Проект имеет открытый исходный код по адресу https://github.com/vinicius91carvalho/.claude с полным обзором всех 15 компонентов, доступным по адресу https://tail-f-thoughts.hashnode.dev/self-improving-engineering-system-claude-code.