🔭 Scope Creep Detector

Checks a working, staged, saved, or branch diff against a one-line intent. It flags unrelated paths, new dependencies, public API renames, config or CI edits, oversized hunks, formatting-only files, and subsystem spread. The output is a local JSON report for keep, split, or justify decisions.

The demo analyzes a "fix null deref in parser" change that also touched CI config, added a dependency, and dropped in an unrelated file. The parser fix is kept; the rest is flagged.

Install

npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/scope-creep-detector

Run

Ask the agent:

Did my change grow beyond the parser fix I intended?

Or run the deterministic core directly:

python3 scripts/scope_creep.py --repo /path/to/repo \
  --intent "fix null dereference in parser" --json

Use --staged for the index, --base main for a branch diff, or --diff - for unified diff input on stdin. The script uses only the Python standard library, makes no network calls, and does not modify the repository.