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
+25
View File
@@ -0,0 +1,25 @@
# Architecture Decision Record (ADR)
Files: `docs/adr/adr-NNNN-kebab-case-title.md`. `NNNN` is 4-digit and
sequential; the ID is `ADR-NNNN` and must match the filename number (an
intentional exception to the usual 3-digit IDs). Use
`new-artifact.sh ADR --file docs/adr/adr-NNNN-title.md`.
Cite in `CrossReference` the artifacts this decision is about (pass each
with `--cite <ID>=<path>`); ADR has no fixed candidate list.
## Required sections (after Metadata / Version History)
- **Context** — the problem, the options evaluated and the forces
(cost, risk, constraints).
- **Decision** — the outcome in one or two sentences, no hedging.
- **Consequences** — two bold labels, **Positive:** and **Negative:**, each
with a bullet list.
- **Affected Artifacts** — other artifacts impacted, as `[ID]` links, or a
single `-` if none.
Allowed statuses: `Proposed`, `Accepted`, `Rejected`, `Deprecated`,
`Superseded by ADR-NNNN`; no others (an ADR is never `Approved`). Status
changes (`Proposed` → `Accepted` → `Deprecated` / `Superseded by ADR-NNNN`, or
`Proposed` → `Rejected`) are new rows in `## Version History` (only the two
latest are kept; earlier ones stay in git); never rewrite a retained row.