🔥 HARDKODING PRO · CLAUDE CODE · 03/05

Память проекта, rules, Skills и инструменты

Проверено 09.10.2026. Команды, интерфейс и доступность функций Claude Code могут меняться. Внизу гайда — ссылки на официальные источники.

В первых двух гайдах Claude выполнял твои команды. Теперь мы делаем следующий шаг: обучаем сам проект тому, как Claude должен в нём работать.

CLAUDE.mdAuto-memoryRulesSkillsMCP45–60 минут9 визуальных примеров

Хороший Claude Code не должен каждый новый чат спрашивать, как устроен твой проект.

Мы один раз описываем важные правила, отделяем постоянную память от повторяемых workflows и подключаем внешние инструменты только там, где это реально нужно.

HARDKODING PRO · CLAUDE CODE · МАРШРУТ 00 → UI → 01 → 02 → 03 → 04 → 05 · Непонятное слово? Смотри Wiki внизу

00Подготовка UIИнтерфейс 01Первый запуск 02Модели и режимы 03Память и Skills 04Первый проект 05Сессии и Remote Control

← 02 · Модели и режимы 04 · Первый проект →

Результат 03/05: у проекта есть нормальный CLAUDE.md, ты понимаешь scope памяти, умеешь открыть /memory, знаешь разницу между rules и Skills, создаёшь первый SKILL.md и понимаешь, зачем нужен MCP.

Экран 1 из 12 · все исходные объяснения, промпты и схемы сохранены · проверено 09.10.2026

Не складывай всё в один файл

У Claude Code несколько уровней контекста, и каждый нужен для своего.

Карта контекста Claude Code: проект должен сам объяснять агенту, как с ним работать.

Что это	Где живёт	Что туда класть
Global CLAUDE.md	`~/.claude/CLAUDE.md`	Личные предпочтения для всех проектов.
Project CLAUDE.md	`<repo-root>/CLAUDE.md`	Архитектура, команды, соглашения и запреты проекта.
Subdir CLAUDE.md	`frontend/CLAUDE.md`	Правила конкретного модуля.
Rules	`.claude/rules/*.md`	Тематические / scoped инструкции.
Auto-memory	`~/.claude/projects/<project>/memory/`	Предпочтения, коррекции, паттерны между сессиями.
Skill	`.claude/skills/<name>/SKILL.md`	Повторяемый workflow.
MCP	`.mcp.json` / config	GitHub, Jira, Slack, БД, API и другие внешние системы.

Главная идея: CLAUDE.md — не склад всей документации. Если инструкция нужна только иногда, вынеси её в rule или skill.

CLAUDE.md — onboarding нового сотрудника

Claude читает его автоматически в каждой сессии проекта.

CLAUDE.md хранит ключевые правила, команды и контекст проекта.

ПЛОХО

Энциклопедия

вся история;
сотни строк теории;
устаревшие команды;
очевидные правила;
мечты о будущем.

ХОРОШО

Короткий бриф

как запустить;
как тестировать;
где что лежит;
неочевидные конвенции;
жёсткие запреты.

Практический ориентир: держи CLAUDE.md компактным — примерно до двух экранов / около 200 строк. Длинный файл всё равно загрузится целиком, но Claude хуже придерживается buried rules.

Актуальное дополнение: AGENTS.md тоже поддерживается.

Если репозиторий использует AGENTS.md, Claude Code может загружать его как инструкции проекта. Не надо без необходимости размножать одни и те же правила в AGENTS.md и CLAUDE.md: проверь, какие именно файлы действуют для твоего проекта. CLAUDE.md, AGENTS.md и auto-memory — это контекст для модели, а не технический механизм запрета. Для обязательного блокирования опасных действий нужны permissions, hooks и ограничения доступа.

/init: пусть Claude изучит проект

Starter-файл, а не финальная истина.

/init помогает быстро получить стартовый CLAUDE.md, который затем нужно проверить и очистить.

/initисследовать codebase и создать starter CLAUDE.md

