Task Tree

Core Concepts

• Every subdirectory under ./superRA with a task.md file is a task. A leaf task is a directory with task.md but no subdirectories containing task.md.
• The filesystem hierarchy is the task hierarchy. walk_plan() discovers children by scanning subdirectories.
• Dependencies are sibling-only. depends_on values are sibling directory names within the same parent.
• Parent task status rolls up from children automatically — a parent is approved only when all active (non-parked) children are approved; archived and postponed children are excluded from the rollup computation.
• DAG-derived ordering vs. display order. The dependency DAG controls execution order. Numeric prefixes on directory names (e.g. 01-load, 02-merge) control display order only — these are independent.

CLI Setup

In a fresh project, bootstrap the wrapper with the loaded skill directory (<skill-dir> = the directory containing this SKILL.md; substitute the real path), then use the wrapper for everything after:

uv run --script <skill-dir>/scripts/cli.py wrapper init   # writes superRA/superra (planner/main bootstrap)
./superRA/superra wrapper init                             # refresh an existing wrapper; idempotent