Блок 2: Рабочее пространствоПамять проекта и /init

Память проекта и CLAUDE.md

Время: 15 мин | Уровень: Базовый

Цель урока

Настроить постоянную память проекта через CLAUDE.md, чтобы Claude понимал контекст без повторных объяснений.

Что вы узнаете

  • Что такое CLAUDE.md и как его использовать
  • Как создать память проекта командой /init
  • Какую информацию включать в CLAUDE.md
  • Как редактировать и обновлять память проекта

Реальный кейс: Karthik Sridharan из Slintel ведёт CLAUDE.md как “живой документ” — каждый раз когда Claude делает ошибку, он добавляет правило в память проекта. Источник

Что такое CLAUDE.md

CLAUDE.md — это постоянная память проекта. Настройте один раз — и Claude всегда будет в курсе вашего продукта, терминологии и правил.

Это специальный файл, который Claude Code автоматически читает при запуске. В нём хранится:

  • Описание продукта и проекта
  • Терминология (какие слова использовать)
  • Правила и стандарты
  • Информация о команде
  • Любой важный контекст

Аналогия: CLAUDE.md — это как онбординг для нового сотрудника. Вместо того чтобы каждый раз объяснять “мы называем это Workspace, а не Project”, вы записываете это один раз.

Команда /init

Самый быстрый способ создать CLAUDE.md — команда /init.

Как использовать

  1. Откройте Claude Code в папке проекта
  2. Введите:
/init
  1. Claude проанализирует проект и создаст CLAUDE.md с базовой структурой

Структура CLAUDE.md

Базовый шаблон

# Project Memory
 
## What This Is
[Название продукта] — это [краткое описание].
 
## Key Information
- Целевая аудитория: [кто]
- Стадия продукта: [MVP / Growth / Scale]
- Технологии: [если релевантно]
 
## Terminology
- Используем "Workspace", не "Project"
- Используем "Task", не "Todo"
- Используем "Epic", не "Initiative"
 
## Writing Style
- Активный залог
- Короткие параграфы
- Оксфордская запятая
 
## Team
- Product: [имя]
- Engineering: [имя]
- Design: [имя]

Пример для TaskFlow

# TaskFlow Product Memory
 
## What This Is
TaskFlow — B2B SaaS для управления задачами командами от 10 до 500 человек.
 
## Company Stage
Стадия роста, фокус на enterprise-клиентах.
 
## Key Metrics
- Активных пользователей: 50,000
- Удовлетворённость (NPS): 45
- Отток клиентов: 3%
 
## User Personas
- **Sarah (Enterprise)** — VP Operations, 200+ человек, нужны интеграции и отчётность
- **Mike (Engineer)** — Tech Lead, 15 человек, важна скорость и API
- **Alex (Manager)** — Team Lead, 8 человек, простота и наглядность
 
## Terminology
- Workspace (не Project)
- Task (не Todo, не Item)
- Epic (не Initiative, не Theme)
- Sprint (не Iteration)
 
## Writing Style
- Активный залог
- Короткие абзацы (2-3 предложения)
- Буллеты для списков
- Оксфордская запятая

Как Claude использует CLAUDE.md

Автоматическое применение

После создания CLAUDE.md каждый разговор автоматически учитывает контекст:

Без CLAUDE.md:

Напиши описание новой фичи

→ Claude: “Какой продукт? Какой стиль? Какая терминология?”

С CLAUDE.md:

Напиши описание новой фичи для дашборда аналитики

→ Claude сразу использует правильную терминологию (Workspace, Tasks), стиль (активный залог), и знает контекст (TaskFlow, B2B, enterprise-фокус).

Пример разницы

Запрос:

Напиши user story для экспорта данных

Без CLAUDE.md:

As a user, I want to export data so that I can...

С CLAUDE.md (TaskFlow):

As Sarah (Enterprise VP Operations), I want to export Workspace analytics
to CSV so that I can share Task completion metrics with my leadership team.

Acceptance Criteria:
- Export includes all Tasks from selected Epic
- CSV format compatible with Excel
- Accessible via keyboard navigation

Claude автоматически применил: персону Sarah, терминологию (Workspace, Tasks, Epic), требование accessibility.

Где хранить CLAUDE.md

