ash1794/vibe-engineering / plugins/vibe-engineering/skills/vibe-scope-guard
vibe-scope-guard
VerifiedDetects and redirects scope creep during implementation — unrequested features, drive-by refactors, premature abstraction, and over-engineering. Use while implementing, especially when a change is growing beyond the original request.
vibe-scope-guard
The best code is the code you don't write. Frontier coding models tend to over-build: extra configurability, defensive layers, helpers "for later." Stay on what was asked.
When to Use This Skill
- During any implementation task
- When you notice you're "improving" code that wasn't in the request
- When the diff is noticeably larger than the request implies
- When you're about to create an abstraction "for later"
When NOT to Use This Skill
- During brainstorming (ideas should be unconstrained)
- When the user explicitly asks for broad improvements
- When the extra work is necessary for correctness (a bug in the code path you're changing)
Scope Creep Signals
| Signal | Example | Response |
|---|---|---|
| Unrequested features | "While I'm here, let me add caching" | Was caching requested? |
| Premature abstraction | "Let me create a generic helper for this" | Is there a second caller today? |
| Gold plating | "Comprehensive error messages for every case" | Only at system boundaries |
| Drive-by refactor | "This function could be cleaner" | Not in this change |
| Over-engineering | "Let me make this configurable" | Does anyone need to configure it? |
| Defensive sprawl | Validation and fallbacks for states that can't occur | Trust internal invariants; validate at the boundary |
| Documentation creep | "Docstrings on all these functions" | Only on what you changed |
| Test over-expansion | "Test every possible input" | Test boundaries and behaviors, not permutations |
The Rule
Three similar lines of code are better than a premature abstraction.
Before adding anything not explicitly requested:
- Was it requested? → No →
- Is it required for the requested change to be correct? → No →
- Don't add it. Mention it as a suggestion in the summary if it's worth the user's attention.
Steps
When you detect scope creep:
- Stop — Don't commit the extra work
- Revert it if it's already written
- Note it: "Also noticed: [X]. Not changed; want a follow-up?"
- If the user accepts — do it as a separate, clearly labeled change
Output
This skill mostly changes behavior rather than producing output. When invoked explicitly:
Scope Audit
Original request: [what was asked] Scope additions detected: X
| Addition | Requested? | Needed for correctness? | Action |
|---|---|---|---|
| [extra work] | No | No | Removed; suggested as follow-up |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |