decompose-plan

Parse H2 Task headers into Claude Code Task tool tasks with linear dependencies.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/WesleyMFrederick/cc-workflows-plugin --skill decompose-plan-wesleymfrederick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decompose-plan
Source: https://github.com/WesleyMFrederick/cc-workflows-plugin/tree/main/src-claude/skills/decompose-plan
Command: npx skills add https://github.com/WesleyMFrederick/cc-workflows-plugin --skill decompose-plan-wesleymfrederick

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Decompose large implementation plans into a precise set of Claude Code Task tool tasks, ensuring each H2 plan header becomes a distinct Task while preserving the plan as the source of truth.

Core Features & Use Cases

  • One Task per Plan Header: Converts each Task N header into a separate Claude Code Task with clear scope.
  • Plan as Source of Truth: Tasks reference the original plan (via jact) rather than copying content.
  • Dependency Chaining: Enforces a linear or plan-specified dependency chain so tasks execute in the intended order.
  • Use Case: At plan execution start, decompose a multi-step plan into execution-ready tasks to support automation and traceability.

Quick Start

Provide the path to your implementation plan, and the skill will decompose it into one task per Task header.

Frequently Asked Questions about decompose-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decompose an implementation plan into Claude Code tasks?

Decomposing an implementation plan into Claude Code tasks requires parsing H2 Task headers within the plan file. The skill converts each Task N header into a distinct task while preserving the original plan content as the source of truth.

What is the required markdown structure for decomposing a plan into tasks?

The required markdown structure uses H2 headers formatted as Task N with H3 Step sub-headers. The skill parses these specific headers to generate one execution-ready Claude Code task per plan task.

How does dependency chaining work when creating tasks from a plan?

Dependency chaining enforces a linear sequence where Task N blocks Task N+1 during execution. This ensures tasks execute in the intended order specified by the decomposed plan headers.

Do I need jact to extract headers before creating Claude Code tasks?

Yes, you need jact to extract headers and TaskCreate tooling to create tasks. The skill requires jact to parse the plan headers and generate the corresponding Claude Code tasks.

Can I reference the original plan content instead of copying it into each task?

Yes, tasks reference the original plan via jact rather than copying content. The plan remains the source of truth, ensuring traceability and preventing content duplication across generated tasks.

When should I use plan decomposition for Claude Code tasks?

Use plan decomposition at execution start when you have a multi-step plan with Task N headers. It supports automation and traceability by converting structured plans into execution-ready tasks.