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

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

Скилл exec-plan организует жизненный цикл автономных планов разработки в Markdown для задач длиннее одной сессии или с правками более трёх файлов.

MIT 239 установок ★ 227 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pproenca/dot-skills --skill exec-plan -a claude-code
Открыть на GitHub

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

Скилл управляет структурированными планами реализации в каталоге docs/exec-plans/. Вместо простого списка задач агент создаёт развёрнутый документ по шаблону из docs/PLANS.md. В него входят цели для пользователя, абсолютные пути к файлам и команды проверки с ожидаемым результатом.

Работа делится на три режима. Сначала агент создаёт черновик в docs/exec-plans/active/. Затем он выполняет шаги и отмечает каждый этап отметкой времени. Без обновления файла плана со свежими таймстемпами следующий агент неизбежно начнёт переделывать ту же работу с нуля. После закрытия всех вех скилл перемещает файл в completed/ через git mv.

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

  • сохранить контекст задачи между сессиями ИИ-агента
  • разбить крупный рефакторинг на проверяемые этапы
  • зафиксировать команды проверки и ожидаемый вывод
  • задокументировать промежуточные решения и изменения архитектуры

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

  • Создай план для рефакторинга хранилища данных
  • Продолжи выполнение активного плана
  • Заверши текущий план и подведи итоги

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

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill exec-plan -a claude-code

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

~/.claude/skills/exec-plan/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/exec-plan/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об exec-plan

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

Выполните команду npx skills add pproenca/dot-skills --skill exec-plan -a claude-code. Также можно вручную сохранить файл скилла по пути ~/.claude/skills/exec-plan/SKILL.md.

Для каких задач нужен скилл exec-plan?

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

Что происходит с планом после завершения всех шагов?

Агент заполняет ретроспективу с выводами и перемещает файл из папки active/ в completed/ с помощью git mv.

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

SKILL.md · MIT
---
name: exec-plan
description: |
  Manage the lifecycle of ExecPlans — self-contained, living specifications for multi-step work.
  Creates plans in the correct format, enforces living section updates, and handles the
  active → completed transition. Use for any work expected to take more than one session or
  touching more than 3 files.
  Triggers: "create a plan", "write a plan", "start plan", "continue plan", "resume plan",
  "finish plan", "complete plan", multi-step features, refactors, or tasks spanning sessions.
allowed-tools: Read, Glob, Grep, Write, Edit, Bash
---

# ExecPlan — Lifecycle Management

**Announce at start:** "Using the exec-plan skill."

## What is an ExecPlan

A self-contained, living document that a fresh agent session can follow to deliver observable, working behavior. Lives in `docs/exec-plans/`. The format follows the specification in `docs/PLANS.md`.

An ExecPlan is NOT a todo list. It is a narrative that tells the story of a change: why it matters, what the codebase looks like now, what it should look like after, and how to prove it worked.

## When to use this skill

- **Required** for multi-step or multi-file work, new features, refactors, or tasks expected to take more than about an hour.
- **Optional** for trivial fixes, but if you skip it for a substantial task, state the reason.
- **Always** when resuming work from a previous session.

## The Three Modes

### Mode 1: CREATE a new plan

When starting new multi-step work:

1. Read `docs/PLANS.md` for the template and requirements.
2. Create the plan at `docs/exec-plans/active/{descriptive-kebab-name}.md`.
3. Fill ALL sections from the template. Non-negotiable sections:
   - **Purpose / Big Picture** — what the user can see/do after the change
   - **Progress** — empty checkboxes for each milestone
   - **Surprises & Discoveries** — start with `(none yet)`
   - **Decision Log** — start with `(none yet)`
   - **Outcomes & Retrospective** — start with `(fill when complete)`
   - **Context and Orientation** — full file paths, term definitions, current state
   - **Plan of Work** — narrative milestones with goal → work → result → proof
   - **Concrete Steps** — exact commands with expected outputs
   - **Validation and Acceptance** — observable proof of success
   - **Idempotence and Recovery** — how to retry or roll back
4. Every file path must be absolute from repo root.
5. Every term must be defined inline — assume the reader knows nothing.
6. Commit the plan before starting implementation.

### Mode 2: CONTINUE an existing plan

When resuming work or executing the next milestone:

1. Read the plan file in `docs/exec-plans/active/`.
2. Find the first unchecked item in Progress.
3. Before starting work, check: are there any Surprises from previous sessions that affect this task?
4. Execute the milestone following the Plan of Work.
5. **After each completed milestone, IMMEDIATELY update the plan:**
   - Check the Progress item with a timestamp: `- [x] (YYYY-MM-DD HH:MMZ) Description`
   - Add any Surprises & Discoveries encountered
   - Add any Decision Log entries for choices made
6. Commit the plan update alongside the code changes.
7. Run the Validation commands to confirm success.

**CRITICAL: Never claim a milestone is done without updating the plan file.** The plan IS the persistence mechanism. If you don't update it, the next session will redo the work.

### Mode 3: COMPLETE a plan

When all milestones are done:

1. Fill the **Outcomes & Retrospective** section:
   - What was achieved vs what was planned
   - Any remaining gaps
   - Lessons learned
   - Unexpected benefits or costs
