Большинство воспринимают `CLAUDE.md` как файл с промптом. — 7 марта 2026 г. в 04:39:35.178
Большинство воспринимают `CLAUDE.md` как файл с промптом. И в этом ошибка. Если хочешь, чтобы Claude Code ощущался как сеньор-инженер, который живет прямо внутри твоего репозитория, проекту нужна структура. Claude постоянно нужны 4 вещи: * why → что делает система и зачем * map → где что лежит * rules → что можно и что нельзя * workflows → как в проекте делается работа Я называю это так: **Анатомия проекта для Claude Code** 👇 ━━━━━━━━━━━━━━━ ### 1️⃣ `CLAUDE.md` = память репозитория Держи его коротким. Это главный файл-ориентир. Не dump всех знаний подряд. Только: * Purpose (`WHY`) * Repo map (`WHAT`) * Rules + commands (`HOW`) Если файл становится слишком длинным, модель начинает терять важный контекст. ━━━━━━━━━━━━━━━ ### 2️⃣ `.claude/skills/` = переиспользуемые экспертные режимы Хватит каждый раз переписывать одни и те же инструкции. Превращай типовые рабочие процессы в skills: * чеклист code review * playbook для рефакторинга * процедура релиза * flow отладки Результат: консистентность между сессиями и между участниками команды. ━━━━━━━━━━━━━━━ ### 3️⃣ `.claude/hooks/` = guardrails Модели забывают. Хуки нет. Используй их для того, что должно быть детерминированным: * запускать formatter после правок * гонять тесты при изменениях в ключевых частях системы * блокировать небезопасные директории (`auth`, `billing`, `migrations`) ━━━━━━━━━━━━━━━ ### 4️⃣ `docs/` = прогрессивный контекст Не раздувай промпты. Claude достаточно знать, где лежит источник правды: * обзор архитектуры * ADR'ы (инженерные решения) * operational runbooks ━━━━━━━━━━━━━━━ ### 5️⃣ Локальный `CLAUDE.md` для рискованных модулей Клади небольшие файлы рядом с опасными участками: ```text src/auth/CLAUDE.md src/persistence/CLAUDE.md infra/CLAUDE.md ``` Тогда Claude видит все подводные камни ровно в тот момент, когда работает в этом месте. ━━━━━━━━━━━━━━━ Промптинг временный. Структура постоянна. Когда репозиторий организован так, Claude перестает вести себя как чат-бот... ...и начинает работать как инженер, нативный для проекта.