aiwf-archive

Sweeps terminal-status planning entities into per-kind archive subdirectories as a single git commit.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Over time, closed epics, gaps, decisions, ADRs, and contracts accumulate in the active planning tree, cluttering directory listings and obscuring what is actually in-flight. This Skill explains how to use the aiwf archive verb to move terminal-status entities into per-kind archive/ subdirectories while preserving id-based references and git-history provenance. ## Core Features & Use Cases - Dry-run by default: Preview every planned move without touching the tree, then commit the sweep with a single --apply flag flip. - Drift control: Configure archive.sweep_threshold in aiwf.yaml to escalate the archive-sweep-pending finding from advisory warning to a push-blocking error. - Skip semantics: Entities with uncommitted changes or non-terminal children are skipped and named, never half-moved; the rest of the sweep still commits. - Use Case: After closing a milestone and finishing wrap rituals, run a dry-run to preview the pending sweep, confirm the counts, then apply it as one commit carrying the aiwf-verb: archive trailer. ## Quick Start Ask the AI to run a dry-run of aiwf archive, review the planned moves and skipped entities, then apply the sweep as a single git commit.

Frequently Asked Questions about aiwf-archive

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

FAQPage Schema
How do I archive closed entities in an aiwf project?

Run `aiwf archive` to preview the planned moves as a dry run, then re-run with `aiwf archive --apply` to commit the sweep as a single git commit. You can scope it to one kind with `--kind gap` or another entity kind.

How do I preview which files the archive sweep will move?

The dry run is the default behavior: running `aiwf archive` with no flags prints the planned moves and any skipped entities without modifying the tree. Re-run with `--apply` only after reviewing the output.

Why does aiwf archive skip some entities during a sweep?

A candidate is skipped when a file the sweep decision depends on has uncommitted changes, or when an epic still has non-terminal child milestones. Commit or revert the named file, or close the child milestone, then re-run the sweep.

Can I undo or reverse an aiwf archive sweep?

No reverse verb exists by design; the FSM is one-directional and archive is its structural projection. The canonical pattern is to file a new entity referencing the archived one, since id references resolve across both active and archive directories.

What does the archive.sweep_threshold setting do?

Set `archive.sweep_threshold` in aiwf.yaml to escalate the archive-sweep-pending finding from a warning to a push-blocking error when pending sweeps exceed the configured count. The default is unset, which keeps the finding advisory.

Do milestones archive independently in aiwf?

No. Milestones live as flat files inside their parent epic's directory and ride with the epic when it archives. A done milestone under an active epic stays in place until the whole epic subtree moves.