scoping
Skill1 starsChanged 3 months agoMITView on GitHub
Defines a project's delivery boundary: what is in, what is out, and what is sufficient for the goal. Use when a project's goals are set and its scope needs defining or revising, including scope growth during delivery. Skip single-feature requirements, unresolved intent, and speculative additions at the implementation level.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- NashEQify/forgetheir own version, first seen Oct 25, 2026
- Yeseh/software-factory-demotheir own version, first seen Jun 19, 2026
- ShurikenTrade/shuriken-skillstheir own version, first seen Apr 23, 2026
- smileynet/game-spicetheir own version, first seen Feb 17, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- ShurikenTrade/shuriken-skills★ 90same name
- NashEQify/forge★ 2same name
- Yeseh/software-factory-demo★ 1same name
- smileynet/game-spice★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository49 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- working-from-a-ticketSkill
- writing-specsSkill
- clarifying-intentSkill
- dispatching-parallel-agentsSkill
- handoffSkill
- mapping-the-codebaseSkill
- prototypingSkill
- using-git-worktreesSkill
- using-sdlc-skillsSkill
- viewing-artifactsSkill
- writing-skillsSkill
- yagniSkill
- finishing-a-branchSkill
- release-readinessSkill
- architecture-decisionsSkill
- coding-standardsSkill
- data-modelSkill
- migration-strategySkill
- reviewing-plansSkill
- system-architectureSkill
- ui-ux-designSkill
- writing-plansSkill
- adding-observabilitySkill
- changing-a-live-schemaSkill
- executing-plansSkill
- rollout-controlsSkill
- subagent-driven-developmentSkill
- test-driven-developmentSkill
- complexity-auditSkill
- containing-an-incidentSkill
- debuggingSkill
- deprecating-an-apiSkill
- diagnosing-a-sessionSkill
- eliminating-correctionsSkill
- large-scale-changesSkill
- post-mortemSkill
- refactor-architectureSkill
- brainstormingSkill
- define-goalsSkill
- feasibility-checkSkill
- receiving-code-reviewSkill
- requesting-code-reviewSkill
- reviewing-a-prSkill
- security-auditsSkill
- verification-before-completionSkill
- verification-strategySkill
- visual-ui-verificationSkill
The file
We split this skill into the rules it gives an agent
9 rules. 0 are common, 6 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
After the goals are approved, whether they were already present or define-goals produced them, and before a project boundary that is still …
- Distinctive: line 15
When scope is unclear, or growing, part-way through a project.
- Distinctive: line 27
Put in scope the smallest set of capabilities that reaches the approved outcome under those constraints.
- Distinctive: line 29
Put out of scope each deferred capability, with a stable ID, the rationale, its impact on the goal, an owner, and the trigger for …
- Distinctive: line 33
Write the MVP as the thinnest version that meets the goal and every non-negotiable.
- Distinctive: line 38
Write the change rules: the observations that abort this cut, the changes that reopen approval, and who decides.
- Very specific: line 45
Write the ## Scope section to .sdlc-skills/briefs/{{YYYY-MM-DD}}-{{topic}}.md or the user-set path, keeping the approved sections around it …
- Very specific: line 63
Ask this and end the turn.
- Distinctive: line 70
If a later rescoping pass reuses a deferred capability's stable ID for a different item, an old reference to that ID, such as a linked task …
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Scoping
Name the boundary before anyone starts building.
When to use
- After the goals are approved, whether they were already present or
define-goalsproduced them, and before a project boundary that is still unresolved is used as an input. - When scope is unclear, or growing, part-way through a project.
- Skip for a single feature. Use
clarifying-intentonly when the feature's intent or boundary is ambiguous;writing-specsowns its detailed requirements and non-goals.
Step 1: Cut the scope
Open assets/scope-section.md before starting; each step fills its section.
- Carry the non-negotiables forward first: goal guardrails, existing contracts, preserved behavior and data, security, accessibility, compatibility, operability, recovery.
- Put in scope the smallest set of capabilities that reaches the approved outcome under those constraints.
- Put out of scope each deferred capability, with a stable ID, the rationale, its impact on the goal, an owner, and the trigger for revisiting it. Never list a preserved invariant or an existing commitment there.
- Write the MVP as the thinnest version that meets the goal and every non-negotiable.
- For each assumption and each dependency, record its validation action, its owner, and its expiry or decision point. A hidden project inside "assumes X" is scope, not an assumption.
- Write the change rules: the observations that abort this cut, the changes that reopen approval, and who decides. If the user is the only stakeholder (a solo owner), they decide, and no approver matrix is recorded.
Step 2: Write and present
- Write the
## Scopesection to.sdlc-skills/briefs/{{YYYY-MM-DD}}-{{topic}}.mdor the user-set path, keeping the approved sections around it as they are. Once its identity is issued, the section is never edited. Present:
Scope {{path}} — version {{identity (per template)}} In: {{n}} capabilities Out: {{n}} MVP: {{one line}} Assumptions: {{n}} owned 1. Approve this boundary 2. Request a scope change 3. Reject the cut 4. Cancel Recommendation: {{thinnest answer that reaches the goal}} — {{one sentence}}.Ask this and end the turn;
clarifying-intentowns what closes it.- REQUIRED SUB-SKILL: on option 1, invoke
writing-specswhen detailed requirements are the next missing input. Never impose a phase that is already complete.
Gotchas
- If a later rescoping pass reuses a deferred capability's stable ID for a different item, an old reference to that ID, such as a linked task or a review note, silently points at the wrong decision. An ID retires; it is never reissued.
- An assumption recorded with a validation action but no expiry or decision point reads as settled forever. Nothing then re-checks it once whatever it depended on changes underneath it.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