Запусти /init.
Дай Claude изучить структуру, build/test команды и conventions.
Открой draft.
Удали неточности и лишнее.
Сделай hard rules короткими.
Если проект в Git — храни project CLAUDE.md вместе с repo.

Не верь /init вслепую. Проектные правила определяешь ты.

Rules и scope

Правило должно жить там, где оно реально нужно.

Глобальные, проектные и локальные правила должны иметь понятный scope.

Везде

~/.claude/CLAUDE.md

Личные глобальные preferences.

Весь проект

./CLAUDE.md

Stack, команды, архитектура, repo rules.

Конкретная директория

api/CLAUDE.md

Правила только API-модуля.

Тематические rules

.claude/rules/testing.md

Тестирование, API design, security и т.п.

my-project/ ├── CLAUDE.md ├── .claude/ │ ├── rules/ │ │ ├── testing.md │ │ └── api-design.md │ └── skills/ │ └── project-check/ │ └── SKILL.md ├── api/ │ └── CLAUDE.md └── src/

Auto-memory ≠ CLAUDE.md

Это отдельный механизм памяти Claude Code.

CLAUDE.md

Ты контролируешь.

Явные правила, архитектура, команды. Можно хранить в Git.

Auto-memory

Claude консолидирует.

Preferences, corrections, patterns между сессиями.

/memoryпосмотреть / настроить память и CLAUDE.md в scope

Промпт: аудит памяти

Проверь текущую систему памяти Claude Code.

Ничего не меняй.

1. Покажи, какие CLAUDE.md сейчас находятся в scope.
2. Объясни отдельно:
   - project CLAUDE.md;
   - user CLAUDE.md;
   - auto-memory.
3. Скажи, что из текущего проекта стоит хранить в CLAUDE.md, а что лучше оставить auto-memory.
4. Покажи, есть ли уже auto-memory для этого проекта.
5. Не добавляй память без моего подтверждения.

Если копирование не сработало, выдели вручную.

Критичное правило бизнеса или deploy flow должно жить явно, а не только как «Claude вроде помнит».

Skills: повторяешь workflow — упакуй его

Skills подгружаются по релевантности и не обязаны постоянно занимать контекст.

Skills превращают повторяемые процессы в reusable workflows.

.claude/ └── skills/ └── project-check/ ├── SKILL.md ├── checklist.md └── scripts/

Progressive disclosure: Claude видит доступные Skills и загружает нужные инструкции / ресурсы, когда skill релевантен.

Промпт: первый /project-check

Создай первый reusable Skill для этого проекта.

Путь:
.claude/skills/project-check/SKILL.md

Название команды:
project-check

Задача skill:
перед завершением работы проверить проект без внесения изменений.

Skill должен:
1. посмотреть git status, если Git доступен;
2. перечислить изменённые файлы;
3. проверить, есть ли релевантные тесты или команды проверки;
4. НЕ исправлять код автоматически;
5. НЕ коммитить;
6. НЕ пушить;
7. выдать короткий отчёт:
   - что изменено;
   - что проверено;
   - что не проверено;
   - есть ли блокеры.

Сначала покажи содержимое SKILL.md.
Создай файл только после моего подтверждения.

Если копирование не сработало, выдели вручную.

/skillsпосмотреть доступные skills

/project-checkзапустить наш skill

Tools и MCP

MCP — подключение внешних систем как tools, а не память.

MCP подключает внешние инструменты и системы, а не заменяет память проекта.

Нужно	Используй
прочитать / изменить файл	file tools
запустить тест	shell / terminal
вспомнить правило	CLAUDE.md / memory
повторить workflow	Skill
читать issues / tickets	MCP
БД / observability / Slack	MCP / CLI / API

.mcp.json может хранить project config;
сервер можно добавить через claude mcp add;
проверка подключения — /mcp;
после подключения Claude получает новые tools.

/mcpconnections и authentication

Не клади токены в CLAUDE.md, Skill или Git.

Практика: обучаем проект

Работаем в учебном проекте из 01/05–02/05.

Практика: собираем CLAUDE.md, rules и первый project-check Skill в одном проекте.

Шаг 1

Запусти /init.

