Files
016-pretty-table/.agents/skills/artifact/references/RC.md
T
Tirsvad b0a7414204 Add Pretty Table project: plan, accepted documents and code
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
2026-10-07 12:02:59 +08:00

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 for RC).
  • 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, or delta re-review with the criteria covered, the reason and the earlier record), the artifact's language and domain (its Language and Domain rows, n/a for a technical type) and the language reviewer (a stakeholder ID, or none).
  • 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-A is not allowed for criteria 3, 5 and 9.
  • Overall Verdict — Go / Go-with-conditions / No-Go, with rationale.
  • Action Items — Action | Owner | Due. Owner is a stakeholder ID from the project's Stakeholder Analysis, never a role name. Every Fail and 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 History row to Accepted and the row before it to Deprecated (Approved is not a status). On Go-with-conditions the status stays Proposed until the action items are closed. If the change is refused for good, set the row to Rejected (the earlier Accepted row stays).
  • Step-by-step narrative: framework/process/review-checklist-process.md.