groove-work-audit
Outcome
Blindspots and gaps are identified, actionable improvements are offered.
Acceptance Criteria
Findings are categorized by action:
- Fix Now: Trivial effort, fix immediately
- Needs Spec: Important, requires planning
- Create Issues: Large effort or nice-to-have
Constraints
- Sanitize topic (if provided) for safe use — strip path separators, special characters, and traversal patterns (
../) - Specs directory is always
.groove/memory/specs/ - Gather context: branch diff, relevant specs
- Run analysis in isolated context (use general-purpose agent)
- Fall back to direct review if subagent fails
- Present findings with severity and effort estimates
- Execute chosen action: fix directly, create spec via
/groove-work-spec <topic>, or create issues
Scope Options
- No args: Review current branch vs main
- Topic: Focus on specific area