diff --git a/AirPlan/docs/architecture/system-detailed-design.md b/AirPlan/docs/architecture/system-detailed-design.md
index be6e492..5377711 100644
--- a/AirPlan/docs/architecture/system-detailed-design.md
+++ b/AirPlan/docs/architecture/system-detailed-design.md
@@ -2369,6 +2369,12 @@ invariants.
 - `npm-dep` — consume directly as a dependency; do not re-implement.
 - `fork/adapt` — copy and adapt source into our package; keep our own boundaries.
 - `pattern` — reference structure/patterns; implement independently.
+
+**Reference source location:** local reference checkouts live at `<repo-root>/reference/<name>-<version>/`
+where `<repo-root>` is the git root (`AirCoding/`, the parent of `AirPlan/`). This `reference/`
+tree is **not committed** (working-copy only). Implementers (including isolated subagents) must
+verify the referenced checkout exists and is non-empty before relying on it; if absent, clone the
+upstream repo to that path. Paths in the table below are relative to `<repo-root>`.
 - `behavioral` — match observable behavior/quality; no code lineage.
 
 | DD component | Reference project (baselineV1 §2) | Reuse mode | Notes / local path |
@@ -2378,9 +2384,9 @@ invariants.
 | §12 Provider (`ProviderManager`, `ProviderAdapter`, converters) | `@opencode-ai/llm` | `fork/adapt` | D-002 list: provider/model abstraction may be forked/adapted; output stays Anthropic-canonical (D-046). |
 | §8.4 + §9.4 Execution discipline (read-before-edit, exact edit, verify-before-complete) | Claude Code CLI | `behavioral` | baselineV1 §2: quality benchmark only — edit safety, patch granularity, conflict handling, verification discipline. No code lineage. |
 | §9.4 `fs.edit`/`fs.patch` + §15 patch/test execution loop | OpenAI Codex (`reference/openai-codex/`) | `pattern` | baselineV1 §2: shell/patch/test direct-execution loop, tool orchestration, wider tool surface. |
-| §11.3 + §14 Knowledge / ExperienceMiner / Curator | Hermes Agent | `pattern` | D-024: Nudge Engine interval trigger (~10 turns/tool-calls), Curator dedup daemon, skill self-patch. |
+| §11.3 + §14 Knowledge / ExperienceMiner / Curator | Hermes Agent (`reference/hermes-agent-<version>/`) | `pattern` | D-024: Nudge Engine interval trigger (~10 turns/tool-calls), Curator dedup daemon, skill self-patch. |
 | §11.3 + runtime-semantics §11 Skills (`SKILL.md`, `scripts/`/`references/`/`assets/`) | Anthropic Claude Skills (`reference/anthropic-skills/`) | `pattern` | D-058: SKILL.md frontmatter + directory layout + trigger/retrieval descriptions; SkillGenerator output format. |
-| §16.2 Logging / HUD + future PTY capture | asciinema / Atuin / claude-hud | `pattern` | baselineV1 §2: PTY capture, command metadata/history indexing, HUD/statusline layout. |
+| §16.2 Logging / HUD + future PTY capture | asciinema / Atuin / claude-hud (`reference/asciinema-<v>/`, `reference/atuin-<v>/`, `reference/claude-hud-<v>/`) | `pattern` | baselineV1 §2: PTY capture, command metadata/history indexing, HUD/statusline layout. |
 | §3 Message format (Anthropic canonical content blocks) | Claude Code message model | `behavioral` | D-016: Text/Thinking/ToolUse/ToolResult blocks; canonical internal format. |
 
 **Rules for reference reuse:**