Skip to content

docs(spec): clarify spec vs relay acceptance-criteria ownership #183

@sungjunlee

Description

@sungjunlee

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

  • spec/README.md states that task AC stays in GitHub/task files, sprint execution context stays in backlog/sprints, and relay Done Criteria/rubrics/review stay in dev-relay.
  • spec/capabilities.md template states that issue-specific AC, rubrics, and review notes do not live in capability specs.
  • docs/spec-system-design.md records the rule: spec-* may read task AC as evidence, but must not copy task AC/Done Criteria into durable specs.
  • integration-contract.md distinguishes task-file AC as mirror/local progress from relay run frozen Done Criteria as the review anchor.
  • No new ACID/feature.yaml/dashboard/cross-link matrix is introduced.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions