Claude Code Best Practice — кураторская база практик, воркфлоу и советов для Claude Code
📂 Исходный код на GitHubКураторская коллекция лучших практик Claude Code: концепции (агенты, команды, скиллы, хуки, MCP), готовые воркфлоу, коллекции скиллов и агентов, кросс-модельные интеграции и 83 совета от Бориса Черного, Тарика и сообщества. Девиз репозитория — от vibe coding к agentic engineering.
Shayan (shanraisshan) собрал один из самых полных публичных справочников по Claude Code. Репозиторий claude-code-best-practice позиционируется не как очередной воркфлоу или набор скиллов, а как курс: сначала разбираешься в примитивах (агенты, команды, скиллы, хуки), а потом собираешь из них собственный процесс. Девиз проекта — переход от vibe coding к agentic engineering: не использовать Claude как чат-бота, а строить вокруг него инженерную систему.
Что внутри
Концепции
Репозиторий структурирован по примитивам Claude Code, и для каждого есть пояснение, где он живёт и как применяется:
| Примитив | Расположение | Что это |
|---|---|---|
| Subagents | .claude/agents/<name>.md |
специализированные агенты с собственным контекстом |
| Commands | .claude/commands/<name>.md |
slash-команды для повторяющихся воркфлоу |
| Skills | .claude/skills/<name>/SKILL.md |
навыки с прогрессивным раскрытием |
| Hooks | .claude/hooks/ |
детерминированные ограждения и автоматизация |
| MCP Servers | .claude/settings.json, .mcp.json |
интеграция внешних инструментов |
| Memory | CLAUDE.md, .claude/rules/ |
инструкции и правила для каждой сессии |
| Settings | .claude/settings.json |
права, модель, permissions, output styles |
Для каждой концепции есть раздел best practice и отдельный каталог implementation/ с реальными примерами из репозитория автора — то есть можно не просто прочитать теорию, а посмотреть, как это работает в живом проекте.
Воркфлоу
Большинство популярных методологий разработки сведены в таблицу с общей архитектурой Research → Plan → Execute → Review → Ship. Среди них:
- Superpowers (obra/superpowers) — brainstorming → writing-plans → subagent-driven-development → TDD → verification;
- Skills for Real Engineers (mattpocock/skills) — to-spec → to-tickets → implement → code-review;
- Everything Claude Code (affaan-m/ECC) — 68 агентов, 94 команды и 286 скиллов;
- Spec Kit (github/spec-kit), OpenSpec (Fission-AI), Get Shit Done (gsd-build), agent-skills (addyosmani) и другие.
Каждый воркфлоу расписан как последовательность шагов с помеченными жёлтым «подциклами» (TDD, code review), которые повторяются внутри основного шага.
Коллекции скиллов и агентов
Отдельные таблицы собирают репозитории, которые по сути являются библиотеками SKILL.md или .claude/agents/*.md: от официальных anthropics/skills до 170 агентов от wshobson и 1500+ скиллов из awesome-agent-skills.
Кросс-модельные воркфлоу
Claude Code можно использовать вместе с другими моделями — Codex, Gemini, GPT, DeepSeek — тремя способами: плагин (другая CLI работает внутри Claude Code через slash-команды), MCP (модель вызывается как инструмент) и роутер (эндпоинт API заменяется на другого провайдера). В таблице — конкретные проекты: claude-code-router, CLIProxyAPI, официальный codex-plugin-cc.
Советы и хитрости
Самая ценная часть — 83 совета, каждый с источником от команды Claude Code (Борис Черный, Тарик) или сообщества. Несколько ключевых тем:
Планирование. Всегда начинать с plan mode. Писать подробные спецификации до передачи задачи — чем конкретнее описание, тем лучше результат. Разбивать PRD на вертикальные срезы (tracer bullets), которые проходят все слои сразу, а не фазами.
Контекст. «Тупая зона» наступает примерно на 40% контекста — новичкам советуют держаться до 40%, опытным — агрессивно до 30%. Для умной работы лучше использовать subagents: 20 чтений файлов и 12 грепов остаются в контексте ребёнка, а в основной возвращается только вывод.
Сессии. Каждый ход — точка ветвления: продолжать, /rewind, /clear или /compact. Новые задачи заслуживают новой сессии. /compact с подсказкой работает лучше автокомпакта.
CLAUDE.md. Держать до 200 строк. Использовать .claude/rules/*.md для автозагрузки правил и YAML-frontmatter с glob для ленивой загрузки. Для монорепозиториев — несколько CLAUDE.md.
Агенты и скиллы. Использовать feature-specific subagents вместо универсальных. Скиллы — это папки, а не файлы: references/, scripts/, examples/ для прогрессивного раскрытия. Поле description в SKILL.md — триггер для модели, а не резюме.
Хуки. PreToolUse-хук для замера использования скиллов, PostToolUse — для автоформатирования кода, Stop-хук — чтобы подтолкнуть агента проверить работу.
Git и PR. Держать PR маленькими (медиана — 118 строк), всегда squash merge, коммитить как минимум раз в час.
Продвинутые фишки. /permissions с wildcard-синтаксисом вместо dangerously-skip-permissions, /sandbox (84% меньше промптов), auto mode вместо пропуска прав, /loop и /schedule для повторяющихся задач, Ralph Wiggum loop для долгих автономных задач.
Отчёты и материалы
В репозитории есть отчёты по глубоким темам (агентная память, скиллы в монорепозиториях, глобальные vs проектные настройки, почему важен harness) и большая подборка видео и подкастов — от «Building Claude Code» с Борисом Черным до воркфлоу Андрея Карпатого.
Как пользоваться
Автор советует читать репозиторий как курс, а не как набор команд: изучить примитивы, запустить демо /weather-orchestrator (полный цикл команда → агент → скилл), а затем указать Claude на раздел советов в своём проекте и попросить предложить правки — например, как реструктурировать CLAUDE.md.