2. Move the file: `git mv docs/exec-plans/active/{name}.md docs/exec-plans/completed/{name}.md`
3. Commit with message: `docs: complete exec-plan {name}`

## Quality Checks

Before committing any plan (new or updated), verify:

- [ ] Purpose describes user-visible behavior, not just code changes
- [ ] Progress has timestamps on completed items
- [ ] Context names files by full path from repo root
- [ ] All terms are defined inline (no "see external doc" for critical terms)
- [ ] Validation has exact commands AND expected outputs
- [ ] Recovery section explains rollback for each risky step
- [ ] Surprises section is up to date (even if empty)
- [ ] Decision Log captures any choices made during implementation

## Anti-patterns

- **Checklist without narrative**: "- [ ] Edit file X" tells the next session nothing. WHY edit it? WHAT changes? HOW to verify?
- **External references for critical context**: "See ARCHITECTURE.md for details" — the plan must be self-contained. Copy the relevant context in.
- **Forgetting to update Progress**: The most common failure. If you finish a milestone and don't check the box with a timestamp, the next session will redo it.
- **Leaving completed plans in active/**: After all milestones are done, MOVE to completed/. Active plans should only be unfinished work.
- **Skipping Validation**: "Tests pass" is not acceptance. "The `isValid` computed property no longer exists in the file, verified by `grep -n isValid file.swift` returning no results" IS acceptance.

## Integration with other skills

- Before implementing plan milestones that involve TCA code: invoke `/pfw-composable-architecture`
- Before implementing plan milestones that involve debugging: invoke the `debug` skill
- Before implementing plan milestones that involve refactoring: invoke the `refactor` skill
- Before implementing plan milestones that involve API design: invoke the `rest-api-design` skill
- After completing all plan milestones: invoke `refactor` skill for a final cleanup pass

© pproenca · MIT · pproenca/dot-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
make-issue-spec pchalasani Скилл make-issue-spec создаёт файл задачи с планом реализации в папке issues/ с текущей датой. Задаёт уточняющие вопросы и добавляет документ в индекс Git. CX Codex +1 ★ 2 039звёзд репо plan CloudAI-X Создаёт и ведёт файл PLAN.md в корне проекта для фиксации этапов разработки, зависимостей между задачами и лога прогресса. CX Codex +1 ★ 1 424звёзд репо plan-task NeoLabHQ Скилл plan-task дорабатывает черновик спецификации задачи: добавляет критерии приёмки, архитектуру и фазы с проверкой качества на каждом шаге. CX Codex +1 1 300установок tasks-plan makenotion Скилл tasks-plan берёт задачу или спецификацию из Notion и превращает её в план реализации: фазы, конкретные шаги, зависимости и риски. Готовый план складывается обратно в Notion новой страницей. CX Codex +1 ★ 40звёзд репо dex-plan dcramer Скилл dex-plan превращает markdown-файлы планов, спецификаций и архитектурных документов в структурированные задачи трекера dex с автоматической декомпозицией. CX Codex +1 781установок update-implementation-plan официальный github Скилл update-implementation-plan для GitHub Copilot обновляет план реализации под новые требования, рефакторинг, обновление пакетов и изменения архитектуры. Превращает план в исполнимый список задач. CX Codex +1 11 107установок

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

Весь набор →
domain-architect Скилл domain-architect определяет бизнес-домены в Swift-проекте через возможности продукта, а не через имена папок. Строит карту слоёв каждого домена — от типов до UI. CX Codex +1 249установок app-planner Скилл app-planner составляет дизайн-план приложения в Markdown по паттернам Apple Design DNA перед разработкой. Делит проект на майлстоуны для сессий сборки. CX Codex +1 244установок threat-model Скилл threat-model строит модель угроз кодовой базы, отслеживая путь недоверенных данных до приёмников и собирая отдельные уязвимости в цепочки атак. CX Codex +1 243установок opencode-ts Скилл opencode-ts помогает писать, проверять и рефакторить TypeScript-код в проектах на Effect. Он задаёт рабочий процесс и сверяет изменения с архитектурой проекта. CX Codex +1 240установок graph-schema Скилл graph-schema для Claude Code помогает проектировать, проверять и перерабатывать схемы графовых баз данных. Он включается при моделировании узлов и связей или переносе предметной области в граф. CX Codex +1 239установок clean-code-ts-react Скилл clean-code-ts-react переносит принципы Clean Code Роберта Мартина на TypeScript 5.x и React 19. Помогает на код-ревью, при рефакторинге и проектировании компонентов или функций. CX Codex +1 238установок cli-for-agents Скилл cli-for-agents для Claude Code помогает проектировать и проверять CLI, которым пользуются ИИ-агенты и автоматизация. Он включается при работе с подкомандами, флагами, справкой и сообщениями об ошибках. CX Codex +1 237установок eval-mcp Скилл eval-mcp проверяет схемы MCP-сервера и точность выбора инструментов моделью. Находит пересечения в описаниях и тестирует вызовы на синтетических запросах. CX Codex +1 234установок

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

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