vc-audit-plans

Run the plan inventory validator script to scan active plan directories, then cross-check each plan against the codebase with file existence checks and grep searches. Classify each plan as Completed, Partially Done, Obsolete, Stale, Active, or Reference, and archive finished ones.

Move the entire task folder with git mv from the active directory to the sibling completed directory, keeping the folder name unchanged. Co-located REPORT, REF, and SPEC files move together with the plan since artifacts live inside the task folder.

Run it after completing a major feature, after an architectural pivot, when the update process was skipped and drift accumulated, or as monthly maintenance. It is also recommended when total active plans across general and feature directories exceed ten.

No, the audit never deletes anything without asking. It only moves clearly completed or obsolete plans to completed folders, and stale plans are presented to the user with a recommendation to keep, archive, or delete.

The validator checks that plan files are date-stamped, contain PLAN in the filename, include phase completion rules and verification sections, and flags duplicate basenames and high active plan counts. Default mode reports warnings; the --strict flag turns warnings into failures.