RepoFoundry/docs/sqa/reviews/rc-025-dm-003.md

SQA Review Record: DM-003 Start the script as a global command, and the dictionary

Metadata

Key	Value
ID	RC-025
CrossReference	DM-003, QC-DM-001, QC-DICT-001, DICT-001, DM-002

Version History

Date	Status	Author	Reviewer	Change	Commit
2026-10-07	Accepted	Jens Tirsvad Nielsen	S02	Initial version	1cd27f7

---

Artifact Under Review

• Instance reviewed: DM-003, and the changes it causes in DM-002 and DICT-001.
• Checklists used: QC-DM-001 for DM-003; QC-DICT-001 for DICT-001.
• Review date: 2026-10-07

Checklist Results (QC-DM-001)

#	Criterion	Status	Evidence/Notes
1	Uses ubiquitous/business language throughout; no technical or implementation jargon (e.g. no "table", "class", "pointer")	Pass	Command Link, Checkout and Working Folder are Maintainer terms. "Checkout" is also a git word; it is kept because it names the folder the Maintainer cloned.
2	Multiplicities on associations are correct and complete (e.g. 1..*, 0..1)	Pass	Every association has a multiplicity on both ends.
3	No operation/method signatures shown — attributes and associations only	Pass	Attributes and associations only.
4	Associations are named with an unambiguous reading direction	Pass	Every association has a reading direction in the table.
5	Generalization/specialization used correctly, reflecting true "is-a" relationships, not misused for code reuse	N-A	No generalization.
6	Every concept traces to a noun phrase found in the use cases or glossary	Pass	Each new concept cites its use case step. The concepts Maintainer, Configuration and Local Project come from DM-001 and are stated as not redefined.
7	Attributes are simple domain data (no foreign-key-like references or object pointers modeled as attributes)	Pass	folder and path are simple data; the links to other concepts are associations.

Checklist Results (QC-DICT-001)

#	Criterion	Status	Evidence/Notes
1	Every row has a PO term, its language, an IT term and a definition	Pass	Three new rows, each with PO term, language, IT term and definition.
2	Each PO term maps to exactly one IT term and the reverse (no synonyms)	Pass	One IT term per PO term and the reverse: Command Link / CommandLink, Checkout / Checkout, Working Folder / WorkingFolder.
3	Every Domain Model concept has a row, and the Domain Model uses its PO term	Pass	Every concept of DM-003 and of DM-002 has a row.
4	The Operation Contracts, Sequence Diagrams, Design Class Diagrams and ERD use the IT term, not the PO term	Pass	OC-002, SD-002 and DCD-003 use the IT terms. CommandLink appears in OC-002 only: it is a link the Maintainer makes, so it has no design class, which the DCD and the dictionary say.
5	Definitions are written in the PO language and are one sentence	Pass	One-sentence definitions in English, the PO language.
6	"Used as PO term in" and "Used as IT term in" name artifact types that exist in the project	Pass	Names DM, UC, OC, SD and DCD, which exist.
7	Translated artifacts (<artifact>.<language>.md) use the PO terms of the dictionary	N-A	The PO language is English.

Change checks on the other artifacts

Artifact	Change	Status	Evidence/Notes
DM-002	Three concepts and five associations added	Pass	Diagram, concept table and association table changed in the same way as DM-003; Purpose names UC-002.

Overall Verdict

Go — DM-003 and the dictionary meet every mandatory criterion. Drafted by Claude Code for S02 against the checklist; the author and reviewer are the same person for now (as in the earlier records). S02 confirmed the verdict on 2026-10-07 and the Version History rows of the reviewed documents were set to Accepted.

Action Items

Action	Owner	Due
None	-	-

---