| name | vc:audit-plans |
| description | Audit active Flowser plan files for staleness, completion, and routing truth. Use when cleaning up plans, reconciling active work, or archiving completed artifacts. |
| metadata | {"author":"flowser","version":"1.0.0"} |
Audit Plans
Use this skill to review active plan artifacts and reconcile them with the current codebase.
This is a maintenance and recovery skill, not an automatic post-task hook.
Optional input: a feature, folder, plan filename, or maintenance scope to prioritize.
Prefer it when:
- UPDATE PROCESS was skipped and active-plan cleanup drift accumulated
- the user wants a periodic active-plan cleanup pass
- multiple active plans need reconciliation after a burst of work
Workflow
- Read
references/audit-plans.md for the full audit process.
- Run the inventory validator:
node .claude/skills/vc-audit-plans/scripts/validate-plan-inventory.mjs
- Inventory plans in
process/general-plans/active/ and process/features/*/active/.
3.5. Scan sibling reports/ and references/ dirs alongside each active/ dir for artifacts tied to plans classified as Completed or Obsolete. Match by feature slug, date proximity (7 days), or content reference to the plan filename.
- Cross-check each plan against the actual codebase with file existence checks and targeted
rg searches.
- Classify each plan as
Completed, Partially Done, Obsolete, Stale, Active, or Reference.
- Move only clearly completed or obsolete plans to the appropriate
completed/ folder.
- Ask before deleting anything.
- Re-run the inventory validator after moving or editing plan files.
Output
Return a concise summary table with classification, action taken, and any user decisions needed. Include stale artifact findings (reports/references tied to completed or obsolete plans) with recommended actions.
