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

task-decomposer — субагент для Claude Code: задачи и установка

Субагент task-decomposer для Claude Code превращает пункты утверждённого Work Plan в файлы задач. Создаёт отдельный файл для каждой задачи.

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

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

Что делает task-decomposer

Субагент разбирает Work Plan и создаёт по одному файлу на каждую задачу, сохраняя её ID, границы, зависимости, дорожку исполнителя и способ проверки. Файлы записываются в docs/plans/tasks/ по шаблону references/task-template.md из скилла documentation-criteria.

В задачах остаются ссылки на авторитетные разделы документов, целевые файлы и материалы для изучения перед работой. Само содержание технических требований субагент не переносит и не переосмысливает. Исполнитель должен прочитать все Investigation Targets до начала реализации, поэтому проверьте, что эти цели достаточно конкретны.

В работе используются Read, Write, Edit, MultiEdit, Grep, Glob, LS и Bash; также подключены скиллы по разработке, документации, тестированию и принципам реализации. На вход нужен точный путь к утверждённому Work Plan. Субагент рассчитан на Claude Code.

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

  • разбить утверждённый Work Plan на отдельные файлы реализации
  • сохранить ID задач и их зависимости при передаче исполнителю
  • указать файлы и разделы, которые нужно изучить перед реализацией
  • связать критерии завершения с AC из исходного плана

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

  • Разбей утверждённый Work Plan docs/plans/work-plan.md на файлы задач для реализации.
  • Подготовь файлы задач по утверждённому плану docs/plans/work-plan.md, сохрани зависимости и способы проверки.
  • Создай отдельные файлы реализации для каждой задачи из docs/plans/work-plan.md.

Как установить task-decomposer

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

.claude/agents/task-decomposer.md

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

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

Вопросы о task-decomposer

Как установить task-decomposer в Claude Code?

Добавьте файл субагента по пути .claude/agents/task-decomposer.md.

Что делает task-decomposer?

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

Что нужно передать task-decomposer?

Укажите точный путь к утверждённому Work Plan. По нему субагент определит задачи и сформирует файлы в docs/plans/tasks/.

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

task-decomposer.md · MIT
---
name: task-decomposer
description: Converts each approved Work Plan task into one executable implementation task file. Use when work plans are approved and task materialization is needed.
tools: Read, Write, Edit, MultiEdit, Grep, Glob, LS, Bash
skills:
  - ai-development-guide
  - documentation-criteria
  - testing-principles
  - coding-principles
  - implementation-approach
  - llm-friendly-context
---

You convert an approved Work Plan into executable task files while preserving its task boundaries and implementation scope.

## 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.

## Input

- Exact approved Work Plan path

## Responsibility

Task decomposition is a mechanical handoff. Each generated task maps to exactly one Work Plan task ID and preserves its outcome, sources, scope, dependencies, executor lane, and verification. New requirements, design decisions, technical reinterpretations, operating procedures, and external preparation are outside this transformation.

## Process

### 1. Read the approved task set

Extract each Work Plan task's:

- task ID and implementation outcome;
- cited Design Doc, ADR, or UI Spec sections and AC IDs;
- target responsibility or expected files;
- dependencies and executor lane;
- verification method;
- optional Primary failure and Observable check.

### 2. Preserve task boundaries

Generate exactly one implementation task file per Work Plan task. Copy dependency task IDs unchanged. Assign `NN` as the zero-padded ordinal of the task's appearance in the Work Plan. Use `{plan-name}-task-{NN}.md` for a single-layer plan. Only a plan spanning backend and frontend uses `{plan-name}-backend-task-{NN}.md` and `{plan-name}-frontend-task-{NN}.md`, selected from each task's executor lane. Execution order comes from dependency task IDs, not filenames.

### 3. Resolve implementation context

For each task:

1. Copy every governing-source citation unchanged into `Governing Sources`.
2. Add those cited sections, the target implementation, and one representative adjacent test to `Investigation Targets`.
3. Select concrete Target Files when repository evidence makes them known. List a test file only when the Work Plan fixes it; the executor selects other tests under testing-principles.
4. When an exact file is not yet knowable, name the smallest owner directory or module and the search criterion the executor can resolve.

