Context
A review of the Acai/specsmaxxing discussion concluded that dev-backlog should not copy task-level acceptance criteria into durable spec/* artifacts. Task AC and frozen Done Criteria belong to GitHub/task files and dev-relay; spec-* owns durable project/system/capability contracts.
The current design mostly has this split, but the boundary is clearer in deep design docs than in the user-facing spec index and generated templates.
Desired change
Clarify the source-of-truth boundary in the small docs users and agents read first.
Suggested touchpoints:
spec/README.md
docs/spec-system-design.md
skills/spec-grill/templates/capabilities.md
skills/dev-backlog/references/integration-contract.md
Acceptance Criteria
Context
A review of the Acai/specsmaxxing discussion concluded that dev-backlog should not copy task-level acceptance criteria into durable
spec/*artifacts. Task AC and frozen Done Criteria belong to GitHub/task files and dev-relay;spec-*owns durable project/system/capability contracts.The current design mostly has this split, but the boundary is clearer in deep design docs than in the user-facing spec index and generated templates.
Desired change
Clarify the source-of-truth boundary in the small docs users and agents read first.
Suggested touchpoints:
spec/README.mddocs/spec-system-design.mdskills/spec-grill/templates/capabilities.mdskills/dev-backlog/references/integration-contract.mdAcceptance Criteria
spec/README.mdstates that task AC stays in GitHub/task files, sprint execution context stays inbacklog/sprints, and relay Done Criteria/rubrics/review stay in dev-relay.spec/capabilities.mdtemplate states that issue-specific AC, rubrics, and review notes do not live in capability specs.docs/spec-system-design.mdrecords the rule: spec-* may read task AC as evidence, but must not copy task AC/Done Criteria into durable specs.integration-contract.mddistinguishes task-file AC as mirror/local progress from relay run frozen Done Criteria as the review anchor.