Структура системных файлов
Claude Code

Это делает харнесс автоматически и в фиксированном порядке — ещё до твоего первого сообщения. Сверху вниз = раньше → позже.

1. Системный промпт + окружениеРоль, доступные инструменты, платформа, дата, модель.
2. Enterprise-политикаУправляемые настройки организации, если заданы — высший приоритет, перебить нельзя.
3. Глобальный ~/.claude/CLAUDE.mdТвои инструкции для всех проектов.
4. Проектные CLAUDE.mdСобираются вверх по дереву от текущей папки до корня репозитория, затем сам проектный.
5. Личный CLAUDE.local.mdЕсли есть (лежит в .gitignore).
6. @-импорты внутри CLAUDE.mdПодтягиваются рекурсивно (до 5 уровней) — так подключают rules/.
7. Авто-память MEMORY.md + recallИндекс фактов и релевантные воспоминания.
8. Метаданные skills / agents / commands / MCPТолько name + description, НЕ тела.
9. Вывод SessionStart-hookНапр. summary прошлой сессии — если хук настроен.

Здесь порядок не жёсткий: это уже решение модели-агента, а не харнесса. Разумная последовательность — от общего к частному:

1. CLAUDE.mdУже в контексте — правила и структура проекта. Отправная точка.
2. README.mdНазначение, как запускать, обзор.
3. Карта файловGlob / обзор дерева — что вообще есть и как организовано.
4. Манифесты зависимостейpackage.json, requirements.txt, Cargo.toml, go.mod — стек и команды.
5. Конфигиtsconfig, vite/next.config, .env.example, CI.
6. Точки входаindex / main / app — откуда стартует код.
7. Углубление по задачеКонкретные модули — только нужные под текущий запрос.

Применяется ко всем проектам на этой машине. На Windows путь: C:\Users\<user>\.claude\

~/.claude/
├── settings.json            # ГЛАВНЫЙ конфиг: hooks, permissions, env, model
├── settings.local.json      # локальные оверрайды (НЕ в git)
├── CLAUDE.md                # глобальные инструкции для ВСЕХ проектов
├── keybindings.json         # кастомные горячие клавиши
│
├── agents/                  # субагенты (.md + YAML-frontmatter)
│   └── planner.md
├── skills/                  # скиллы (папка = 1 скилл)
│   └── <name>/SKILL.md · references/ · scripts/
├── commands/                # slash-команды (/cmd → cmd.md)
├── rules/                   # модульные правила, подключаются из CLAUDE.md
├── hooks/                   # скрипты-хуки, вызываются из settings.json
│
├── plugins/
│   ├── config.json
│   └── installed_plugins.json  # машинно-специфичный — НЕ синкать!
├── mcp.json                 # MCP-серверы (или внутри settings.json)
├── plans/                   # планы (.md)
├── projects/                # история сессий + авто-память по проектам
│   └── <slug>/memory/MEMORY.md  # индекс памяти + *.md (1 факт = 1 файл)
├── session-data/            # снапшоты save-session / resume-session
├── todos/                   # сохранённые TodoWrite-списки
└── statsig/                 # телеметрия/флаги — НЕ трогать

Живёт внутри репозитория. Дополняет и перебивает глобальные настройки для конкретного проекта.

<project>/
├── CLAUDE.md                # инструкции проекта (в git, для всей команды)
├── CLAUDE.local.md          # личные инструкции (НЕ в git) — устаревает
│
└── .claude/
    ├── settings.json        # настройки проекта (в git): hooks, permissions
    ├── settings.local.json  # личные оверрайды (в .gitignore)
    ├── agents/             # агенты только этого проекта
    ├── skills/             # скиллы только этого проекта
    ├── commands/           # slash-команды проекта
    ├── hooks/              # хук-скрипты проекта
    └── mcp.json            # MCP-серверы проекта

Аналогично работает CLAUDE.md: проектный дополняет глобальный, а прямая инструкция пользователя — выше любого файла.

• PreToolUse — до вызова инструмента (валидация, блокировка опасного).
• PostToolUse — после (автоформат, линт, тайп-чек).
• Stop / SessionStart — на финале / старте сессии (сборка, подгрузка контекста).