Шаг 2. Аудит CLAUDE.md

Работаем только с текущим проектом.

Сначала ничего не меняй.

1. Найди все CLAUDE.md, которые действуют для текущей рабочей директории.
2. Объясни, откуда загружается каждый из них:
   - глобальный;
   - корневой проекта;
   - вложенный.
3. Покажи, какие инструкции реально влияют на текущую сессию.
4. Найди дубли, противоречия и слишком общие формулировки.
5. Предложи короткую структуру CLAUDE.md для этого проекта.

Пока ничего не редактируй.

Если кнопка не сработала, выдели вручную.

Шаг 3. Нормализовать CLAUDE.md

Теперь обнови только корневой CLAUDE.md проекта.

Цель: сделать его коротким onboarding-документом для Claude Code.

Оставь только то, что реально нужно знать в каждой сессии:

# Project
- что это за проект;
- главная цель.

# Commands
- как запустить проект;
- как запустить тесты;
- как запустить lint/build, если команды существуют.

# Architecture
- 3–7 ключевых директорий и за что они отвечают.

# Rules
- сначала анализ, потом изменение;
- не менять файлы вне задачи;
- не добавлять зависимости без объяснения;
- перед завершением запускать релевантную проверку;
- не утверждать "готово" без evidence.

# Safety
- не печатать секреты;
- не коммитить .env и credentials;
- перед опасной операцией явно спросить.

Не придумывай команды и архитектуру.
Если чего-то не знаешь, сначала найди это в проекте.
После изменения покажи diff.

Если кнопка не сработала, выдели вручную.

Шаг 4

Создай /project-check, затем выполни /skills и сам skill.

Шаг 5

Открой /memory и /mcp, чтобы увидеть реальные слои памяти и tools.

Финальный тест: новая сессия в том же проекте должна знать правила проекта без повторного объяснения.

★

Практикум: свой Skill «Бизнес-аналитик»

Скачай, создай, запусти, проверь — только после проверки переходи дальше.

Шаг 1. Скачай учебный CSV

Это вымышленные продажи: 6 строк, 2 SKU, без персональных данных. Не используй реальные ключи и выгрузки.

Скачать demo_marketplace_sales.csv ↓

Показать CSV, если скачивание недоступно

date,sku,units,unit_price_rub,ad_cost_rub,returns_units
2026-10-01,SKU-A,10,1200,1500,1
2026-10-01,SKU-B,5,2500,2000,0
2026-10-02,SKU-A,8,1200,2000,2
2026-10-02,SKU-B,4,2500,1700,1
2026-10-03,SKU-A,12,1200,1800,0
2026-10-03,SKU-B,6,2500,2300,1

Шаг 2. Установи Skill в учебный проект

Создай папку .claude/skills/sales-report/ и помести в неё SKILL.md. Путь относится именно к выбранной учебной папке.

Скачать SKILL.md ↓

Посмотреть инструкцию Skill

---
name: sales-report
description: Безопасная и проверяемая аналитика учебного CSV продаж по SKU.
---
# Sales Report — учебный Skill

Вход: demo_marketplace_sales.csv со столбцами date,sku,units,unit_price_rub,ad_cost_rub,returns_units.
1. Сначала покажи план. Не меняй файлы до разрешения.
2. Проверь обязательные столбцы, числовые поля, 0 <= returns_units <= units.
3. Не читай реальные заказы или персональные данные; не используй сеть и API-ключи.
4. Для каждой строки: gross = units * unit_price_rub; returns = returns_units * unit_price_rub; net_estimate = gross - returns.
5. Суммируй по SKU: gross, returns, net_estimate, ad_cost_rub; ad_share_pct = 100 * ad_cost_rub / net_estimate.
6. Создай только новые output/report.html и output/checks.md. Сохрани исходный CSV.
7. В checks.md укажи контрольные значения и формулы; проверь независимым пересчётом.
8. Раздели данные и предположения. Не называй net_estimate прибылью: нет комиссий, себестоимости, логистики, налогов.

