vc-audit-plans
vc-audit-plans scans your active plan inventory to flag stale, completed, or obsolete artifacts and recommend archival or cleanup actions. It validates plan status against your codebase, detects misplaced task artifacts, and surfaces a summary table with classifications and next steps. Use it for periodic maintenance, post-burst reconciliation, or when plan cleanup has drifted.
vc-audit-plans reviews active project plan files to identify staleness, completion status, and misplaced artifacts.
AI-generated summary based on this skill's SKILL.md
Install
withkynam/vibecode-pro-max-kit/vc-audit-plans · repository language: JavaScript
git clone https://github.com/withkynam/vibecode-pro-max-kit
cp -r vibecode-pro-max-kit/.claude/skills/vc-audit-plans ~/.claude/skills/vc-audit-plansnpx skillfed install withkynam/vibecode-pro-max-kit/vc-audit-plansFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does vc-audit-plans do?
vc-audit-plans scans your active plan inventory to flag stale, completed, or obsolete artifacts and recommend archival or cleanup actions. It validates plan status against your codebase, detects misplaced task artifacts, and surfaces a summary table with classifications and next steps.
How do I audit project plans for staleness?
vc-audit-plans audits project plans for staleness by comparing plan file timestamps and content against your current codebase state. It identifies plans that have drifted from reality, marks those that are completed, and flags obsolete artifacts so you can decide whether to archive or update them.
Can vc-audit-plans find stale plan files in my codebase?
Yes. vc-audit-plans finds stale plan files in your codebase by scanning your active plan inventory and cross-referencing against current development work. It surfaces plans that are no longer relevant, haven't been updated, or whose tasks have already been completed.
When should I use vc-audit-plans for cleanup?
Use vc-audit-plans for periodic maintenance after development bursts, post-project reconciliation, or whenever plan cleanup has drifted. It helps you organize your plan inventory, archive completed or obsolete plans to proper folders, and locate misplaced task artifacts for consolidation.
What output does vc-audit-plans provide?
vc-audit-plans provides a summary table classifying each plan file with its status (stale, completed, active, or misplaced), reconciliation notes, and recommended next steps. This lets you quickly decide which plans to archive, update, or consolidate.
How does vc-audit-plans reconcile plan artifacts with code?
vc-audit-plans reconciles plan artifacts with code by validating that active plans align with your current codebase state. It detects drift between documented tasks and actual implementation, identifies orphaned plan documents, and recommends consolidation of duplicates or misplaced references.
SKILL.md
rendered from the published skill — quoted content, verbatim
Audit Plans
> Output style: Follow process/development-protocols/communication-standards.md — answer-first, plain language, no unexplained jargon, TL;DR on long responses.
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.mdfor the full audit process. - Run the inventory validator: ```bash node
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 15 files
.claude/skills/vc-audit-plans/SKILL.md
.claude/skills/vc-audit-plans/references/audit-plans.md
.claude/skills/vc-audit-plans/scripts/eval-coverage-known-gaps.json
.claude/skills/vc-audit-plans/scripts/fixtures/validate-backlog-notes/fail/malformed_NOTE.md
.claude/skills/vc-audit-plans/scripts/fixtures/validate-backlog-notes/pass/d2-fix-deferred_NOTE.md
.claude/skills/vc-audit-plans/scripts/fixtures/validate-phase-plan-completeness/fail.md
.claude/skills/vc-audit-plans/scripts/fixtures/validate-phase-plan-completeness/pass.md
.claude/skills/vc-audit-plans/scripts/fixtures/validate-phase-reports/fail/umbrella.md
.claude/skills/vc-audit-plans/scripts/fixtures/validate-phase-reports/pass/phase-01_REPORT.md
.claude/skills/vc-audit-plans/scripts/fixtures/validate-phase-reports/pass/umbrella.md
.claude/skills/vc-audit-plans/scripts/fixtures/validate-umbrella-state/fail.md
.claude/skills/vc-audit-plans/scripts/fixtures/validate-umbrella-state/pass.md
.claude/skills/vc-audit-plans/scripts/validate-backlog-notes.mjs
.claude/skills/vc-audit-plans/scripts/validate-eval-coverage.mjs
.claude/skills/vc-audit-plans/scripts/validate-phase-plan-completeness.mjs