diff --git a/apps/docs/content/docs/development.mdx b/apps/docs/content/docs/development.mdx
index 085df5f99..634d4031d 100644
--- a/apps/docs/content/docs/development.mdx
+++ b/apps/docs/content/docs/development.mdx
@@ -8,6 +8,8 @@ or the documentation site. For using a deployment, start with the
 [getting started guide](/). Read the
 [contributor rules](https://github.com/MiniMax-AI/parsar-core/blob/f6d258735fc601c521dd990e6f9e1ed261f4ef2d/CONTRIBUTING.md) before changing code.
 
+![OpenAgentCore architecture: applications and the Web console connect to Core through separate APIs; Sandbox Providers, Runtime, Harnesses and model providers connect through shared protocols.](/images/source/docs/assets/development-architecture.png)
+
 ## Set up a checkout
 
 Work from an isolated worktree so experiments and validation do not disturb
diff --git a/apps/docs/content/guide-sources.json b/apps/docs/content/guide-sources.json
index 77515784f..37c2b7213 100644
--- a/apps/docs/content/guide-sources.json
+++ b/apps/docs/content/guide-sources.json
@@ -23,7 +23,8 @@
     "contracts/agents-api/runtime-observability-api.md": "cd46e777fe716a7e76374f4655c96dfbad9d8be1bfca6203ed6118ab87874c2b",
     "docs/getting-started/operations.md": "f5c0942003373aaf604fc0f5bb88e0d022f465f1ade2db2192975a173efe7d95",
     "docs/user-guide.md": "1069d0f12aa42dde49693f25e8d964984e1c335fc67527123d31ee6a99617bab",
-    "docs/development.md": "3e03e2666c92380d207ab53285e3b85fdcb042481c8ca76219ed08d629d52812",
+    "docs/assets/development-architecture.png": "24e6d0145d4f16ad70b07b6bc643808a6455aaf6398434d199cf74def200fca6",
+    "docs/development.md": "f440c7cdafcf85267738ada65e0f87fefa441687df24d64d4970a35f5d7768df",
     "contracts/agents-api/harness-onboarding.md": "5517210e50e6820b2711bd66b1e5507228d0754acd661c187d89a4017a1ac0a5",
     "docs/runtime-protocol.md": "6baa332705743e34b8565613d743d1b30099d8af78159b06ad921ffa7e164a9f",
     "docs/sandbox-provider.md": "dd8c2c2b2e2acf4d6ae564f56ffaf5685d74a84fa7a7a15b4cad851015ee36ab",
@@ -52,7 +53,8 @@
     "content/docs/observability.mdx": "c81214e1865517a9163c48c7ce7c396f5490c9d162080dfa05fa5ebc147f6c8b",
     "content/docs/troubleshooting.mdx": "f0291b91254a704cb7d490f5205306b229f194bd620f6b050c90c9b3cea8f8c6",
     "content/docs/user-guide.mdx": "4f7d57c7199513c2947a2f01b163b5e12c474553b9a2aafcf857bbf51def091a",
-    "content/docs/development.mdx": "3d10a88c12be4a680d91a1b0afb0d56517ce50c12ded8431e350ba917f62ba7a",
+    "public/images/source/docs/assets/development-architecture.png": "24e6d0145d4f16ad70b07b6bc643808a6455aaf6398434d199cf74def200fca6",
+    "content/docs/development.mdx": "d72357c96b003ecbd14d48920be1211bd15d9aba3e3b1545c64da0b11d7a2602",
     "content/docs/harness-onboarding.mdx": "d3a8f0e39b129d3eb147ed560811b4fd56a65f01606d0d9a80d93c7ffade1157",
     "content/docs/runtime-protocol.mdx": "a6a63eb1dd0c54f2bd6f406721194e744f76c25585f7db57b28d43f545a8e51b",
     "content/docs/sandbox-provider.mdx": "fdf993bdcf00050cdba1d513c45e9e9159ff02f18f9f248000c1e1b9ba2de08f"
diff --git a/apps/docs/public/images/source/docs/assets/development-architecture.png b/apps/docs/public/images/source/docs/assets/development-architecture.png
new file mode 100644
index 000000000..c5442401b
Binary files /dev/null and b/apps/docs/public/images/source/docs/assets/development-architecture.png differ
diff --git a/docs/assets/development-architecture.png b/docs/assets/development-architecture.png
new file mode 100644
index 000000000..c5442401b
Binary files /dev/null and b/docs/assets/development-architecture.png differ
diff --git a/docs/development.md b/docs/development.md
index 18f1d81ac..4ad9fb26f 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -5,6 +5,8 @@ or the documentation site. For using a deployment, start with the
 [getting started guide](getting-started/README.md). Read the
 [contributor rules](../CONTRIBUTING.md) before changing code.
 
+![OpenAgentCore architecture: applications and the Web console connect to Core through separate APIs; Sandbox Providers, Runtime, Harnesses and model providers connect through shared protocols.](assets/development-architecture.png)
+
 ## Set up a checkout
 
 Work from an isolated worktree so experiments and validation do not disturb
diff --git a/scripts/core-distribution-manifest.py b/scripts/core-distribution-manifest.py
index 43ab4498a..8377cb6ce 100644
--- a/scripts/core-distribution-manifest.py
+++ b/scripts/core-distribution-manifest.py
@@ -50,7 +50,11 @@
     "contracts/agents-api/environment-executor-credentials.md",
 )
 # Files the bundled docs show, copied as they are, so they work offline.
-BUNDLED_FILES = ("docs/assets/openagentcore-banner.jpeg", "docs/assets/architecture.png")
+BUNDLED_FILES = (
+    "docs/assets/openagentcore-banner.jpeg",
+    "docs/assets/architecture.png",
+    "docs/assets/development-architecture.png",
+)
 REPOSITORY_URL = "https://github.com/MiniMax-AI/parsar-core"
 MARKDOWN_LINK = re.compile(r"(!?)\[((?:[^\[\]]|\[[^\]]*\])*)\]\(([^)\s]+)((?:\s+\"[^\"]*\")?)\)")
 FENCE = re.compile(r" {0,3}(`{3,}|~{3,})")