aif-archive

Archive completed plan files and trim closed milestones from ROADMAP.md.

31|2|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/letuhao/lore-weave --skill aif-archive-letuhao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aif-archive
Source: https://github.com/letuhao/lore-weave/tree/main/.cursor/skills/aif-archive
Command: npx skills add https://github.com/letuhao/lore-weave --skill aif-archive-letuhao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finished plan files pile up in the active plans directory and closed milestones clutter ROADMAP.md, making it hard to see what work remains. This Skill moves completed plans into an archive directory and snapshots closed roadmap milestones, keeping the active workspace clean. ## Core Features & Use Cases - Plan Archiving: Detects plans whose task checkboxes are all complete and moves them to the archive directory with an archived date added to YAML frontmatter. - Roadmap Trimming: Extracts closed milestones from ROADMAP.md into dated snapshot files under the archive's roadmap folder. - Collision Safety: Checks for existing archive files before moving, stopping or skipping instead of overwriting previously archived plans. - Use Case: After finishing a sprint, run the archive command to move all completed plan files out of the active plans folder and snapshot the closed milestones, leaving only in-progress work visible. ## Quick Start Ask the AI to archive all completed plans and trim the closed milestones from the roadmap.

Frequently Asked Questions about aif-archive

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

FAQPage Schema
How do I archive completed plan files in a project?

Run the archive command with no arguments to list completed plans interactively, pass a plan name to archive one file, or use --all to archive every completed plan after confirmation. Only plans whose task checkboxes are all checked are eligible.

How is a plan determined to be completed?

A plan is completed when its ## Tasks section exists and every checkbox line in that section is marked - [x], including nested checkboxes. Plans with no Tasks section or zero checkboxes are not archivable.

Can I trim closed milestones from ROADMAP.md?

Yes, the --roadmap mode finds milestones marked - [x], writes them into a dated snapshot file under the archive roadmap directory, then removes those lines from ROADMAP.md after confirmation. The roadmap is only edited if the snapshot write succeeds.

What happens if an archived plan filename already exists?

The Skill never overwrites existing archive files. Single-plan archiving stops with an error, while batch mode skips the conflicting plan with a warning and continues with the rest.

Does archiving affect sequential plan numbering?

No. Archived plans move out of the active plans directory, so sequential numbering scans only active plans. Fast plans and fix plans are never touched by the archive operation.