CLAUDE.md, слэш-команды, субагенты и навыки — как «научить» Claude Code вашему проекту

Канал с гайдами и контентом по ИИшкам и что с ними можно реализовывать, мы выписываем абсолютно всю базу по ИИ в наш канал и там другие полезные материалы: https://t.me/claudedevolper

00 Введение

Claude Code предлагает несколько способов «обучить» его контексту проекта и автоматизировать рабочие процессы. Но не всегда очевидно, когда какой механизм использовать. В этом гайде мы разберём все четыре подхода на конкретном примере.

Проблема

Claude Code не имеет актуальных данных для каждой библиотеки — он не может «помнить», что написано на сайте документации сегодня. Рассмотрим конкретный сценарий:

Пример: приложение с Reatom v1000

Вы разрабатываете SPA с Reatom — мощным стейт-менеджером для React. Claude не знает про новые API v1000: reatomComponent, расширения через .extend(), встроенные формы и роутинг.

Давайте решим эту задачу четырьмя способами и сравним их.

Краткий обзор механизмов

CLAUDE.md

Загружается автоматически при каждом запуске

Слэш-команды

Вызываются вручную через /команда

Субагенты

Отдельное контекстное окно для задачи

Навыки (Skills)

Автообнаружение по описанию задачи

01 CLAUDE.md — память проекта

Что это такое

Markdown-файл, который автоматически загружается при каждом запуске Claude Code. Это «карта памяти» вашего проекта — всё, что Claude должен знать с самого начала.

Где располагается

Вложенные CLAUDE.md

Claude Code обнаруживает файлы CLAUDE.md в подкаталогах. Когда Claude читает файлы из директории с собственным CLAUDE.md, он автоматически добавляется в контекст. Полезно для специфичных инструкций: tests/CLAUDE.md — правила тестирования, src/store/CLAUDE.md — паттерны работы со стейтом.

Решение для Reatom

# CLAUDE.md

## Стейт-менеджмент

Мы используем Reatom v1000 для управления состоянием.
Перед написанием любого кода для стейта:

1. Загрузи документацию: https://v1000.reatom.dev/llms.txt
2. Используй `reatomComponent` вместо обычных хуков
3. Расширяй атомы через `.extend()` для добавления методов
4. Используй `computed` для производных состояний
5. Следуй паттернам в `src/store/`

Что происходит

Каждый разговор начинается с того, что Claude знает: «загрузи документацию Reatom перед написанием кода для стейта».

Context Drift (Дрейф контекста)

В длинных сессиях модель может постепенно «забывать» ранние инструкции в пользу недавней истории разговора. Для критичных правил рассмотрите другие механизмы.

  • Без усилий — загружается автоматически
  • Шарится через git между командой
  • Простота поддержки
  • Дрейф контекста в длинных сессиях
  • Нет отдельного окна — конкурирует с разговором
  • Нет принуждения — Claude решает, следовать ли

02 Слэш-команды

Что это такое

Сохранённый промпт, который вызывается командой /имя-команды. Аналог макроса или горячей клавиши для промптов. Слэш-команды можно вызывать явно (вы вводите /команда) или они могут автоматически срабатывать, если описание команды совпадает с задачей.

Где располагается

Решение для Reatom

---
description: Помощь по Reatom с актуальной документацией
allowed-tools: Read, Grep, Glob, WebFetch
---

Сначала загрузи документацию Reatom v1000:
https://v1000.reatom.dev/llms.txt

Затем, исходя из вопроса пользователя, загрузи
соответствующие страницы документации.

Наконец, ответь на вопрос, используя актуальную
документацию:

$ARGUMENTS

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

/reatom-help как создать форму с валидацией?

Оркестрация через слэш-команды

Слэш-команды могут запускать субагентов, вызывать навыки и организовывать пайплайны (исследование → сканирование кодовой базы → написание документа) вместо выполнения всего за один шаг.

  • Полный контроль момента запуска
  • Поддержка аргументов для вопросов
  • Простая настройка одним файлом
  • Нужно помнить команду
  • Разовый запуск — не сохраняет знания
  • Автозапуск зависит от описания

