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

run-plan — команда для Claude Code: что делает и как установить

Команда run-plan выполняет файл PLAN.md напрямую без загрузки контекста планировщика. Экономит контекстное окно, распределяя задачи на субагентов.

MIT ★ 1 988 обновлён 2026-04-01

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources
Открыть на GitHub

Что делает run-plan

Команда считывает файл плана и выбирает стратегию исполнения по тегам чекпоинтов. Если точек останова нет, запускается отдельный субагент, который закрывает задачи, создаёт SUMMARY.md и делает коммит вида feat({phase}-{plan}): [summary].

Когда в плане есть проверки checkpoint:human-verify, процесс делится на сегменты с паузой на подтверждение человеком. Под служебный контекст отводится до 30% окна (5–7k токенов на правила запуска и 10–15k на домен), оставляя 70%+ под код. Без существующего PLAN.md по переданному пути команда прервёт работу с ошибкой.

Какие задачи решает

  • запустить готовый план разработки без загрузки навыка планирования
  • изолировать выполнение задач в отдельном субагенте
  • автоматически сформировать отчёт в SUMMARY.md и сделать git-коммит
  • приостанавливать исполнение на точках проверки для ревью человеком

Примеры запросов агенту

  • /run-plan .planning/phases/07-sidebar/07-01-PLAN.md
  • /run-plan plans/auth-migration-PLAN.md

Как установить run-plan

1Через маркетплейс плагинов

/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources

2Вручную: положить файлы

.claude/commands/run-plan.md

Вызов — /run-plan. Для всех проектов — ~/.claude/commands/

Вопросы о run-plan

Как установить run-plan в Claude Code?

Сначала добавьте каталог командой /plugin marketplace add glittercowboy/taches-cc-resources, затем установите плагин через /plugin install taches-cc-resources@taches-cc-resources. Также файл можно поместить в .claude/commands/run-plan.md.

Что делает команда run-plan?

Она разбирает структуру PLAN.md, проверяет контрольные точки и исполняет задачи автономно через субагента либо пошагово с ручным подтверждением.

Что произойдёт, если план уже был запущен ранее?

Команда проверит наличие файла SUMMARY.md в той же директории. Если отчёт уже создан, Claude Code предупредит об этом и спросит, требуется ли повторный запуск.

Исходный текст

run-plan.md · MIT
---
type: prompt
description: Execute a PLAN.md file directly without loading planning skill context
arguments:
  - name: plan_path
    description: Path to PLAN.md file (e.g., .planning/phases/07-sidebar-reorganization/07-01-PLAN.md)
    required: true
---

Execute the plan at {{plan_path}} using **intelligent segmentation** for optimal quality.

**Process:**

1. **Verify plan exists and is unexecuted:**
   - Read {{plan_path}}
   - Check if corresponding SUMMARY.md exists in same directory
   - If SUMMARY exists: inform user plan already executed, ask if they want to re-run
   - If plan doesn't exist: error and exit

2. **Parse plan and determine execution strategy:**
   - Extract `<objective>`, `<execution_context>`, `<context>`, `<tasks>`, `<verification>`, `<success_criteria>` sections
   - Analyze checkpoint structure: `grep "type=\"checkpoint" {{plan_path}}`
   - Determine routing strategy:

   **Strategy A: Fully Autonomous (no checkpoints)**
   - Spawn single subagent to execute entire plan
   - Subagent reads plan, executes all tasks, creates SUMMARY, commits
   - Main context: Orchestration only (~5% usage)
   - Go to step 3A

   **Strategy B: Segmented Execution (has verify-only checkpoints)**
   - Parse into segments separated by checkpoints
   - Check if checkpoints are verify-only (checkpoint:human-verify)
   - If all checkpoints are verify-only: segment execution enabled
   - Go to step 3B

   **Strategy C: Decision-Dependent (has decision/action checkpoints)**
   - Has checkpoint:decision or checkpoint:human-action checkpoints
   - Following tasks depend on checkpoint outcomes
   - Must execute sequentially in main context
   - Go to step 3C

3. **Execute based on strategy:**

   **3A: Fully Autonomous Execution**
   ```
   Spawn Task tool (subagent_type="general-purpose"):

   Prompt: "Execute plan at {{plan_path}}

   This is a fully autonomous plan (no checkpoints).

   - Read the plan for full objective, context, and tasks
   - Execute ALL tasks sequentially
   - Follow all deviation rules and authentication gate protocols
   - Create SUMMARY.md in same directory as PLAN.md
   - Update ROADMAP.md plan count
   - Commit with format: feat({phase}-{plan}): [summary]
   - Report: tasks completed, files modified, commit hash"

   Wait for completion → Done
   ```

   **3B: Segmented Execution (verify-only checkpoints)**
   ```
   For each segment (autonomous block between checkpoints):

     IF segment is autonomous:
       Spawn subagent:
         "Execute tasks [X-Y] from {{plan_path}}
          Read plan for context and deviation rules.
          DO NOT create SUMMARY or commit.
          Report: tasks done, files modified, deviations"

       Wait for subagent completion
       Capture results

     ELSE IF task is checkpoint:
       Execute in main context:
         - Load checkpoint task details
         - Present checkpoint to user (action/verify/decision)
         - Wait for user response
         - Continue to next segment

   After all segments complete:
     - Aggregate results from all segments
     - Create SUMMARY.md with aggregated data
     - Update ROADMAP.md
     - Commit all changes
     - Done
   ```

   **3C: Decision-Dependent Execution**
   ```
   Execute in main context:

   Read execution context from plan <execution_context> section
   Read domain context from plan <context> section

   For each task in <tasks>:
     IF type="auto": execute in main, track deviations
     IF type="checkpoint:*": execute in main, wait for user

   After all tasks:
     - Create SUMMARY.md
     - Update ROADMAP.md
     - Commit
     - Done
   ```

4. **Summary and completion:**
   - Verify SUMMARY.md created
   - Verify commit successful
   - Present completion message with next steps

**Critical Rules:**

- **Read execution_context first:** Always load files from `<execution_context>` section before executing
- **Minimal context loading:** Only read files explicitly mentioned in `<execution_context>` and `<context>` sections
- **No skill invocation:** Execute directly using native tools - don't invoke create-plans skill
- **All deviations tracked:** Apply deviation rules from execute-phase.md, document everything in Summary
- **Checkpoints are blocking:** Never skip user interaction for checkpoint tasks
- **Verification is mandatory:** Don't mark complete without running verification checks
- **Follow execute-phase.md protocol:** Loaded context contains all execution instructions

**Context Efficiency Target:**
- Execution context: ~5-7k tokens (execute-phase.md, summary.md, checkpoints.md if needed)
- Domain context: ~10-15k tokens (BRIEF, ROADMAP, codebase files)
- Total overhead: <30% context, reserving 70%+ for workspace and implementation

© Lex Christopherson · MIT · glittercowboy/taches-cc-resources

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

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
subagent-plan-dev sentimony Скилл subagent-plan-dev управляет выполнением готового плана разработки через связку субагентов. Помогает распределять задачи, независимо проверять код и возобновлять упавшие сессии. CX Codex +1 2 200установок run-survey gtmagents Команда run-survey запускает клиентские опросы с расчётом выборки, набором вопросов и шагами автоматизации. Пригодится продуктовым командам и исследователям. CX Codex +1 ★ 450звёзд репо plan-execution gojko Команда plan-execution для Claude Code составляет план реализации изменений и файл .plan.json, по которым агент /execute запускает воркфлоу. CX Codex +1 ★ 112звёзд репо workflow-run ruvnet Скилл workflow-run управляет выполнением сценариев через инструменты MCP или нативные скрипты оркестрации. Пригодится при координации нескольких субагентов и контроле шагов. CX Codex +1 744установок exec-plan pproenca Скилл exec-plan организует жизненный цикл автономных планов разработки в Markdown для задач длиннее одной сессии или с правками более трёх файлов. CX Codex +1 239установок plan CloudAI-X Создаёт и ведёт файл PLAN.md в корне проекта для фиксации этапов разработки, зависимостей между задачами и лога прогресса. CX Codex +1 ★ 1 424звёзд репо

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

Весь набор →
heal-skill Команда heal-skill для обновления документации скилла на основе ошибок, обнаруженных при выполнении. Предлагает правки, ждёт одобрения, затем применяет изменения с возможностью коммита. CX Codex +1 ★ 1 988звёзд репо whats-next Команда whats-next анализирует текущий диалог и сохраняет подробный отчёт для передачи контекста новому агенту или сессии. CX Codex +1 ★ 1 988звёзд репо the-pirate-bay Ищет торренты через JSON API The Pirate Bay и возвращает magnet-ссылки. Находит раздачи и сравнивает результаты по числу сидов. CX Codex +1 ★ 1 988звёзд репо setup-ralph Скилл setup-ralph разворачивает автономную петлю Ralph Wiggum в любом каталоге: раскладку файлов, промпты планирования и сборки, проверки, которые отбраковывают слабый результат. CX Codex +1 ★ 1 988звёзд репо build-macos-apps Скилл build-macos-apps для Claude Code помогает создавать и развивать нативные macOS-приложения на SwiftUI и AppKit. Он подключается к задачам сборки, отладки, тестирования, оптимизации и выпуска. CX Codex +1 ★ 1 988звёзд репо options Команда options для структурированного сравнения вариантов решения: инструментов, подходов, архитектур. Задаёт уточняющие вопросы, строит матрицу оценок и даёт рекомендацию с обоснованием. CX Codex +1 ★ 1 988звёзд репо competitive Команда competitive исследует конкурентов для продукта или фичи, находит пробелы на рынке и сохраняет отчёт в файл. CX Codex +1 ★ 1 988звёзд репо deep-dive Слэш-команда deep-dive разбирает тему по нескольким углам: механика, история, практика, ограничения. Готовый отчёт с источниками сохраняет в artifacts/research/. CX Codex +1 ★ 1 988звёзд репо

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

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