aiwf-show

Inspect a single aiwf planning entity's frontmatter, acceptance criteria, history, and findings.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on a project tracked with aiwf, you often need the full current state of one specific entity — an epic, milestone, ADR, gap, decision, contract, or acceptance criterion — without digging through scattered markdown files. This Skill runs aiwf show <id>, the canonical per-entity inspection verb, returning frontmatter, ACs, recent history, active findings, and back-references in one aggregate view. ## Core Features & Use Cases - Single-entity snapshot: Renders one entity's header, frontmatter, AC list (for milestones), recent history, findings, and referenced-by edges in text or JSON. - Composite AC inspection: Supports M-NNNN/AC-N composite ids to return just one acceptance criterion's record, including test metrics from commit trailers. - Cross-branch resolution: Resolves ids that exist only on other local branches or remote-tracking refs, clearly marking the result as cross-branch or flagging collisions. - Use Case: A user asks "what's the state of M-0007?" — the Skill runs aiwf show M-0007 --format=json --pretty and returns the milestone's status, AC progress, findings, and release note body section. ## Quick Start Ask the assistant to show you the current state of a specific aiwf entity by id, for example "show me G-0003" or "describe AC-2 on M-0007".

Frequently Asked Questions about aiwf-show

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

FAQPage Schema
How do I show the state of an aiwf entity by id?

Run `aiwf show <id>` to render one entity's frontmatter, acceptance criteria, recent history, active findings, and back-references in a single text view. Add `--format=json --pretty` for a JSON envelope that also includes body sections.

How do I inspect a single acceptance criterion on a milestone?

Use the composite id pattern `aiwf show M-NNNN/AC-N` to return just that AC's record, including its status, tdd_phase, body description, and test metrics. This pattern is not shown in `--help` but is fully supported.

What is the difference between aiwf show, aiwf history, and aiwf status?

`aiwf show` returns a state snapshot of one entity, `aiwf history` returns the full event timeline of one entity, and `aiwf status` shows what is in flight across the whole tree. Pick based on whether you want what an entity is, what happened to it, or what the project is doing.

Can aiwf show display entities from other git branches?

Yes, when an id is absent locally but exists on another local branch or remote-tracking ref, show renders that ref's content read-only and marks it as cross-branch. If the id diverges across refs, it reports a collision instead of picking a side.

Why does aiwf show not list an entity I referenced in body text?

The referenced-by reverse index is built only from typed frontmatter reference fields, not from ids mentioned in body prose. A prose mention creates no edge, so add the reference to the appropriate frontmatter field instead.