aiwf-list

Filters planning-tree entities by kind, status, parent, area, and priority via aiwf list.

Updated May 9, 2026
One-click install
npx skills add https://github.com/23min/aiwf --skill aiwf-list-23min
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aiwf-list
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded/aiwf-list
Command: npx skills add https://github.com/23min/aiwf --skill aiwf-list-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a project's planning state lives as markdown entities (epics, milestones, ADRs, gaps, decisions, contracts) inside a repo, answering structured questions like "every open gap" or "all proposed ADRs under epic E-NNNN" requires manually scanning files. This Skill runs aiwf list to return one row per matching entity, or a per-kind count summary when called with no flags. ## Core Features & Use Cases - Structured filtering: Filter entities by --kind, --status, --parent, --area, --priority, and --archived, with results sorted by id and terminal-status entities hidden by default. - Machine-readable output: Emit a JSON envelope (--format=json --pretty) with {id, kind, status, title, parent, path} per row for piping into tools like jq. - Cross-branch visibility: Surface ids known on other branches or remote-tracking refs but absent locally, distinctly labeled so they never read as ordinary local rows. - Use Case: A user asks "what milestones are in progress under the auth epic?" — run aiwf list --kind milestone --status in_progress --parent E-NNNN and present the filtered rows. ## Quick Start Ask the assistant to list every open gap in the planning tree, and it will run aiwf list with the matching kind and status filters.

Frequently Asked Questions about aiwf-list

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list all milestones with a specific status under an epic?

Run aiwf list with the kind, status, and parent filters, for example aiwf list --kind milestone --status in_progress --parent E-NNNN. It prints one tab-aligned row per matching entity sorted by id, or a JSON array with --format=json.

When should I use aiwf list versus aiwf status?

Use aiwf list for query-shaped prompts where the user names a kind, status, parent, area, or priority filter and wants a flat row set. Use aiwf status for narrative questions like what's next or where are we, which need a curated snapshot for a human reader.

Does aiwf list show completed or cancelled entities?

By default aiwf list hides terminal-status entities such as done, cancelled, rejected, or retired. Pass --archived to include them, which also transparently walks archive directories created by aiwf archive.

Can aiwf list output JSON for scripting?

Yes, append --format=json and optionally --pretty. The envelope's result field is an array of objects with id, kind, status, title, parent, and path, suitable for piping into jq or other tooling.

What happens when I filter by an invalid priority value?

Priority is a closed set of urgent, high, medium, and low, so an out-of-range value like critical is a usage error naming the allowed levels, not a silent empty result. Only gaps and decisions carry a priority; other kinds never match this filter.

Does aiwf list modify the planning tree?

No, aiwf list is read-only and produces no commit. It only walks the planning tree and any known cross-branch refs to report matching entities.