Files
018-hirst-painting/.agents/skills/artifact/references/SD.md
T
Tirsvad 7c0ed0dcc5 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).
2026-10-07 23:49:15 +08:00

1.2 KiB

Sequence Diagram (Design) (SD)

Cite in CrossReference only if the instance exists (new-artifact.sh checks this for you):

  • OC — Required source: the contract whose postconditions each diagram realizes
  • DCD — Forward: classes/methods these messages become

Required sections (after Metadata / Version History)

One block per realized Operation Contract:

  1. Realizes — the contract ([OC-…]) and its operation name.
  2. Diagram — PlantUML sequence diagram: sync (solid filled arrow), async (open arrow), returns (dashed); activations matching the call nesting; create / destroy shown for transient objects; loop / alt / opt fragments for conditional/repeated behavior.
  3. Pattern Annotations — table Pattern (GRASP/GoF) | Applied to | Rationale. Patterns are labelled, never implicit.
  4. Postcondition Coverage — Postcondition | Satisfied by message; every postcondition of the contract must be covered.
  5. Responsibility Check — a short note showing no god-object receives all messages (low coupling, high cohesion).

Terminology

Use the IT terms from the dictionary (DICT), not the PO terms the Domain Model uses.