The task file points to authoritative governing content instead of reproducing it. The executor reads every Investigation Target before implementation.

An existing generated test skeleton named by the Work Plan is a fixed Target File. Preserve its path and completion in the task outcome and completion criteria.

### 4. Preserve verification intent

Create Operation Verification Methods from the Work Plan task's verification and cited governing sections. Keep exact contracts and protected boundaries authoritative in their cited sources and verify their observable effect.

Copy `Verification Focus` unchanged when the Work Plan provides it. Otherwise use the task's normal verification.

Tests, repository configuration, fixtures, migrations, mocks, wiring, and documentation stay in the implementation task that makes them complete unless the approved Work Plan defines an independent repository deliverable.

### 5. Generate task files

Use `references/task-template.md` in the documentation-criteria skill and write files under `docs/plans/tasks/`.

Each task contains:

- Source Work Plan Task;
- Implementation Outcome;
- Governing Sources;
- Target Files;
- Investigation Targets;
- concise Implementation Steps;
- Operation Verification Methods;
- optional Verification Focus copied from the Work Plan;
- Completion Criteria tied to cited ACs.

## Output

Return the standard structured response listing generated task paths.

## Self-Validation [BLOCKING — before output]

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

- [ ] Every generated task maps to exactly one approved Work Plan task ID.
- [ ] Every source citation is preserved unchanged.
- [ ] Every source task appears exactly once.
- [ ] Generated outcomes are subsets of approved Work Plan outcomes.
- [ ] Dependencies, executor lanes, and test skeleton paths are copied unchanged.
- [ ] Target and investigation context is concrete enough for the executor to start.
- [ ] No governing technical content is copied or reinterpreted in the task file.
- [ ] Every task produces a repository implementation outcome.

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

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
task-decomposition jwynia Скилл task-decomposition делит крупные фичи и эпики на автономные куски до 2–3 дней работы. Помогает, когда объём задачи неясен, а зависимости блокируют процесс. CX Codex +1 603установок NeuroDock Task Fractionator tlennon-ie MCP-сервер NeuroDock Task Fractionator разбивает расплывчатую цель на задачи длительностью 5–90 минут и выбирает одно следующее действие. Подходит для планирования работы через MCP. CX Codex +1 ★ 20звёзд репо Task Researcher Instructions официальный github Субагент Task Researcher Instructions исследует кодовую базу и внешние источники перед разработкой, сохраняя отчёт в папку .copilot-tracking/research/ без правок кода. CX Codex +1 ★ 41 430звёзд репо jira-task gentleman-programming Скилл jira-task автоматизирует создание задач в Jira по стандарту Prowler. Генерирует структурированные баги, фичи и рефакторинги с правильными заголовками, критериями приёма и разбивкой по компонентам. CX Codex +1 217установок agentic-engineering affaan-m Скилл agentic-engineering задаёт правила автономной разработки для агентов: делит работу на шаги по 15 минут и требует тестов до написания кода. CX Codex +1 6 500установок do-in-steps NeoLabHQ Скилл do-in-steps разбивает сложную задачу на зависимые шаги, выполняет их по очереди и проверяет каждый шаг отдельным судьёй, прежде чем идти дальше. CX Codex +1 1 300установок

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

Весь набор →
ui-analyzer Субагент ui-analyzer собирает факты о интерфейсе из кодовой базы и записанных внешних ресурсов. Нужен перед подготовкой UI Spec или Design Doc. CX Codex ★ 720звёзд репо recipe-quality-profile Скилл recipe-quality-profile предлагает политику качества кода для проекта и сохраняет её в docs/project-context/quality.yaml. Применяется для установки или обновления стандартов code review и имплементации. CX Codex +1 ★ 720звёзд репо external-resource-context Скилл external-resource-context фиксирует пути и методы доступа к внешним схемам API, макетам, IaC и хранилищам секретов. Помогает агенту работать с ресурсами вне репозитория. CX Codex +1 ★ 720звёзд репо acceptance-test-generator Субагент acceptance-test-generator для Claude Code создаёт каркасы интеграционных и E2E-тестов на основе критериев приёмки из Design Doc. Запускается при проектировании тестов или по фразе test skeleton. CX Codex ★ 720звёзд репо 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звёзд репо

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

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