aiwf-status

Renders a one-screen snapshot of in-flight epics, open decisions, gaps, and recent git activity.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on a project across many sessions, it is hard to answer simple narrative questions like "what's next?" or "where are we?" without manually composing multiple queries against the planning tree. This Skill runs aiwf status to produce a single curated, human-readable snapshot of project state. ## Core Features & Use Cases - One-screen project snapshot: Shows in-flight epics and milestones (with acceptance-criteria badges and TDD policy), open proposed decisions (ADRs and D-NNNN), open gaps, the last 5 git-history events, and tree-health counts. - Scoping filters: Use --area to narrow to one workstream and --priority to filter open decisions and gaps by urgency level. - Worktree awareness: Surfaces per-worktree driver entities, stale worktrees, and cross-branch status disagreements, with a full --worktrees layout for questions like "where's my work?". - Use Case: A user returning to a project asks "what are we working on?" — run aiwf status, then narrate the in-flight milestone, open ACs, and pending decisions in plain language. ## Quick Start Ask the assistant "what's next on this project?" and it will run aiwf status and narrate the current state for you.

Frequently Asked Questions about aiwf-status

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

FAQPage Schema
How do I get a quick summary of project status with aiwf?

Run `aiwf status` to get a one-screen snapshot covering in-flight epics and milestones, open decisions, open gaps, the last 5 git-history events, and tree-health counts. It is read-only and makes no commits.

What is the difference between aiwf status and aiwf list?

aiwf status answers narrative human-state questions like "what's next?" with a curated snapshot of the current checkout. aiwf list handles programmatic filter queries and resolves entities on unmerged branches, so use list for complete counts or structured surveys.

Can I filter aiwf status by workstream or priority?

Yes. Use `--area <A>` to scope entity sections to one workstream, and `--priority <level>` to filter open decisions and gaps by urgent, high, medium, or low. Health and recent activity sections stay global.

Does aiwf status work with multiple git worktrees?

Yes. With two or more worktrees it adds a Worktrees section showing each worktree's driver entity, last commit age, and dirty flag. Use `aiwf status --worktrees` for a full per-worktree layout including stale-worktree cleanup hints.

Why does aiwf status undercount entities during an epic?

Entities created on an unmerged epic or patch branch are not in the current checkout's tree, so status cannot see them. Use `aiwf list`, which resolves cross-branch rows and reports the ref each came from.