aiwf-history

Queries git log commit trailers to reconstruct the lifecycle timeline of an aiwf entity.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When planning state lives in markdown files tracked by git, answering "what happened to this entity?" requires digging through commit history by hand. This Skill runs aiwf history to surface the full lifecycle of an epic, milestone, ADR, gap, decision, contract, or acceptance criterion directly from structured git commit trailers. ## Core Features & Use Cases - Entity Timeline Retrieval: Runs aiwf history <id> to render one event per line with date, actor, verb, target status, and commit SHA, including forced, audit-only, and reason sub-lines. - Rename-Aware Lineage: Resolves queries through prior_ids so pre-rename, rename, and post-rename commits weave into a single chronological timeline. - Composite and Milestone Views: Queries M-NNNN/AC-N for one acceptance criterion's events, or a bare milestone id to include all of its ACs. - Authorization Provenance: Expands scope-authorization chips with --show-authorization and emits full trailer sets via --format=json. - Use Case: A user asks "why is this gap closed?" or "who authorized this work?" — the Skill runs aiwf history G-NNNN and reports the closing commit, actor, and any [forced: ...] or [audit-only: ...] markers. ## Quick Start Ask the assistant to show the history of an aiwf entity, for example: "Show me what happened to M-0007 including its acceptance criteria."

Frequently Asked Questions about aiwf-history

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

FAQPage Schema
How do I see the history of an aiwf entity?

Run `aiwf history <id>` to get one event per line showing date, actor, verb, target status, and commit SHA. The command reads git log filtered by `aiwf-entity` and `aiwf-prior-entity` commit trailers, so no separate event log is needed.

How to track entity history across renames in git?

aiwf history resolves the queried id through the entity's `prior_ids` lineage and greps git log for every id in the chain. Pre-rename, rename, and post-rename commits are woven into a single chronological timeline automatically.

Can I view the history of a single acceptance criterion?

Yes, query the composite id directly: `aiwf history M-NNNN/AC-N` shows only that AC's events. Querying the bare milestone id `M-NNNN` instead shows the milestone's own events plus every AC's events.

Why is a commit missing from aiwf history output?

Selection is by trailer, never by path or subject — commits without an `aiwf-entity` or `aiwf-prior-entity` trailer do not appear. `aiwf check` flags such gaps as `provenance-untrailered-entity-commit`, and `aiwf <verb> --audit-only --reason` is the repair path.

What are the limitations of git-trailer-based history?

Promote commits written before the `aiwf-to:` trailer existed render the target column as a dash, and legacy reallocates without `prior_ids` only surface post-rename history when querying the new id. Filesystem timestamps are never authoritative — git log is.