Claude-Mind: Skill for Claude Code

/decompose — Hierarchical Task Network Goal Decomposition

Breaks compound goals into primitive, executable sub-goals using a recursive HTN-inspired algorithm. Called automatically by /aspirations during the execution loop, or manually for planning.

Parameters

• goal_id (required) — The goal ID to decompose (e.g., g-003-01)
• --dry-run — Show decomposition plan without writing changes
• --max-depth N — Override max decomposition depth (default: 4)

Step 0: Load Conventions

Step 0: Load Conventions — Bash: load-conventions.sh with each name from the conventions: front matter. Read only the paths returned (files not yet in context). If output is empty, all conventions already loaded — proceed to next step.

Step 1: Load Goal Context

Bash: aspirations-read.sh --active
Find goal by ID in the output (search all aspirations' goals for the goal_id)
Read any files listed in goal.context_needed

Step 1.5: Idempotency Check (fast exit for already-decomposed goals)

Before Step 2's primitiveness test, check whether this goal was decomposed in a prior session. Re-decomposing would duplicate work.

IF goal.status == "decomposed" OR (goal.decomposed_into is a non-empty list):
    # Verify at least one child is still live.
    Bash: aspirations-read.sh --active  (locate children by ID)
    # --active filters to status==active aspirations (g-115-2604 parity fix) —
    # a child parked in a PAUSED aspiration is invisible to this dump. Before
    # concluding a child is gone, fall back to a per-id read of its parent
    # aspiration (derive asp-id from the goal-id prefix: g-336-04 -> asp-336):
    #   Bash: aspirations-read.sh --id <asp-id>  (finds paused/any-status parents)
    # Only children found in NEITHER read count as missing/terminal.
    live_children = [c for c in children if c.status in {pending, in-progress, blocked}]
    IF live_children is non-empty:
        # No-op — prior decomposition is intact and children are actionable.
        # Emit a terminal Bash call and RETURN. Do NOT output any text,
        # insight block, table, or summary paragraph after this call.
        # Return-protocol rule (.claude/rules/return-protocol.md): text after
        # the final Bash kills the autonomous session.
        Bash: echo "decompose no-op — g-{id} already decomposed into {N} live children: {child-ids}"
        RETURN
    # If all children are terminal (completed/expired/skipped), fall through
    # to Step 2 for fresh primitiveness evaluation — parent may warrant
    # re-decomposition under new constraints.