From 46e72230ec4f0dc7961490cdde3fefb1dfe0ff19 Mon Sep 17 00:00:00 2001
From: elizabethengelman <4752801+elizabethengelman@users.noreply.github.com>
Date: Mon, 24 Aug 2026 09:25:21 -0400
Subject: [PATCH] WIP: add diagram for installing policies with perch

---
 diagram.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 diagram.md

diff --git a/diagram.md b/diagram.md
new file mode 100644
index 00000000..99f37e0e
--- /dev/null
+++ b/diagram.md
@@ -0,0 +1,26 @@
+```mermaid
+  sequenceDiagram
+    title: Setup
+    actor D as Developer
+    participant CLI as CLI
+    participant C as PerchCompiler
+    participant MC as MyContract
+    participant I as PerchInterpreter
+    participant V as Verifier
+    participant S as Stellar Network
+
+
+    D->>CLI: Deploy MyContract
+    CLI->>S:
+
+    D->>D: Author Policy Document (json)
+    D->>CLI: Compile Policy Document to a Plan (a plan is a sequence of OZ policy rules)
+    CLI->>C: lower PolicyDoc to Plan (off-chain)
+    C-->>CLI: Plan = [per-rule: doc_hash + program, or stock-OZ-policy config]
+
+
+
+    D->>CLI: Install Policy Doc hash and Interpreter Contract Address onto MyContract
+    CLI->>MC:
+    MC->>S: MyContract installs each context rule in the plan on the interpreter contract
+```