03 Субагенты

Что это такое

Специализированная AI-«персона» с собственным контекстным окном. Claude делегирует ей целые задачи и получает результаты обратно.

Ключевое преимущество

Субагенты сохраняют ваш основной контекст чистым. Поскольку загрузка документации создаёт много «шума», изоляция в субагенте предотвращает переполнение лимитов контекста в основном чате.

Где располагается

Диаграмма взаимодействия

Решение для Reatom

---
name: reatom-specialist
description: Эксперт по Reatom и реактивному стейту
allowed-tools: Read, Grep, Glob, WebFetch
---

# Специалист по Reatom

Ты — эксперт по Reatom v1000. При получении задачи:

1. Загрузи https://v1000.reatom.dev/llms.txt
2. Найди релевантные страницы документации
3. Загрузи только необходимые страницы
4. Используй паттерны: atom, computed, effect, extend
5. Верни сжатый ответ с примерами кода

Асинхронные агенты

Claude Code поддерживает асинхронных агентов: запустите агента и продолжайте работать, пока он выполняется в фоне. Для отправки в фон используйте Ctrl + B.

  • Автоделегирование по типу задачи
  • Изолированный контекст — не засоряет основной
  • Можно использовать другую модель (opus)
  • Ограничение инструментов для безопасности
  • Тяжелее — запуск отдельного агента
  • Результаты приходят как саммари
  • Нет прямого взаимодействия с агентом
  • Сложнее в настройке

04 Навыки (Skills)

Что это такое

Структурированная возможность с опциональными вспомогательными файлами, которую Claude автоматически обнаруживает и использует в основном разговоре. В отличие от простых слэш-команд, навыки могут включать несколько файлов: справочную документацию, скрипты, шаблоны.

Где располагается

Как Claude видит навыки

Claude решает, применять ли навык, основываясь на его description. Вы можете спросить Claude Code:

> "покажи мне как выглядит <available_skills>?"

Он покажет структурированные блоки:

<available_skills>
  <skill>
    <name>reatom-expert</name>
    <description>
      Помощь по Reatom v1000. Используй при работе
      с атомами, computed, формами, роутингом...
    </description>
  </skill>
</available_skills>

Решение для Reatom

---
name: reatom-expert
description: Помощь по Reatom v1000. Используй при работе с атомами, computed, effect, формами, роутингом или расширениями.
allowed-tools: Read, Grep, Glob, WebFetch
---

# Эксперт по Reatom

Когда пользователю нужна помощь с Reatom:

1. Загрузи https://v1000.reatom.dev/llms.txt
2. Загрузи только релевантные страницы
3. Применяй паттерны: atom, computed, reatomComponent
4. Используй .extend() для добавления методов к атомам
  • Автообнаружение по описанию
  • Работает в основном разговоре — живое взаимодействие
  • Поддержка вспомогательных файлов и скриптов
  • Глубокая упаковка воркфлоу
  • Занимает место в основном контексте
  • Claude решает, когда применять
  • Больше настройки, чем слэш-команды
  • Нельзя вызвать через

06 Выводы

Главный инсайт

Для задач с загрузкой документации субагенты выигрывают, потому что сохраняют ваш основной контекст чистым. В plan mode Claude Code обычно делегирует сканирование репозитория Explore-субагенту.

Рекомендации

Субагенты

Используйте (особенно Explore в plan mode) для сохранения контекста маленьким и сфокусированным

Слэш-команды

Когда нужна явная, повторяемая точка входа в терминале

Навыки

Когда Claude должен автоматически применять богатый воркфлоу (часто с доп. файлами)

CLAUDE.md

Для коротких, всегда-истинных конвенций и стандартов проекта

Канал с гайдами и контентом по claude code, выкладываем новости (когда режут лимиты в 10 раз) и какие инструменты через claude реализуем для проектов, канал: https://t.me/claudedevolper