Контроль A: gross 36000, returns 3600, net 32400, ads 5300, ad_share 16.36%.
Контроль B: gross 37500, returns 5000, net 32500, ads 6000, ad_share 18.46%.
Итог: gross 73500, returns 8600, net 64900, ads 11300, ad_share 17.41%.

Шаг 3. Выполни анализ

Прочитай .claude/skills/sales-report/SKILL.md и demo_marketplace_sales.csv. Сначала объясни план и формулы, не меняя файлы. После моего подтверждения создай output/report.html и output/checks.md. Проверь данные повторным расчётом. Не обращайся к сети, API и другим папкам.

Шаг 4. Проверь результат самостоятельно

SKU	Продажи	Возвраты	После возвратов	Реклама	Доля рекламы
A	36 000 ₽	3 600 ₽	32 400 ₽	5 300 ₽	16,36%
B	37 500 ₽	5 000 ₽	32 500 ₽	6 000 ₽	18,46%
Итого	73 500 ₽	8 600 ₽	64 900 ₽	11 300 ₽	17,41%

Учебная оценка, не прибыль: мы ещё не вычли комиссию, логистику, налоги и себестоимость. Если хотя бы одна цифра не совпала, упражнение не принято.

Чек-лист перед следующим экраном

✅ CSV остался без изменений. ✅ Skill создан. ✅ Отчёт и файл проверок лежат отдельно. ✅ Все числа совпадают. ✅ Выводы основаны на строках и формулы видны.

Источник формата Skills: официальная документация. Проверено 16.10.2026.

✓

Checkpoint 03/05

Здесь начинается системная работа.

Финальный результат: новая сессия понимает проект и умеет использовать его правила и workflows.

Готовность к 04/050 / 9

Понимаю разницу между CLAUDE.md, auto-memory, rules, Skills и MCP.

Запустил /init.

CLAUDE.md проверен и очищен.

Понимаю scope global/project/subdir.

Открыл /memory и понимаю auto-memory.

Создан .claude/skills/project-check/SKILL.md.

/project-check появился и запускается.

Открыл /mcp и понимаю MCP как tool access.

Новая сессия видит правила проекта без повторного объяснения.

✅ 03/05 пройден.
Теперь проект сам несёт инструкции для Claude Code, а повторяемые действия превращаются в reusable workflows.

Дальше 04/05: первый настоящий проект через Claude Code: research → plan → implementation → tests → Git → evidence.

🧠 Wiki этого урока

Короткая расшифровка терминов человеческим языком.

CLAUDE.md: Файл с явными правилами и контекстом проекта.
Root: Корневая папка проекта или репозитория.
Scope: Область действия правила.
Subdir: Поддиректория, папка внутри другой папки.
Auto-memory: Долговременная память Claude Code между сессиями.
Rule: Отдельная инструкция в .claude/rules/.
Skill: Переиспользуемый workflow с инструкциями.
MCP: Model Context Protocol для внешних систем и инструментов.
CLI: Командный интерфейс в терминале.
Repo: Repository, репозиторий проекта под Git.

FAQ

Почему не положить всё в CLAUDE.md?

Потому что он грузится в каждую сессию. Специфические workflows лучше вынести в Skills / rules.

CLAUDE.md перечитывается после каждого сообщения?

Нет. Он загружается при старте сессии. Изменения подхватываются через /memory, /compact или новую сессию.

Skill и MCP — одно и то же?

Нет. Skill = workflow. MCP = новые внешние tools / systems.

Дата проверки и первоисточники · 09.10.2026

Проверены описания CLAUDE.md, AGENTS.md, /init, auto-memory, path-scoped rules, Skills и MCP. Сочетания клавиш и экраны интерфейса могут измениться — перед настройкой сверяйся с актуальной документацией.

HARDKODING PRO · CLAUDE CODE · МАРШРУТ 00 → 05 · Непонятное слово? Смотри Wiki внизу

00Подготовка 01Первый запуск UIИнтерфейс 02Модели и режимы 03Память и Skills 04Первый проект 05Сессии и Remote Control

← 02 · Модели и режимы 04 · Первый проект →