plan-audit

Reconciles superpowers plan checkboxes against actual codebase state and recommends the next plan.

1|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill plan-audit-azaidrahman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-audit
Source: https://github.com/azaidrahman/zaid-sani-dotfiles/tree/main/dot_claude/skills/plan-audit
Command: npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill plan-audit-azaidrahman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plan documents with task checkboxes drift out of sync with the actual codebase, making it hard to know what is done, what remains, and which plan to execute next when starting or ending a work session. ## Core Features & Use Cases - Plan Verification: Audits each plan in docs/superpowers/plans by checking git history and file existence to verify whether unchecked tasks were actually completed. - Status Classification: Labels every plan as done, partial, not-started, superseded, or blocked, then updates verified checkboxes and adds completion banners. - Next Plan Recommendation: Ranks remaining plans by dependencies, foundation-first ordering, and momentum, then outputs a ready-to-paste handoff prompt. - Use Case: At the start of a session, run the audit to discover that two plans are fully implemented but unchecked, one is blocked by another, and receive a concrete recommendation for which plan to execute next. ## Quick Start Audit all plans in docs/superpowers/plans against the current codebase, update completed checkboxes, and tell me which plan to execute next.

Frequently Asked Questions about plan-audit

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

FAQPage Schema
How do I check if plan tasks were actually completed in the codebase?

Run the plan audit, which reads each plan's checkbox tasks and verifies them using git log on mentioned files plus existence checks for created resources and config entries. Verified tasks are marked complete in the plan file.

How to decide which plan to execute next across multiple plans?

The audit ranks plans by three criteria: dependencies first so blocked plans go last, infrastructure before features, and partially-done plans before fresh ones. It outputs the recommended plan file with a ready-to-paste execution prompt.

Does the plan audit modify or delete my plan documents?

It only checks boxes for verified tasks and adds a completion status line to fully done plans. It never deletes plan files, rewrites plan content, executes plan tasks, or creates new plans.

What plan statuses does the audit report?

Each plan is classified as done, partial, not-started, superseded, or blocked. The output is a summary table grouped by status showing completion counts, next tasks, blockers, and replacement plans.

Can the audit handle many plan files at once?

Yes, the workflow supports using parallel agents to audit multiple plans simultaneously when the plans directory contains many files, then aggregates results into a single status report.