diff --git a/.agents/skills/code-review.md b/.agents/skills/code-review.md
index ede42516..4dbbe321 100644
--- a/.agents/skills/code-review.md
+++ b/.agents/skills/code-review.md
@@ -103,6 +103,12 @@ If you cannot find source code to verify a documentation claim, explicitly flag
 This should be verified before merging.
 ```
 
+## Repository boundaries
+
+Verify that documentation changes belong in this repository rather than a source repository. `OpenHands/OpenHands` owns Agent Canvas, `OpenHands/software-agent-sdk` owns the SDK/Agent Server and canonical API, `OpenHands/typescript-client` owns typed browser API access, `OpenHands/automation` owns scheduling and dispatch, and `OpenHands/extensions` owns reusable skills, plugins, automations, and integrations.
+
+If a PR is opened in the wrong repository, explicitly recommend that it may need to be closed and moved to the repository that owns the change rather than merged here. Every PR must follow this repository's review guidance.
+
 ## Review Decisions
 
 You **must** use the correct GitHub review `event` value when submitting your review.
diff --git a/AGENTS.md b/AGENTS.md
index 8d30cf70..0c2f8592 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -26,6 +26,19 @@ The site is built with **Mintlify** and deployed automatically by Mintlify on pu
 - `.agents/skills/` — prompt extensions for agents editing this repo (legacy: `.openhands/skills/`; formerly `microagents`)
 - `tests/` — pytest checks for docs consistency (notably LLM pricing docs)
 
+## Cross-Repository Boundaries
+
+This repository owns the unified documentation site and documentation-specific tooling. The documented source repositories have distinct responsibilities:
+
+- [`OpenHands/OpenHands`](https://github.com/OpenHands/OpenHands) owns Agent Canvas UI and local-stack orchestration.
+- [`OpenHands/software-agent-sdk`](https://github.com/OpenHands/software-agent-sdk) owns the Python SDK, Agent Server, agent/tool behavior, conversations, workspaces, events, and canonical API.
+- [`OpenHands/typescript-client`](https://github.com/OpenHands/typescript-client) owns the browser-compatible typed Agent Server client.
+- [`OpenHands/automation`](https://github.com/OpenHands/automation) owns scheduling, webhooks, run history, dispatch, and sandbox lifecycle orchestration.
+- [`OpenHands/extensions`](https://github.com/OpenHands/extensions) owns reusable skills, plugins, automations, and integrations.
+
+Documentation should describe these boundaries accurately. If a documentation PR is opened in the wrong source repository, explicitly recommend closing and moving it to the repository that owns the change. PRs must follow this repository's applicable code-review guidance.
+
+
 
 ## llms.txt / llms-full.txt (V1-only)
 
diff --git a/README.md b/README.md
index a1a4ebf0..a0a25791 100644
--- a/README.md
+++ b/README.md
@@ -26,3 +26,9 @@ mint dev
 ## Deployment
 
 The documentation site is automatically deployed via Mintlify when changes are pushed to the main branch.
+
+## Repository boundaries
+
+This site documents a multi-repository OpenHands system. [`OpenHands/OpenHands`](https://github.com/OpenHands/OpenHands) owns Agent Canvas, [`OpenHands/software-agent-sdk`](https://github.com/OpenHands/software-agent-sdk) owns the Python SDK and Agent Server, [`OpenHands/typescript-client`](https://github.com/OpenHands/typescript-client) owns the browser client for the Agent Server API, [`OpenHands/automation`](https://github.com/OpenHands/automation) owns scheduling and dispatch, and [`OpenHands/extensions`](https://github.com/OpenHands/extensions) owns reusable skills, plugins, automations, and integrations.
+
+The usual API flow is SDK/Agent Server → OpenAPI contract → TypeScript client → Agent Canvas. Documentation should preserve these ownership boundaries; a PR opened in the wrong repository should be closed and moved to the repository that owns the change.