Каталог .claude - это место, где живёт вся кастомизация проекта, и разобраться в нём проще всего, разделив содержимое по ролям. Одни файлы - это инструкция, влияющая на модель (CLAUDE.md, rules). Другие - policy, задающая правила и разрешения (settings, permissions). Третьи - расширение, добавляющее исполняемые компоненты (commands, agents, skills, hooks, MCP). Смешение этих ролей - частый источник путаницы: инструкцию правят, ожидая эффекта policy, а исполняемый компонент принимают за безобидную заметку.

Типичный командный репозиторий раскладывает эти роли по знакомой структуре. В корне - CLAUDE.md и некоммитируемый CLAUDE.local.md, .mcp.json с определениями MCP, .worktreeinclude. Внутри .claude - settings.json и некоммитируемый settings.local.json, а рядом каталоги rules, skills, agents, hooks, output-styles, commands и, если настроена, agent-memory. Полезно один раз увидеть эту карту целиком, чтобы понимать, куда класть новую сущность.

Не каждый проект нуждается во всех каталогах, и это важный принцип. Минимум - короткий CLAUDE.md и .claude/settings.json; остальное добавляют, когда появляется повторяемая задача или измеримый контроль, а не заранее. Правило выбора простое: факты и правила, нужные почти всегда, - в CLAUDE.md и rules; процедура по запросу - в skill; отдельная роль со своим контекстом - в subagent; проверка события - в hook; внешний источник - в MCP; переносимый набор - в plugin; принудительная политика - в managed.

Полезно один раз свести потребность и механизм в таблицу, чтобы не изобретать под каждую задачу новую сущность. Ниже такая карта - от фактов проекта до принудительной политики. К ней возвращаются, когда рука тянется положить процедуру в CLAUDE.md или правило в skill: у каждого механизма своя роль и своя семантика загрузки, и выбор правильного механизма важнее, чем набить одно место всем подряд.