adding diagrams and render script (#11)

* adding diagrams and render script

* breaking out stores

Author: gwillish

CLAUDE.md

@@ -11,18 +11,27 @@ Two targets: `DHModels` (Linux-safe value types) and `DHKit`
 ```
 DHModels/
 ├── Sources/
-│   ├── DHModels/      # Foundation-only; no Apple-only frameworks
+│   ├── DHModels/
+│   │   └── DaggerheartModels.docc/
+│   │       └── Resources/      # SVG diagrams (generated by Scripts/render-diagrams.sh)
 │   ├── DHKit/
+│   │   ├── DHKit.docc/
+│   │   │   └── Resources/      # SVG diagrams (generated by Scripts/render-diagrams.sh)
 │   │   └── Resources/          # adversaries.json, environments.json (SRD data)
 │   └── validate-dhpack/
 ├── Tests/
 │   ├── DHModelsTests/ # Linux-compatible; runs in Linux CI
 │   │   └── Fixtures/           # adversaries.json, environments.json, sample-homebrew.dhpack
 │   └── DHKitTests/    # Apple-platform only
+├── diagrams/
+│   ├── DHModels/               # catalog.mmd, encounter.mmd, content.mmd
+│   └── DHKit/                  # participants.mmd, stores.mmd, usage.mmd
 ├── schemas/                    # dhpack.schema.json (JSON Schema for .dhpack files)
 ├── Package.swift
 ├── .swift-format               # Formatting rules (matches gwillish/encounter)
-└── Scripts/format.sh           # Format all tracked Swift files
+└── Scripts/
+    ├── format.sh               # Format all tracked Swift files
+    └── render-diagrams.sh      # Render .mmd sources to SVG
 ```
 
 ---
@@ -159,6 +168,23 @@ declaration to opt out of the default `@MainActor` isolation.
 
 ---
 
+## Diagrams
+
+Source files live in `diagrams/DHModels/*.mmd` and `diagrams/DHKit/*.mmd`.
+
+**Whenever a diagram source is added or modified, re-run the render script** to
+keep the DocC Resources in sync:
+
+```bash
+./Scripts/render-diagrams.sh
+```
+
+Output goes to `Sources/DHModels/DaggerheartModels.docc/Resources/` and
+`Sources/DHKit/DHKit.docc/Resources/`.
+Commit the generated SVGs alongside the source `.mmd` files.
+
+---
+
 ## Git
 
 - **Never commit on behalf of the user.** Wait for an explicit request.