vcaudit-plans

Solid

Audit active project plan files for staleness, completion, and routing truth. Use when cleaning up plans, reconciling active work, or archiving completed artifacts.

AI & Automation 852 stars 197 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
98
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
82
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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 1. Read `references/audit-plans.md` for the full audit process. 2. Run the inventory validator: ```bash node .claude/skills/vc-audit-plans/scripts/validate-plan-inventory.mjs ``` 3. 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. 4. Cross-check each plan against the actual codebase with file existence checks and targeted `rg` searches. 5. Classify each plan as `Completed`, `Partially Done`, `Obsolete`, `Stale`, `Active`, or `Reference`. 6. Move only clearly completed or obsolete plans to the appropriate `completed/` folder. 7. Ask before deleting anything. 8. Re-run the inventory validator after moving or editing plan files. ## Output Return a concise summary table with classification, action taken, and any user ...

Details

Author
withkynam
Repository
withkynam/vibecode-pro-max-kit
Created
2 weeks ago
Last Updated
1 weeks ago
Language
JavaScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category