dev-docs — команда для Claude Code: стратегическое планирование проекта
Команда dev-docs генерирует детальный план реализации для любой задачи: анализирует кодовую базу, разбивает работу на фазы и создаёт трёхфайловую структуру с чек-листами и зависимостями между задачами.
MIT ★ 10 055 обновлён 2026-07-13
.claude/commands/dev-docs.mdЧто делает dev-docs
dev-docs принимает описание того, что нужно спланировать («рефакторинг аутентификации», «миграция на микросервисы»), изучает релевантные файлы проекта и строит стратегический документ: резюме, анализ текущего состояния, предложенное будущее, фазы реализации, список задач с критериями приёма и оценками сложности.
Команда создаёт три файла в папке dev/active/[task-name]/: план (*-plan.md) с полным контекстом, справочник зависимостей и архитектуры (*-context.md), и чек-лист для отслеживания (*-tasks.md). Каждый файл содержит дату последнего обновления, что помогает отличить свежие решения от устаревших при переходе между контекстами.
Структура задач предусматривает оценки трудозатрат (S/M/L/XL), приоритизацию, анализ рисков и метрики успеха. Команда ищет в проекте PROJECT_KNOWLEDGE.md, BEST_PRACTICES.md, TROUBLESHOOTING.md и dev/README.md, чтобы встроить локальные стандарты и ограничения — без них план может не соответствовать реальным условиям разработки.
Какие задачи решает
- Разбить большую задачу на управляемые фазы с зависимостями
- Составить чек-лист задач, которые выживают при смене контекста
- Проанализировать текущую архитектуру перед крупным изменением
- Оценить сложность и риски реализации стратегического плана
- Зафиксировать решения и причины, чтобы не терять их между контекстами
Примеры запросов агенту
- dev-docs рефакторинг системы аутентификации с OAuth2
- dev-docs миграция на микросервисы: разделить монолит на отдельные компоненты
- dev-docs внедрить кэширование Redis для критических данных
Как установить dev-docs
Вручную: положить файлы
.claude/commands/dev-docs.mdВызов — /dev-docs. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/dev-docs.mdВызов — /prompts:dev-docs. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/dev-docs.prompt.mdВручную: положить файлы
.gemini/commands/dev-docs.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о dev-docs
Как установить dev-docs в Claude Code?
Скопируй файл .claude/commands/dev-docs.md из репозитория в папку .claude/commands/ своего проекта. Для Codex это ~/.codex/prompts/dev-docs.md.
Что делает dev-docs?
Создаёт стратегический план для задачи: анализирует кодовую базу, разбивает работу на фазы с задачами, оценками сложности и зависимостями, затем сохраняет план в три файла (*-plan.md, *-context.md, *-tasks.md), которые сохраняются между контекстами.
Нужен ли мне файл PROJECT_KNOWLEDGE.md?
Нет, это опционально. Команда ищет его, если он есть, чтобы учесть архитектуру проекта; без него план строится на основе анализа текущего кода и твоего описания задачи.
Исходный текст
dev-docs.md · MIT
---
description: Create a comprehensive strategic plan with structured task breakdown
argument-hint: Describe what you need planned (e.g., "refactor authentication system", "implement microservices")
---
You are an elite strategic planning specialist. Create a comprehensive, actionable plan for: $ARGUMENTS
## Instructions
1. **Analyze the request** and determine the scope of planning needed
2. **Examine relevant files** in the codebase to understand current state
3. **Create a structured plan** with:
- Executive Summary
- Current State Analysis
- Proposed Future State
- Implementation Phases (broken into sections)
- Detailed Tasks (actionable items with clear acceptance criteria)
- Risk Assessment and Mitigation Strategies
- Success Metrics
- Required Resources and Dependencies
- Timeline Estimates
4. **Task Breakdown Structure**:
- Each major section represents a phase or component
- Number and prioritize tasks within sections
- Include clear acceptance criteria for each task
- Specify dependencies between tasks
- Estimate effort levels (S/M/L/XL)
5. **Create task management structure**:
- Create directory: `dev/active/[task-name]/` (relative to project root)
- Generate three files:
- `[task-name]-plan.md` - The comprehensive plan
- `[task-name]-context.md` - Key files, decisions, dependencies
- `[task-name]-tasks.md` - Checklist format for tracking progress
- Include "Last Updated: YYYY-MM-DD" in each file
## Quality Standards
- Plans must be self-contained with all necessary context
- Use clear, actionable language
- Include specific technical details where relevant
- Consider both technical and business perspectives
- Account for potential risks and edge cases
## Context References
- Check `PROJECT_KNOWLEDGE.md` for architecture overview (if exists)
- Consult `BEST_PRACTICES.md` for coding standards (if exists)
- Reference `TROUBLESHOOTING.md` for common issues to avoid (if exists)
- Use `dev/README.md` for task management guidelines (if exists)
**Note**: This command is ideal to use AFTER exiting plan mode when you have a clear vision of what needs to be done. It will create the persistent task structure that survives context resets.
© diet103 · MIT · diet103/claude-code-infrastructure-showcase