tchughesiv · Aug 18, 2026 · Aug 17, 2026
diff --git a/.ai-bot/instructions.md b/.ai-bot/instructions.md
diff --git a/AGENTS.md b/AGENTS.md
@@ -135,7 +135,7 @@ workflow) at release time — not by a feature PR. What still needs an explicit
 - **New CRD types** in `osac-operator` → register in the `fulfillment-service` reconciler (an in-repo change, same PR)
 - **`osac-ui`** → a real external dependency (OCI chart + image, version-tagged), bumped deliberately when a new release is needed
 
-See `reference/CONVENTIONS.md` for the full dependency table (regenerated via the repo-intel tooling, not hand-edited).
+See `reference/CONVENTIONS.md` for the full dependency table (a hand-trimmed excerpt symlinked to `osac/docs/CONVENTIONS.md` — see that file's `README.md` for provenance).
 
 ## Enhancement Proposals
 

diff --git a/reference/ARCHITECTURE.md b/reference/ARCHITECTURE.md
diff --git a/reference/ARCHITECTURE.md b/reference/ARCHITECTURE.md
@@ -0,0 +1 @@
+../osac/docs/ARCHITECTURE.md