К основному содержанию
команда CX Codex

dev-docs — команда для Claude Code: стратегическое планирование проекта

Команда dev-docs генерирует детальный план реализации для любой задачи: анализирует кодовую базу, разбивает работу на фазы и создаёт трёхфайловую структуру с чек-листами и зависимостями между задачами.

MIT ★ 10 055 обновлён 2026-07-13

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/dev-docs.md
Открыть на GitHub

Что делает 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/

Вопросы о 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

Похожие слэш-команды

Все слэш-команды по теме «Код-ревью и рефакторинг» →
gsd-ingest-docs open-gsd Скилл gsd-ingest-docs для Claude Code собирает или объединяет структуру planning из существующих документов репозитория в один проход. CX Codex +1 574установок flow-next-strategy Gordon Mickel Скилл flow-next-strategy создаёт и обновляет STRATEGY.md в корне репозитория: целевая проблема, подход, аудитория, метрики и треки работы. CX Codex +1 ★ 730звёзд репо grill-with-docs akillness Скилл grill-with-docs для Claude Code проводит разбор плана или дизайна и создаёт ADR с записями глоссария. Запускается фразами про разбор и документирование. CX Codex +1 366установок notion-spec-to-implementation makenotion Скилл notion-spec-to-implementation для Claude Code превращает спецификацию Notion в план работ и задачи. Он сверяет реализацию с требованиями и фиксирует прогресс. CX Codex +1 389установок exec-plan pproenca Скилл exec-plan организует жизненный цикл автономных планов разработки в Markdown для задач длиннее одной сессии или с правками более трёх файлов. CX Codex +1 239установок project-planner samhvw8 Скилл project-planner для Claude Code составляет планы бизнес-, личных, творческих, учебных и организационных проектов. В планах фиксирует цели, этапы, сроки и риски. CX Codex +1 183установок

Из того же набора16

Весь набор →
route-research-for-testing Команда route-research-for-testing собирает список изменённых маршрутов в текущей сессии и запускает их тестирование через cURL. Помогает убедиться, что отредактированные API-эндпоинты работают правильно. CX Codex +1 ★ 10 055звёзд репо verify-setup Команда verify-setup для Claude Code проверяет инфраструктуру проекта, находит ошибки в хуках, зависимостях и конфигах и подсказывает, как их исправить. CX Codex +1 ★ 10 055звёзд репо source-command-verify-setup Скилл source-command-verify-setup запускает диагностический скрипт инфраструктуры и устраняет ошибки в хуках и конфигурациях. CX Codex +1 ★ 10 055звёзд репо dev-docs-update Команда dev-docs-update сохраняет состояние разработки перед сбросом контекста: обновляет документацию задач, память и заметки для передачи работы. CX Codex +1 ★ 10 055звёзд репо auto-error-resolver auto-error-resolver — субагент Claude Code, который устраняет ошибки компиляции TypeScript по отчётам проверочного хука и перепроверяет сборку через tsc. CX Codex ★ 10 055звёзд репо frontend-error-fixer Субагент frontend-error-fixer разбирает ошибки фронтенда на этапе сборки и в браузере. Подходит для TypeScript, React, сетевых сбоев и проблем отображения. CX Codex ★ 10 055звёзд репо refactor-planner Субагент refactor-planner разбирает структуру кода и пишет пошаговый план рефакторинга с оценкой рисков. Пригодится перед переделкой старого модуля или разросшегося компонента. CX Codex ★ 10 055звёзд репо plan-reviewer Субагент plan-reviewer анализирует планы доработки архитектуры, миграций баз данных и интеграций до написания кода. Помогает найти скрытые риски и пропущенные шаги. CX Codex ★ 10 055звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой