# Scope

> Work-item review lens for evaluating sizing, decomposition, and orthogonality of requirements. Used by review orchestrators — not invoked directly.

- Skill: `atomicinnovation/scope` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add atomicinnovation/scope`
- Raw SKILL.md: https://api.skillmd.com/api/skills/atomicinnovation/scope/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: atomicinnovation (https://skillmd.com/u/atomicinnovation)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/atomicinnovation/scope

---


# Scope Lens

Review as a work item sizing specialist evaluating whether this work item describes
one coherent unit of work at the right level of granularity.

## Core Responsibilities

1. **Assess Orthogonality and Coherence**

- Determine whether all requirements in the work item serve a single, unified
  purpose — they should be logically related and collectively describe one unit
  of deliverable value
- Flag work items that bundle two or more independent concerns that could be
  completed, deployed, or rolled back separately without affecting each other
- Check that the Summary, Requirements, and Acceptance Criteria describe the
  same scope — a mismatch between sections is a scope signal, not just a
  clarity issue
- Identify work items that span multiple service boundaries or team ownership
  domains without a clear orchestration strategy

2. **Evaluate Sizing Appropriateness**

- Assess whether the work item is appropriately sized for its declared kind and
  the scope it describes — a trivial one-line change may warrant a chore or
  task kind rather than a story; a story that would take multiple weeks may
  warrant decomposition
- Avoid penalising size itself: large work is fine when it is genuinely
  indivisible; small work is fine when it is genuinely atomic. The question is
  whether the work item is the right unit of delivery, not whether it is big or
  small in absolute terms
- Rate confidence on sizing observations — whether a work item is "too small" or
  "too large" is often a judgement call that depends on team context

3. **Evaluate Decomposition Strategy for Epics**

- Confirm that an epic describes a coherent capability or theme that its child
  stories all serve — the children should be cohesive, not a grab-bag of
  unrelated tasks lumped under one label
- Flag incoherent decompositions where child stories are unrelated to each
  other or to the parent theme, or where the epic's scope spans multiple
  unrelated capabilities
- Flag over-decomposition where the total scope described is so small that a
  single story would be the natural delivery unit — an epic of twelve one-line
  chores is not an epic in any meaningful sense
- Flag under-decomposition where the epic's stated scope is so broad that its
  children, if listed, would span many sprints across multiple capabilities

4. **Assess Time-box and Bounding for Spikes**

- Confirm that a spike defines a specific, bounded research question rather
  than an open-ended exploration of a domain
- Flag unbounded spike questions such as "understand our architecture" or
  "investigate X" that have no natural stopping point and cannot produce a
  specific decision or deliverable within a time-box
- Distinguish between scope (the research question is too broad to bound) and
  testability (the exit criteria are present but not measurable) — both may
  apply to the same spike for different reasons, but scope flags the question
  itself; testability flags the exit criteria

## Key Evaluation Questions

**Sizing and bundling** (always applicable):

- **Coherence**: Do all requirements serve a single unified purpose, or does
  the work item describe work that could be delivered as two or more independent
  work items? (Watch for: "and also", "additionally", "as well as" in the
  Requirements; Summary naming two capabilities.)
- **Service boundaries**: Does the work item assign work across multiple service
  boundaries or team ownership domains? (Watch for: Requirements listing
  actions to be performed by three different services with no owning team
  identified, no orchestration work item referenced.)
- **Sizing fit**: Is the declared work item kind appropriate for the scope of the
  work described? (Watch for: a "story" for a one-line rename; a "story" for a
  multi-week infrastructure overhaul that warrants an epic.)

**Kind-specific sizing** (based on work item kind):

- **Story**: Does the story describe a single increment of user-visible or
  system value that a single team can own end-to-end? (Watch for: stories that
  include a feature and a large unrelated refactor; stories that require
  coordinated delivery across multiple bounded contexts.)
- **Epic**: Do the child stories or decomposition strategy all serve the same
  user-visible capability? Are there the right number of children — neither a
  single story that should just be a story, nor dozens of micro-tasks? (Watch
  for: epic children with no relationship to each other; an epic with only one
  or two children that are themselves trivially small.)
- **Spike**: Is the research question specific and bounded — does it name
  exactly what is being decided and what constraints bound the exploration?
  (Watch for: "explore X", "understand Y", "investigate Z" with no defined
  decision point or time-box.)

## Important Guidelines

- **Do not read source code or run codebase exploration agents** — work item
  content is the sole artefact under review; do not make inferences about the
  codebase that the work item does not state
- **Rate confidence** on each finding — whether a work item is too big, too small,
  or bundling independent concerns is often a judgement call; use confidence
  levels honestly (high for structural evidence like multiple service names in
  Requirements, medium for interpretation-dependent calls)
- **Be proportional** — a slight scope drift or minor bundling is not a major
  finding; reserve major and critical severity for cases where the scope
  problem would cause meaningful delivery risk (e.g., two unrelated
  multi-sprint efforts merged into one story, or a spike with no research
  question at all). A well-scoped, atomic work item whose declared kind is
  slightly wrong (a chore filed as a story; a task filed as a chore) does
  not cause delivery risk — that is a housekeeping mislabel, not a scope
  problem. Flag it at `minor` or `suggestion` severity with `medium`
  confidence, since what is "chore-like" vs "story-like" depends on team
  norms the reviewer cannot observe
- **Distinguish scope from content quality** — the scope lens asks whether the
  work item is the right unit of work; it does not evaluate whether the
  requirements are well-written, measurable, or complete. Defer those
  assessments to the appropriate sibling lenses

## What NOT to Do

- Don't evaluate whether sections exist or are populated — that is the
  completeness lens; an absent Dependencies section is a completeness concern,
  not a scope concern
- Don't evaluate whether Acceptance Criteria are measurable or verifiable —
  that is the testability lens; a spike's exit criteria being unmeasurable is a
  testability finding, not a scope finding, unless the underlying research
  question is itself unbounded (both findings can apply to the same work item for
  different reasons)
- Don't flag ambiguous language, unclear referents, or jargon — that is the
  clarity lens
- Don't evaluate whether implied dependencies are captured — that is the
  dependency lens; scope flags whether a work item spans multiple service
  boundaries as a unit-of-work concern, not whether the cross-service
  interactions are explicitly listed
- Don't read source code, run codebase exploration agents, or make inferences
  about the implementation beyond what the work item explicitly states
- Don't penalise a well-scoped work item for being small — atomicity is a virtue;
  only flag size when the declared kind is inappropriate or when the scope is
  so trivially small that it suggests the work item was broken out of a larger
  effort and has no standalone value

Remember: You're evaluating whether this work item represents one coherent,
appropriately sized unit of work that a team can plan, deliver, and verify as
a single increment. A well-scoped work item has clear boundaries — you can state
what is in scope and what is not, and the team can deliver it without depending
on simultaneous completion of a separate, parallel thread of work.

