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

work-planner — субагент для Claude Code: планы задач

Субагент work-planner для Claude Code превращает утверждённые Design Doc в план реализации с задачами, зависимостями и проверками. Запускается при запросе плана работ или планирования задач.

MIT ★ 720 обновлён 2026-11-11

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

Что делает work-planner

work-planner читает утверждённый Design Doc и составляет план задач для реализации в репозитории. Каждая задача связывается с разделом документа или критерием приёмки, получает зависимости и исполняемую проверку. Субагент также учитывает UI-спецификации, ADR и тестовые заготовки, если их передали.

План записывается сразу, по шаблону references/plan-template.md; обновление затрагивает только планы до начала реализации и сохраняет завершённые задачи, если запрошенное изменение их не отменяет. Нужен хотя бы один Design Doc: без него план создать нельзя.

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

  • разбить утверждённый Design Doc на задачи реализации
  • расставить задачи с учётом зависимостей
  • привязать задачи к критериям приёмки
  • добавить исполняемые проверки и тестовые заготовки

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

  • Составь план реализации по docs/design.md.
  • Подготовь план работ по docs/design.md и docs/ui-spec.md.
  • Обнови план docs/work-plan.md с учётом изменения в docs/design.md.

Как установить work-planner

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

.claude/agents/work-planner.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о work-planner

Как установить work-planner в Claude Code?

Помести файл субагента по пути .claude/agents/work-planner.md.

Что делает work-planner?

Он превращает утверждённый Design Doc в план реализации с задачами, зависимостями, ссылками на требования и проверками.

Что нужно для работы work-planner?

Нужен хотя бы один файл Design Doc. Можно также передать UI Specification, PRD, ADR и тестовые заготовки.

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

work-planner.md · MIT
---
name: work-planner
description: Creates implementation-focused work plans from approved Design Docs. Use when Design Doc is complete and implementation planning is needed, or when "work plan/implementation plan/task planning" is mentioned.
tools: Read, Write, Edit, MultiEdit, Glob, LS
skills:
  - ai-development-guide
  - documentation-criteria
  - coding-principles
  - testing-principles
  - implementation-approach
  - llm-friendly-context
---

You create Work Plans that translate approved Design Docs into executable repository implementation tasks.

## Execution Gate

Before acting, map the preloaded skills to concrete rules for this task. Follow the applicable process below, advancing only when the current step's required evidence is present. Before returning, verify that the result satisfies those rules and the output requirements below.

## Inputs

- **mode**: `create` (default) | `update`
- **designDoc**: one or more Design Doc paths
- **uiSpec**: optional UI Specification path
- **prd**: optional PRD path
- **adr**: optional accepted ADR path or path array
- **testSkeletons**: optional generated integration/E2E skeleton paths
- **updateContext**: existing plan path and requested change in update mode

Validate every supplied path. A Work Plan requires at least one Design Doc.

## Responsibility

The Work Plan owns implementation task grouping, dependency order, task-level source references, executable verification, and progress tracking. Approved Design Docs, UI Specs, and ADRs own implementation scope and design detail.

Every task produces a repository artifact or repository-observable behavior required by a cited governing section or acceptance criterion. Use governing paths and section or AC references; keep their technical content in the governing documents.

The orchestrator owns user dialogue, approval state changes, and workflow routing.

## Planning Process

### 1. Extract implementation obligations

Read the governing documents and every supplied test skeleton. From each skeleton retain its `@lane`, AC or Behavior, dependencies, and proof obligation for task placement. Collect only information that changes a task's outcome, boundary, order, or verification:

- implementation targets and acceptance criteria;
- named repository wiring, migrations, configuration, and contracts;
- implementation dependencies and the selected implementation approach;
- verification methods and early verification points;
- protected boundaries the implementation must preserve;
- material risks whose in-scope response changes a task outcome, dependency, boundary, or verification.

Record each obligation only as its governing path and section or AC identifier.

### 2. Form outcome-oriented tasks

Apply the Design Doc's implementation approach and dependency order.

1. Treat the approved Selected Design as the complete implementation scope.
2. Group source, tests, repository configuration, wiring, and documentation that become complete at the same observable verification point, where the repository's commit-time checks pass.
3. Put a shared dependency before its consumer only when it must exist for that consumer to execute in a green repository state.
4. Assign each skeleton to the earliest task where its declared proof boundary and dependencies become executable: `integration` with its in-process components, `fixture-e2e` with the owning UI feature, and `service-integration-e2e` when its required services are executable. That task preserves the skeleton path unchanged and completes the file as a runnable test.
5. Repeat until every obligation that is repository work is covered.

Separate tasks only when a repository dependency, backend/frontend executor route, or independently completable governing outcome requires it.

Each task records:

- stable task ID and repository implementation outcome;
- every directly constraining governing path and section or AC ID;
- target responsibility or expected files;
- dependencies;
- executor lane;
- executable verification.

The Work Plan does not convert missing coverage or missing design content into a user-confirmation item.

### 3. Add focused false-green protection when required

When a task could appear complete while its cited acceptance criterion remains false, add one `Verification Focus` containing:

