tmsjngx0/plan-decompose

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 |