Skip to content
Back to skills

Task Tree

ASecurity

Operate on superRA/ task trees. Use to query frontier, DAG, or tree views; create or restructure tasks; edit statuses; serve dashboards; or migrate legacy PLAN.md/RESULTS.md.

  • 12 stars
  • 0 votes
  • 0 copies
  • 3 views
  • Added September 9, 2026
documentationgobashnodegit

Works with

  • cli

Security analysis

A100/100

Pro scans all 19 files and shows the line behind each finding

Scanned November 9, 2026

npx -y skills add FuZhiyu/superRA --skill task-tree --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Task Tree?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Task Tree
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/fuzhiyu-task-tree/badge)](https://www.skillsdirectory.com/skills/fuzhiyu-task-tree)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: task-tree
description: Operate on superRA/ task trees. Use to query frontier, DAG, or tree views; create or restructure tasks; edit statuses; serve dashboards; or migrate legacy PLAN.md/RESULTS.md.
user-invocable: true
---

# Task Tree

## Core Concepts

- **Task** — an immediate subdirectory of a task directory or the rootless `./superRA` forest that contains `task.md`. `attachments/` is always an asset container, never a task. A leaf task has no child task directories.
- **Filesystem hierarchy is the task hierarchy.** `walk_plan()` discovers children by scanning subdirectories.
- Retained files are companions, not task nodes — classification, placement, and lifecycle in `../using-superra/references/task-companion-files.md`.
- **`depends_on` decides readiness; file dependencies inform.** `depends_on` names sibling directories; a task can start once each one, own or inherited, is `implemented`, `approved`, or `revise`. File edges between steps order builds and are reported as inputs, never gating: [Effective Dependencies](references/task-file-contract.md#effective-dependencies).
- **Parent status rolls up** from children automatically — `approved` only when all active (non-parked) children are `approved`; `archived` and `postponed` children are excluded.
- **DAG order vs. display order.** The dependency DAG controls execution order; numeric directory prefixes (`01-load`, `02-merge`) control display order only. Independent.

## CLI Setup

Bootstrap a fresh project's wrapper from the loaded skill directory (`<skill-dir>` = the directory holding this `SKILL.md`; substitute the real path), then use the wrapper for everything after:

```bash
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
```

## Reading the Tree

Run the committed `./superRA/superra` wrapper created above — contributors inside the superRA checkout substitute `uv run --script skills/task-tree/scripts/cli.py`. Every `superra …` example below and in the references denotes it:

```bash
./superRA/superra task tree            # tree with status badges
./superRA/superra task frontier        # ready tasks, each with its inputs whose producer is stale, missing, or failed
./superRA/superra task dag 01-data     # dependency DAG for a subtree (Mermaid)
./superRA/superra task tree --json     # JSON output
./superRA/superra dashboard --no-open  # idempotent; starts or reuses a server and prints this worktree's scoped URL
```

**Deep-link a dashboard task:** append `#/<task-path>` to the scoped URL from `dashboard --no-open`. `<task-path>` is the `task read` locator (no `superRA/` prefix, empty for the tree root). Use the emitted URL as-is — its URL-encoded `?wt=` selector handles worktree-name collisions.

## Task File Format

```yaml
---
title: "Merge with Fund Characteristics"
status: not-started
depends_on:
  - 01-sample-design
---

## Objective

Left join holdings with fund characteristics on fund_id x date.
Use CRSP-style merge conventions. Validate row counts post-merge.

## Results

Left join preserved all 4.7M holdings rows.
Quarterly characteristics were matched to monthly holdings by nearest prior date.

## Review Notes
> [BLOCKING] Inner join used instead of left join
```

Field-by-field anatomy and body-section ownership: `references/task-file-contract.md` §Task Anatomy.

## Routing — operate on the tree

| To do X | See |
|---|---|
| Create / rename / link / move tasks; bulk status propagation; append results programmatically | `references/commands.md` |
| Read or resolve task comments (the read/resolve loop; comments also surface via `superra task read`) | `references/commands.md §Comments` |
| Validate tree structure, fix status inconsistencies, diagnose orphaned `depends_on` entries | `references/commands.md §Diagnostics` |
| Rebuild steps, inspect change impact, or accept reviewed results | [commands.md §Reproduction](references/commands.md#reproduction) |
| Task-file anatomy, fields, status/dependencies, inherited context, results shape, stale-content, figure embedding | `references/task-file-contract.md` |
| Task companion-file classification, placement, reproducibility, promotion, and maturation | `../using-superra/references/task-companion-files.md` |
| Objective writing, task splitting, placement, durable homes, update-task lifecycle, retroactive task-tree creation | `../superplan/references/task-tree-design.md` |
| Migrate legacy `PLAN.md` + `RESULTS.md`, or upgrade `superRA/` v1 → v2 | `references/internals.md §Migration` |
| Dashboard server mechanics (idempotent ensure-running, task URLs, artifact export) | `references/internals.md §Dashboard` |
| Modify the skill itself (data layer, hooks, scripts) | `references/internals.md`; hook coverage details live in `§Hook Architecture` |

Intentional task path changes go through `superra task move` (`task rename` for same-parent compatibility), never raw `mv` / `git mv`. It resolves the fallout — relative Markdown links, root-relative task paths, and sibling-only `depends_on` edges — so run the move directly rather than rewriting them by hand first. Mechanics and cross-parent dependency rules: `references/commands.md §Move / rename a task`.

Files in this skill

  • .gitignore171 B
  • SKILL.md4.8 KB
  • references/commands.md4.8 KB
  • references/internals.md22.8 KB
  • references/task-file-contract.md10.9 KB
  • scripts/_apply_patch.py6.1 KB
  • scripts/_artifacts.py20.6 KB
  • scripts/_comments.py12.9 KB
  • scripts/_task_io.py46.5 KB
  • scripts/_task_validate.py7.3 KB
  • scripts/_worktree_discovery.py8.9 KB
  • scripts/cli.py29.2 KB
  • scripts/conftest.py4.5 KB
  • scripts/dashboard_artifact_workflow.py4.8 KB
  • scripts/plan_migrate.py18.5 KB
  • scripts/task_add_result.py4.3 KB
  • scripts/task_check.py12.2 KB
  • scripts/task_comment.py5.9 KB
  • scripts/task_create.py3.5 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in documentation →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.