Структура кода Claude, проверенная в нескольких реальных проектах

Что сработало после нескольких проектов

Разработчик на r/ClaudeAI поделился структурой Claude Code, которая не сломалась после внедрения в 2-3 реальных проекта. Эта настройка выдержала нагрузку после добавления нескольких навыков, MCP-серверов и агентов, выйдя за рамки простых демонстраций.

Ключевые структурные решения

• Используйте CLAUDE MD: Пропуск CLAUDE MD на ранних этапах приводил к непоследовательным результатам. После определения соглашений, правил тестирования и стандартов именования выводы стали более предсказуемыми.
• Разделяйте навыки по назначению: Организация навыков как code-review/, security-audit/, text-writer/ работала лучше, чем сваливание логики в одно место. Это сделало активацию чище.
• Внедряйте хуки: Изначальное неиспользование хуков было ошибкой. Хуки PreToolUse и PostToolUse помогали отлавливать плохие команды и грязные выводы, а также были полезны для небольших автоматизаций.
• Разделяйте агентов: Подход с одним агентом плохо масштабировался. Выделенные агенты для проверки, написания и аудита оказались более предсказуемыми.
• Управляйте использованием контекста: Когда использование контекста становится слишком высоким, качество падает. Поддержание его примерно ниже 60% давало заметную разницу.
• Разделяйте ответственность: Смешение конфигурации, навыков и логики выполнения усложняло отладку. Разделение этих аспектов облегчило понимание системы.

Интеграция MCP

Интеграция MCP (Model Context Protocol) с GitHub, Postgres и доступом к файловой системе полностью изменила поведение Claude. По словам разработчика, именно здесь настройка перестала казаться игрушкой и начала вести себя скорее как помощник в разработке, а не просто «запрос → вывод».

Разработчик отмечает, что всё ещё ищет самый чистый способ структурирования агентов, но текущая настройка хорошо работает для проектов, выходящих за рамки простых демонстраций.