From 2a48033f23f227e87164d61fe9d86adcb75d5677 Mon Sep 17 00:00:00 2001
From: mdheller <21163552+mdheller@users.noreply.github.com>
Date: Sat, 30 May 2026 19:53:51 -0400
Subject: [PATCH] Document SourceOS interaction reference flow pointer

---
 .../sourceos-interaction-reference-flow.md    | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 docs/integration/sourceos-interaction-reference-flow.md

diff --git a/docs/integration/sourceos-interaction-reference-flow.md b/docs/integration/sourceos-interaction-reference-flow.md
new file mode 100644
index 0000000..225474c
--- /dev/null
+++ b/docs/integration/sourceos-interaction-reference-flow.md
@@ -0,0 +1,28 @@
+# SourceOS Interaction Reference Flow
+
+Status: downstream reference pointer  
+Canonical packet: `SourceOS-Linux/sourceos-spec#118`  
+Canonical manifest: `examples/interaction-flow/noetica-superconscious-agentplane-agentterm.flow.json`
+
+## AgentPlane role
+
+AgentPlane records the evidence and replay references for the SourceOS interaction substrate.
+
+The canonical reference flow is:
+
+```text
+Noetica creates SourceOSInteractionEvent
+  -> Superconscious records task-boundary refs
+  -> AgentPlane records evidence refs
+  -> AgentTerm displays the governance trace
+```
+
+## Local references
+
+- Evidence binding doc: `docs/integration/sourceos-interaction-evidence-binding.md`
+- Evidence binding schema: `schemas/integration/sourceos-interaction-evidence-binding.v0.1.schema.json`
+- Evidence binding check: `python tools/validate_sourceos_interaction_evidence_binding.py`
+
+## Boundary
+
+AgentPlane owns evidence and replay references. The schema remains owned by `SourceOS-Linux/sourceos-spec`; task coordination, display surfaces, policy decisions, identity grants, and memory context remain in their respective planes.