docs: flag monorepo migration; mirror is not a dev target

AGENTS.md

@@ -1,5 +1,12 @@
 # CodeZero — Agent Operating Guide
 
+> **MONOREPO MIGRATION — READ FIRST.** This is the public mirror of `CodeZero`;
+> both are being consolidated into the `platform` monorepo
+> (`OpZero-sh/platform`). Do NOT develop here — land new work in
+> `platform/mcps/code` (+ `packages/{transport,channel,hub-client,ui}`). See the
+> banner in `CLAUDE.md` and `platform/context/migration-status.md` for the full
+> status.
+
 This file is the operating manual for any agent (subagent, orchestrator, or future-Claude-session)
 working in this codebase. It supplements `CLAUDE.md` (architecture) and `Roadmap.md`
 (current priorities). Read this before starting any task.

CLAUDE.md

@@ -1,5 +1,24 @@
 # CodeZero — Project Guide
 
+> ## MONOREPO MIGRATION — READ FIRST
+>
+> **This is the public mirror / build output of the private `CodeZero` repo, and
+> both are being consolidated into the `platform` monorepo
+> (`OpZero-sh/platform`). Do NOT develop here.**
+>
+> Canonical development target: **`platform/mcps/code`** (`@opzero/code`), with
+> shared code in **`packages/{transport,channel,hub-client,ui}`**. The private
+> `OpZero-sh/CodeZero` repo is the upstream this mirror is generated from.
+>
+> The monorepo build is green (`npx turbo typecheck` + `build`) and is the
+> source of truth going forward. Fixes made only in a mirror or standalone repo
+> drift out of sync and have to be hand-ported. Don't create that work — land
+> changes in `platform`.
+>
+> Full status, deferred items, and open questions:
+> **`platform/context/migration-status.md`** (source-of-truth for `mcps/code` is
+> open question #5). This repo is archived once prod cutover and publish land.
+
 Product name: **CodeZero**. Package / repo / on-disk name: `opzero-claude`
 (unchanged to avoid breaking things — only the UI-visible brand changes).
 

ROADMAP.md

@@ -1,7 +1,17 @@
 # CodeZero Roadmap
 
-**CodeZero is the source.** This private repo (package `opzero-code`, on-disk
-config `~/.config/opzero-claude/`) is where development happens and what runs on
+> **MONOREPO MIGRATION — READ FIRST.** New development happens in the `platform`
+> monorepo (`OpZero-sh/platform`), not here — canonical target
+> `platform/mcps/code` (`@opzero/code`) plus shared
+> `packages/{transport,channel,hub-client,ui}`. See the banner in `CLAUDE.md` and
+> `platform/context/migration-status.md`. Whether the private `CodeZero` repo
+> remains a canonical export source or the monorepo fully owns `mcps/code` is open
+> question #5 there; until it is resolved, land new work in `platform`. The
+> description below is retained for architectural context.
+
+This private repo (package `opzero-code`, on-disk
+config `~/.config/opzero-claude/`) is the historical source of the CodeZero
+service and what runs on
 a machine: the Bun HTTP server + React 19 SPA that drives Claude Code sessions,
 the local agent that registers the machine with `codez-hub`, and the remote MCP
 surface (`/mcp` and `packages/codezero-mcp/`) that lets any client drive those