Business Case, Stakeholder Analysis, Project Plan and milestone MIL-001 with review records RC-001 to RC-003, then the Python project: PrettyTable Pokemon table, constants, pytest tests, pyproject.toml, Doxyfile, CI workflow and README. Task: MIL-001#1 Task: MIL-001#2 Task: MIL-001#3 Task: MIL-001#4 Task: MIL-001#5 Task: MIL-001#6 Task: MIL-001#7 Task: MIL-001#8
2.5 KiB
2.5 KiB
SQA Review Record (RC)
One record per review of a specific artifact instance against its QC checklist. Create one for every artifact instance in the project.
- File:
docs/sqa/reviews/rc-<NNN>-<instance-slug>.md - ID:
RC-NNN, sequential across all artifact types (the registry's Next Available Version forRC). - Create:
new-artifact.sh RC --file docs/sqa/reviews/rc-NNN-<slug>.md --cite <INSTANCE-ID>=<instance path> --cite QC-<SHORT>-001=framework/qc/<checklist>.md
Required sections (after Metadata / Version History)
- Artifact Under Review — links to the instance and to the QC checklist
used, the scope (
full review, ordelta re-reviewwith the criteria covered, the reason and the earlier record), the artifact's language and domain (itsLanguageandDomainrows,n/afor a technical type) and the language reviewer (a stakeholder ID, ornone). - Checklist Results —
# | Criterion | Status (Pass/Fail/N-A) | Evidence/Notes, one row per criterion copied from the QC checklist, in the same order. - Language and Domain Results — only for an artifact of a type written in
the PO language: the rows of
QC-LANG-001, same columns and order.N-Ais not allowed for criteria 3, 5 and 9. - Overall Verdict — Go / Go-with-conditions / No-Go, with rationale.
- Action Items —
Action | Owner | Due.Owneris a stakeholder ID from the project's Stakeholder Analysis, never a role name. EveryFailand every condition gets an item.
After the review
- The reviewer must not be the artifact's author (see governance). For a
PO-language artifact the reviewer must read its language and know its
domain, or a second reviewer, the language reviewer, does and is named on
the record; see
process/review-checklist-process.md. - The record is in English. Quote evidence that is the artifact's own wording in its language, with a short gloss.
- Add or update the instance's row in the Traceability Matrix, including
this
RC-*in "Last Reviewed". - On Go, set the reviewed artifact's latest
## Version Historyrow toAcceptedand the row before it toDeprecated(Approvedis not a status). On Go-with-conditions the status staysProposeduntil the action items are closed. If the change is refused for good, set the row toRejected(the earlierAcceptedrow stays). - Step-by-step narrative:
framework/process/review-checklist-process.md.