Plan Decompose

Decompose a plan into a beads epic with lightweight skeleton subtasks. ALL tasks get minimal descriptions by default. Use /enrich to promote individual tasks to self-contained when ready to implement.

Output Templates

Success Output (default skeleton)

===============================================================
PLAN DECOMPOSED (skeleton)
===============================================================

EPIC_ID: <id>
EPIC_TITLE: <title>
TASKS: <count> (all lightweight)

STRUCTURE:
  <id.1>: <title> (ready)
  <id.2>: <title> (depends: .1)
  <id.3>: <title> (depends: .2)

DEPENDENCY GRAPH:
  .1 ──▶ .2 ──▶ .3

QUALITY:
  Avg description: ~N lines
  Ready: N tasks

Next: /enrich <first-ready-id>
===============================================================

Dry Run Output

===============================================================
PLAN DECOMPOSE — DRY RUN (skeleton, no beads created)
===============================================================

WOULD CREATE EPIC: <title>

WOULD CREATE SUBTASKS (all lightweight):
  1. <title> [P3] — <scope>
  2. <title> [P3] — <scope>

WOULD SET DEPENDENCIES:
  2 depends on 1

Run without --dry-run to create beads.
===============================================================

Error Output

❌ Plan decomposition failed: <reason>
   Fix: <actionable suggestion>

Usage

# From a plan file (default: all tasks lightweight skeleton)
/plan-decompose .claude/plans/my-feature.md

# Preview without creating beads
/plan-decompose .claude/plans/my-feature.md --dry-run

# Legacy: all tasks self-contained with TDD classification
/plan-decompose .claude/plans/my-feature.md --enrich-all

# Skip TDD classification (only relevant with --enrich-all)
/plan-decompose .claude/plans/my-feature.md --enrich-all --skip-tdd

# Opt-in: 3-level feature grouping
/plan-decompose .claude/plans/my-feature.md --with-features

# Opt-in: lifecycle beads
/plan-decompose .claude/plans/my-feature.md --with-release --with-pr

Workflow Pipeline

/plan-decompose is Step 3 in the confirmed workflow:

Plan (brainstorm) → OpenSpec → /audit spec → /plan-decompose → /enrich → /impl → archive

Step	Tool	Purpose
1	brainstorm / plan	Explore problem space, decide approach
2	openspec proposal <name>	Formalize into proposal + design + specs + tasks
3	/audit spec	Validate spec quality before decompose
4	/plan-decompose	Convert to beads epic with skeleton tasks
5	/enrich <task-id>	Promote ready tasks to self-contained
6	/impl	Implement enriched tasks
7	openspec archive <name>	Archive completed proposal

Input: OpenSpec change directory or plan file from .claude/plans/. Output: Beads epic with lightweight subtasks.

Default Behavior (Skeleton-First)

ALL tasks get lightweight descriptions:

Aspect	Default
Description	Lightweight (5-8 lines: scope + deliverables + depends on)
Priority	P3
TDD	Skipped (created later via /enrich)
TIDY	Skipped (created later via /enrich)
Structure	2-level: epic → task
Lifecycle beads	None

Use /enrich <task-id> to promote a task to self-contained when ready to implement.

Flags

Flag	Description
--enrich-all	Legacy: ALL tasks get self-contained descriptions + TDD classification + TIDY beads
--skip-tdd	Skip TDD beads — test + tidy (only with --enrich-all)
--with-features	Opt-in 3-level: epic → feature → task grouping
--with-release	Opt-in: create RELEASE lifecycle bead
--with-pr	Opt-in: create PR lifecycle bead
--dry-run	Preview structure without creating beads