T-1Y4A-task-specs-cite-contract-and-client
Status: closed/superseded · Impact: medium · Complexity: small
When a task adds a new key to a contract-backed API endpoint, its ## Files to touch
table should name the contract schema and the generated client, because the typed-client
seam from T-JZL4-generate-dashboard-api-client makes the contract the source of truth
for any /api/state shape change. In T-UUMK the table omitted contract.ts and the client
regeneration, so both were edited mid-flight without being planned. The fix is a project
standard (or readiness-gate guidance) requiring Files-to-touch rows for the contract schema
plus the generated client whenever a task adds API surface to a contract-backed endpoint.
The
## Files to touchtable omittedcontract.tsand the client regeneration even though the T-JZL4 typed-client seam makes the contract the source of truth for any new/api/statekey — a task adding API surface to a contract-backed endpoint should require Files-to-touch rows for the contract schema + the generated client.
— T-UUMK-port-dashboard-four-source-view post-mortem
TBD — receiver to fill before promoting from planning/draft.
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”TBD — receiver to fill before promoting from planning/draft.
Dependencies
Section titled “Dependencies”TBD — receiver to fill before promoting from planning/draft.
Discovery context
Section titled “Discovery context”Spawned by /sdlc:spawn-from-post-mortem on 2026-06-28 (UTC) from
T-UUMK-port-dashboard-four-source-view in git@github.com:sksizer/dev.git.
Classification: Local. No-network sandbox: landed as a local task file on the originating
feature branch rather than its own PR.
Dedup search (spawn-from-post-mortem): SPAWNED. Top candidate T-JZL4-generate-dashboard-api-client (score 50, closed/done) is the typed-client seam itself, not a spec-authoring requirement — no existing task covers it.