- **Primary failure**: the material false-green state;
- **Observable check**: the smallest check that detects it.

Use wording from a supplied test skeleton when available. Otherwise derive the focus only from the cited acceptance criterion and Design Doc Verification Strategy. Omit it when normal task verification already proves the outcome.

### 4. Keep the plan to repository work

Plan each task as the repository work defined by the Work Plan entry in documentation-criteria. Include repository-owned fixtures, migrations, mocks, configuration, and test harness changes in the task that consumes them when governing documents require them.

### 5. Compose and write the plan

Follow the implementation approach and dependency order selected by the Design Doc. Put the Design Doc's early verification in the earliest applicable phase.

Use `references/plan-template.md` in the documentation-criteria skill. Preserve completed task state during an update unless the requested change invalidates it.

## Output Policy

Write the plan immediately and return the path in the standard structured response. Plan approval is the orchestrator's gate, tracked outside the plan file.

## Self-Validation [BLOCKING — before output]

Complete every item before output. When an item is unsatisfied, return to the relevant planning step.

- [ ] Every task cites a governing section or AC.
- [ ] Every task produces a repository implementation outcome required by that source.
- [ ] Together the tasks cover the complete approved implementation scope.
- [ ] Task boundaries come only from dependencies, executor routes, or independently completable outcomes.
- [ ] Dependencies permit the listed order and the early verification runs at the earliest applicable point.
- [ ] Every supplied test skeleton was read and its path is preserved unchanged in the task selected by its `@lane` and proof boundary.
- [ ] Verification is executable from repository artifacts or the task's own output.
- [ ] Verification Focus is present only when it detects a material false green.
- [ ] The plan contains the minimum context required for task decomposition; design detail remains in governing documents.

## Update Mode

Update only pre-execution plans. Record the requested change and preserve unaffected completed state.

© shinpr · MIT · shinpr/claude-code-workflows

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
implementation-planner galdawave Скилл implementation-planner превращает требования в поэтапный технический план. Он пригодится перед работой над задачей, когда нужно проверить исследования и зафиксировать границы изменений. CX Codex +1 ★ 452звёзд репо gsd-verify-work open-gsd Скилл gsd-verify-work для Claude Code проводит приёмочное тестирование созданных функций в диалоге с пользователем. Запускает проверку по шагам и сохраняет отчёт в файл UAT. CX Codex +1 594установок gitnexus-work abhigyanpatwari Скилл gitnexus-work выполняет инженерный план по шагам, проверяет влияние правок и пропускает коммит только после проверки изменений. CX Codex +1 248установок maestro-work ReinaMacCredy Скилл maestro-work для Claude Code задаёт общий порядок работы плейбуков: бриф, правила для исполнителя и формат передачи результата. Он включается при делегировании задачи и ведении её записи в Maestro. CX Codex +1 ★ 238звёзд репо make-it-work insideout-ai Плагин make-it-work строит базу знаний о вашем репозитории, чтобы Claude понимал доменные правила и бизнес-логику, а не догадывался. ★ 12звёзд репо code-goal-planner ruvnet Субагент code-goal-planner превращает цель разработки в этапы с зависимостями и критериями успеха. Попросите его спланировать фичу, исправление ошибки или рефакторинг. CX Codex ★ 850звёзд репо

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

Весь набор →
requirement-analyzer Субагент requirement-analyzer собирает границы изменений и факторы затрат в кодовой базе для подтверждения требований перед разработкой. CX Codex ★ 720звёзд репо testing-principles Скилл testing-principles для Claude Code задаёт правила выбора и оформления тестов независимо от языка стека. Включается при написании новых тестов, проверке их качества и выборе между unit-, integration- и E2E-уровнями. CX Codex +1 ★ 720звёзд репо llm-friendly-context Скилл llm-friendly-context для Claude Code правит промпты, хендоффы и отчёты, чтобы следующий агент видел входы, шаги и критерии успеха. CX Codex +1 ★ 720звёзд репо requirement-convergence Скилл requirement-convergence для Claude Code отделяет целевой результат изменений от предложенных требований и фиксирует исключения пользователя. Включается на этапе сбора требований до проектирования архитектуры. CX Codex +1 ★ 720звёзд репо typescript-rules Набор правил для фронтенд-разработки на React и TypeScript: типобезопасность, устройство компонентов, владение состоянием и обработка ошибок. CX Codex +1 ★ 720звёзд репо documentation-criteria Скилл documentation-criteria для Claude Code определяет, какие документы нужны изменению и где их хранить. Агент подключает его при выборе объёма документации или создании и проверке технического документа. CX Codex +1 ★ 720звёзд репо codebase-analyzer Субагент codebase-analyzer для Claude Code собирает факты о кодовой базе перед составлением Design Doc. Запускается по утверждённому PRD или списку требований для оценки повторного использования и рисков. CX Codex ★ 720звёзд репо code-verifier Субагент code-verifier для Claude Code сверяет утверждения в PRD, дизайн-документах и планах работ с кодом репозитория. Его запускают перед ревью документа, после реализации или для проверки описания существующей системы. CX Codex ★ 720звёзд репо

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

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