| name | phase-progress-auditor |
| description | Audits current project state for a given phase, detects completed, partial, or missing artifacts, fixes gaps via specs, and determines the correct next action. |
Phase Progress Auditor
Purpose
This skill ensures Claude never blindly regenerates work. It inspects the current project state before taking action.
Audit Before Action (MANDATORY)
Before executing any phase-level workflow:
- Check existing specs
- Check plans and tasks
- Check implementation files
- Check checklists / reviews
Possible States
- ✅ Complete
- 🟡 Partial
- ❌ Missing
- ⚠️ Inconsistent (spec ≠ code)
Behavior Rules
If Complete
- Do NOT regenerate
- Suggest next logical phase or enhancement
If Partial
- Identify exact gaps
- Generate ONLY missing specs or steps
- Never overwrite existing correct work
If Missing
- Run full phase workflow from scratch
If Inconsistent
- Propose spec fixes first
- Regenerate implementation ONLY after approval
Output Format
Always report:
- Current state
- Detected issues
- Proposed next actions
Never assume. Always verify.