Files
018-hirst-painting/.agents/skills/artifact/references/US.md
T
Tirsvad 7c0ed0dcc5 Add the SQA and QC framework and project instructions
Mount the framework as a submodule at framework/ (v0.4.0), add AGENTS.md and
the installed skill copies for Codex CLI (.agents/skills) and Claude Code
(.claude/skills).
2026-10-07 23:49:15 +08:00

1.1 KiB

User Story (US)

Cite in CrossReference only if the instance exists (new-artifact.sh checks this for you):

  • UCD — The story's role must match an actor defined here
  • UC — The use case each story traces to
  • BC — Objective / epic the story ultimately supports
  • MIL — The gateway (epic) each story delivers — one or more stories per gateway

Required sections (after Metadata / Version History)

  1. Purpose and Scope — the epic(s) covered.
  2. Story List — each story with a stable ID US-<doc-version>.<NN> (e.g. US-001.01, so it cannot be confused with the document ID US-001):
    • Statement: As a <actor>, I want <goal>, so that <benefit> — one goal per story, no implementation detail.
    • Acceptance Criteria — clear and testable (Given/When/Then works).
    • Traces to — the use case (UC-…) or epic it comes from; a gateway (MIL-…) is an epic.
    • Size — fits a single iteration.
  3. INVEST Check — one line confirming Independent, Negotiable, Valuable, Estimable, Small, Testable (flag any exception with reason).