РасположениеОбласть действияКогда использовать
./CLAUDE.mdТекущий проектОсновной вариант
~/.claude/CLAUDE.mdВсе проектыЛичные предпочтения
./CLAUDE.local.mdТекущий проект, не в GitЛичные заметки

Примечание: Git — система контроля версий, позволяющая отслеживать изменения файлов и делиться ими с командой. Файлы .local.md не попадают в Git и остаются только на вашем компьютере.

Рекомендация для старта: Используйте ./CLAUDE.md в корне проекта.

Практика

Легенда: Бехзод просит вас настроить память проекта для UzTech, чтобы Claude всегда знал контекст.

Задание 1: Создание памяти проекта

Бехзод: “Запусти /init — Claude создаст базовый CLAUDE.md для проекта.”

Задача: Создать базовый CLAUDE.md с помощью команды /init.

Ожидаемый результат: Файл CLAUDE.md в корне проекта с автоматически сгенерированной структурой.

Подсказка

Введите /init — Claude проанализирует проект и создаст файл автоматически. Откройте CLAUDE.md в редакторе, чтобы посмотреть результат.

Задание 2: Персонализация для UzTech

Бехзод: “Добавь специфику проекта — продукт, клиент, терминология.”

Задача: Дополнить CLAUDE.md информацией о проекте UzTech.

Ожидаемый результат: В файле появились:

  • Продукт: UzTech Business (CRM для малого бизнеса в Узбекистане)
  • Клиент: Sardor Karimov, директор по маркетингу UzTech
  • Терминология: “сумы” (не “сум”), “Ташкент” (не “Tashkent”)
Подсказка
Добавь в CLAUDE.md информацию о проекте:
- Продукт: UzTech Business — CRM для малого бизнеса в Узбекистане
- Клиент: Sardor Karimov, директор по маркетингу UzTech
- Терминология: используем "сумы" (не "сум"), "Ташкент" (не "Tashkent")
- Целевая аудитория: владельцы малого бизнеса (салоны, кафе, магазины)

Задание 3: Проверка работы памяти

Бехзод: “Теперь проверь — Claude должен помнить контекст.”

Задача: Убедиться, что Claude использует информацию из CLAUDE.md.

Ожидаемый результат: Claude отвечает, используя терминологию и контекст проекта UzTech.

Подсказка

Начните новый разговор командой /clear, затем спросите:

Кто наш клиент и какой продукт мы делаем?

Claude должен ответить: Sardor Karimov, UzTech Business.

Редактирование памяти

Команда /memory

Для быстрого редактирования CLAUDE.md:

/memory

Claude откроет файл для редактирования.

Добавление правил на лету

Вы можете добавлять правила прямо в разговоре:

Добавь в память проекта: всегда используй метрики при описании фич

Claude добавит это правило в CLAUDE.md.

Что включать в CLAUDE.md

Обязательно

  • Что за продукт/проект
  • Ключевая терминология
  • Стиль написания

Желательно

  • Персоны пользователей
  • Ключевые метрики
  • Информация о команде

Не включайте

  • Чувствительные данные (пароли, ключи API)
  • Временную информацию
  • Слишком много деталей (CLAUDE.md должен быть лаконичным)

Типичные ошибки

Слишком длинный CLAUDE.md

Проблема: Claude тратит контекст на чтение огромного файла. Решение: Держите CLAUDE.md лаконичным, 50-100 строк максимум.

Забыли обновить терминологию

Проблема: Claude использует старые термины. Решение: Регулярно обновляйте CLAUDE.md при изменении терминологии.

Конфликтующие инструкции

Проблема: В CLAUDE.md написано одно, в запросе — другое. Решение: CLAUDE.md имеет приоритет. Если нужно исключение — явно скажите об этом в запросе.

Резюме

  • CLAUDE.md — постоянная память проекта, которую Claude читает при старте
  • Команда /init создаёт базовый CLAUDE.md автоматически
  • Включайте: описание продукта, терминологию, стиль написания
  • Держите CLAUDE.md лаконичным (50-100 строк)

Следующий шаг

Урок 2.3: Введение в агентов — познакомимся с параллельной обработкой и агентами.

Тизер основного курса: В основном курсе вы научитесь создавать многоуровневую память (глобальную, проектную, директорную), неизменяемые правила и интеграцию с командой через Git.

Навигация и режимыВведение в агентов