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).
This commit is contained in:
2026-10-07 23:49:15 +08:00
parent 0d3f30355a
commit 7c0ed0dcc5
117 changed files with 5706 additions and 0 deletions
+22
View File
@@ -0,0 +1,22 @@
# 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).