Открытый GitHub-репозиторий claude-code-best-practice от разработчика Shayan Rais набрал свыше 20 000 звёзд и стал де-факто справочником для тех, кто использует Claude Code в повседневной работе. Проект систематизирует все ключевые концепции инструмента — от субагентов и навыков до хуков и плагинов — и предлагает 69 практических советов по агентной разработке.

От вайб-кодинга к агентной инженерии

Слоган репозитория — «from vibe coding to agentic engineering» — точно описывает сдвиг, который произошёл в экосистеме Claude Code за последние месяцы. Если раньше разработчики просто «разговаривали с AI», то теперь речь идёт о полноценной архитектуре: субагенты (subagents) работают в изолированных контекстах, навыки (skills) автоматически подключаются к диалогу, а хуки (hooks) выполняют пользовательские скрипты вне агентного цикла.

ℹ Что такое агентная инженерия?
Agentic engineering — подход, при котором AI-ассистент не просто отвечает на запросы, а самостоятельно планирует, выполняет и проверяет задачи. Claude Code порождает дочерних агентов, каждый из которых работает в собственном контекстном окне с отдельными инструментами и правами доступа.

Что внутри репозитория

Проект организован как учебный курс. Основные разделы:

КонцепцияРасположениеНазначение
Subagents.claude/agents/Автономные агенты с собственным контекстом и инструментами
Commands.claude/commands/Шаблоны промптов для вызова через /команду
Skills.claude/skills/Автообнаруживаемые навыки с прогрессивным раскрытием
Hooks.claude/hooks/Обработчики событий вне агентного цикла
PluginsПакеты для установкиБандлы навыков, агентов, хуков и MCP-серверов
MemoryCLAUDE.md, .claude/rules/Персистентный контекст между сессиями

Отдельно выделен раздел с 10+ фреймворками для планирования: от Everything Claude Code (148 000+ символов) и Superpowers до Spec Kit, gstack и BMAD-METHOD. Все они следуют единому паттерну.


graph LR
    A[Research] --> B[Plan]
    B --> C[Execute]
    C --> D[Review]
    D --> E[Ship]
    D -->|Проблемы| B

69 советов: выжимка

Репозиторий содержит 69 советов, распределённых по категориям: промптинг, планирование, CLAUDE.md, агенты, навыки, хуки, git/PR, дебаг и другие. Вот несколько ключевых:

«Любой разработчик должен запустить Claude, сказать “run the tests” — и всё сработает с первого раза. Если нет, ваш CLAUDE.md недоработан.»

💡 Топ-3 совета из репозитория
  1. Всегда начинайте с Plan Mode — пусть Claude составит план до написания кода.
  2. Держите CLAUDE.md до 200 строк — длинные файлы Claude начинает игнорировать.
  3. Используйте /compact на 50% контекста — производительность деградирует при заполнении окна.

Отдельно собраны советы от Бориса Черного, создателя Claude Code, — в общей сложности более 50 рекомендаций из его публикаций в X (Twitter).

Новые возможности Claude Code в 2026 году

Репозиторий активно обновляется и уже покрывает новейшие функции:

  • Auto Mode — фоновый классификатор безопасности вместо ручных подтверждений
  • Claude Code Web — запуск задач в облаке на claude.ai/code
  • Channels — приём событий из Telegram, Discord и вебхуков прямо в сессию
  • Agent SDK — Python и TypeScript SDK для создания production-агентов
  • No Flicker Mode — экспериментальный режим рендеринга без мерцания
⚠ Важно
Многие продвинутые функции (Auto Mode, Channels, Scheduled Tasks) находятся на разных стадиях зрелости. Перед использованием в продакшене сверяйтесь с официальной документацией Claude Code.

Почему это важно

Появление структурированных best-practice-репозиториев сигнализирует о взрослении экосистемы AI-кодинга. Claude Code из «умного автокомплита» превратился в платформу с субагентами, плагинами, маркетплейсами и SDK. Для разработчиков, которые хотят выжать максимум из агентного подхода, репозиторий shanraisshan — хорошая точка входа: клонируйте, изучите примеры вроде /weather-orchestrator и адаптируйте паттерны под свой проект.