What problem does it solve?
Prevents scope creep and enforces project identity by blocking proposed features that conflict with the project's declared boundaries or exceed code budget at the earliest stage of development. This ensures new work aligns with CLAUDE.md and SOUL.md policies and avoids unnecessary implementation churn.
Core Features & Use Cases
- Document-driven validation: Reads CLAUDE.md and SOUL.md to determine whether a proposed feature aligns with the project's core identity and explicit "not doing" list.
- Budget and LOC checks: Retrieves budgets.total from .agent/governance.yaml, estimates LOC impact for a proposed feature, and compares against remaining budget to produce a deterministic pass/fail outcome.
- Enforcement & reporting: Triggers automatically on vibe flow new (and can be invoked manually) to produce a structured report citing specific clauses and a clear recommendation to continue, discuss, or reject.
Quick Start
Run the scope gate during a new feature proposal to check compliance against CLAUDE.md and SOUL.md and get a pass/flag report with LOC budget implications.