/scope-guard

name: scope-guard
description: Scores feature worthiness and enforces branch-size limits against overengineering. Use when evaluating whether a feature belongs in the current scope or branch.
alwaysApply: false
category: workflow-methodology
tags:
- anti-overengineering
- scope
- YAGNI
- prioritization
- backlog
dependencies: []
tools: []
usage_patterns:
- feature-evaluation
- scope-validation
- threshold-monitoring
- backlog-management
complexity: intermediate
model_hint: standard
estimated_tokens: 2500
modules:
- modules/decision-framework.md
- modules/github-integration.md
- modules/anti-overengineering.md
- modules/branch-management.md
- modules/baseline-scenarios.md
role: library

> The cheapest feature is the one you never build. > Scope-guard weighs each proposed feature against its value, > its cost, and the branch budget, so only what is earned ships.

Table of Contents

• [Philosophy](#philosophy)
• [When to Use](#when-to-use)
• [When NOT to Use](#when-not-to-use)
• [Quick Start](#quick-start)
• [1. Score the Feature](#1-score-the-feature)
• [2. Check Against Backlog](#2-check-against-backlog)
• [3. Verify Branch Budget](#3-verify-branch-budget)
• [4. Monitor Thresholds](#4-monitor-thresholds)
• [Core Workflow](#core-workflow)
• [Step 1: Calculate Worthiness (`scope-guard:worthiness-scored`)](#step-1:-calculate-worthiness-(scope-guard:worthiness-scored))
• [Step 2: Compare Against Backlog (`scope-guard:backlog-compared`)](#step-2:-compare-against-backlog-(scope-guard:backlog-compared))
• [Step 3: Check Branch Budget (`scope-guard:budget-checked`)](#step-3:-check-branch-budget-(scope-guard:budget-checked))
• [Step 4: Document Decision (`scope-guard:decision-documented`)](#step-4:-document-decision-(scope-guard:decision-documented))
• [Anti-Overengineering Rules](#anti-overengineering-rules)
• [Backlog Management](#backlog-management)
• [Directory Structure](#directory-structure)
• [Queue Rules](#queue-rules)
• [Adding to Queue](#adding-to-queue)
• [Integration Points](#integration-points)
• [With superpowers:brainstorming](#with-superpowers:brainstorming)
• [With superpowers:writing-plans](#with-superpowers:writing-plans)
• [During superpowers:executing-plans](#during-superpowers-executing-plans)
• [Required TodoWrite Items](#required-todowrite-items)
• [Related Skills](#related-skills)
• [Module Reference](#module-reference)

Scope Guard

Prevents overengineering by both Claude and human during the brainstorm, plan, and execute workflow. Forces explicit evaluation of every proposed feature against business value, opportunity cost, and branch constraints.

Philosophy

**Core Belief:** Not all features deserve implementation. Most ideas should be deferred to backlog until proven necessary.

**Three Pillars:** 1. **Worthiness Scoring** - Quantify value vs cost before building 2. **Opportunity Cost** - Compare against existing backlog 3. **Branch Discipline** - Respect size thresholds

When To Use

• During brainstorming sessions before documenting designs
• During planning sessions before finalizing implementation plans
• When evaluating "should we add this?" decisions
• Automatically via hooks when branches approach thresholds
• When proposing new features, abstractions, or patterns

When NOT To Use

• Bug fixes with clear, bounded scope
• Documentation-only changes
• Trivial single-file edits (< 50 lines)
• Emergency production fixes

Quick Start

1. Score the Feature

Use the Worthiness formula:

(Business Value + Time Criticality + Risk Reduction) / (Complexity + Token Cost + Scope Drift)

**Verification:** Run the command with `--help` flag to verify availability.

See [decision-framework.md](modules/decision-framework.md) for details.

**Thresholds:**

• **> 2.0** → Implement now
• **1.0 - 2.0** → Discuss first
• **< 1.0** → Defer to backlog

2. Check Against Backlog

Compare against `docs/backlog/queue.md`:

• Does it beat top queued items?
• Is there room in branch budget?

3. Verify Branch Budget

**Default: 3 major features per branch**

If at capacity, must drop existing feature, split to new branch, or justify override.

4. Monitor Thresholds

Watch for Yellow/Red zones:

• **Lines:** 1000/1500/2000
• **Commits:** 15/25/30
• **Days:** 3/7/7+

See [branch-management.md](modules/branch-management.md) for monitoring.

Core Workflow

Step 1: Calculate Worthiness (`scope-guard:worthiness-scored`)

Score each factor (1, 2, 3, 5, 8, 13):

• **Value Factors:** Business Value, Time Criticality, Risk Reduction
• **Cost Factors:** Complexity, Token Cost, Scope Drift

Details: [decision-framework.md](modules/decision-framework.md)

Step 2: Compare Against Backlog (`scope-guard:backlog-compared`)

1. Check `docs/backlog/queue.md` for existing items 2. Compare Worthiness Scores 3. New item must beat top queued item OR fit within branch budget

Step 3: Check Branch Budget (`scope-guard:budget-checked`)

Count current features in branch. If at budget (default: 3), new feature requires:

• Dropping an existing feature, OR
• Splitting to new branch, OR
• Explicit override with justification

Step 4: Document Decision (`scope-guard:decision-documented`)

Record outcome:

• **Implementing:** Note Worthiness Score and budget slot
• **Deferring (MANDATORY STEPS):**

1. **Create GitHub issue immediately** - See [github-integration.md](modules/github-integration.md) Steps 1-3 2. Mark `scope-guard:github-issue-created` complete 3. **Create Discussion** - See [github-integration.md](modules/github-integration.md) Step 4. Prompt: "Creating a Discussion with full reasoning context. [Y/n]" Publishing is the default. If the user explicitly declines, skip Discussion creation. If publishing fails, continue. 4. Optionally add to `docs/backlog/queue.md` with issue link

• **Rejecting:** Document why (low value, out of scope)

**IMPORTANT:** Deferral is NOT complete until a GitHub issue exists. This prev