T-N0HI-task-ac-scope-matches-files-to-touch
Status: closed/superseded · Impact: medium · Complexity: small
When a task’s acceptance criteria grep or assert over a wider file scope than
the task’s ## Files to touch table enumerates, the mismatch can hide real
work: an AC catches a violation in a directory the spec never claimed to touch.
The task-readiness surface should reconcile an AC’s scope against Files-to-touch
— or require that a deliberately wider AC scope be noted explicitly — so the two
halves of the spec agree.
AC-2’s grep scope (
apps,sites) reached beyond the task’s stated## Files to touch, surfacing a real out-of-scope suppression in a Storybook config the task assumed absent — task specs whose ACs grep a wider scope than their Files-to-touch table should reconcile the two, or note the wider scope explicitly.—
T-JGCX-biome-noexplicitany-source-fixpost-mortem, ingit@github.com:sksizer/markdown-contract.git
TBD — receiver to fill before promoting from planning/draft.
The implementation-ready contract and the task-define / task-ensure-ready path verify Files-to-touch rows against the codebase, but nothing reconciles the scope an AC reaches (globs/paths named in AC text) against that table; a wider AC scope passes unremarked.
Proposed
Section titled “Proposed”TBD — receiver to fill before promoting from planning/draft.
Approach
Section titled “Approach”TBD — receiver to fill before promoting from planning/draft.
Files to touch
Section titled “Files to touch”TBD — receiver to fill before promoting from planning/draft.
Acceptance criteria
Section titled “Acceptance criteria”TBD — receiver to fill before promoting from planning/draft.
Out of scope
Section titled “Out of scope”- none
Dependencies
Section titled “Dependencies”- none
Discovery context
Section titled “Discovery context”Spawned by /sdlc:spawn-task-pr on 2026-07-04 UTC from
T-JGCX-biome-noexplicitany-source-fix in
git@github.com:sksizer/markdown-contract.git.