From f13e9baa2295b5d75597b930c7347fcee007511d Mon Sep 17 00:00:00 2001 From: Jeff Cameron Date: Sat, 4 Jul 2026 21:39:30 +0000 Subject: [PATCH 1/2] docs: flag monorepo migration; this mirror is not a dev target This public mirror kept being treated as a place to build. Add a read-first banner to CLAUDE.md and AGENTS.md directing new work to platform/mcps/code and pointing at platform/context/migration-status.md. Co-Authored-By: Claude Opus 4.8 --- AGENTS.md | 7 +++++++ CLAUDE.md | 19 +++++++++++++++++++ 2 files changed, 26 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index f23822e..0dea77f 100644 --- a/AGENTS.md +++ b/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. diff --git a/CLAUDE.md b/CLAUDE.md index 57fe991..d312e14 100644 --- a/CLAUDE.md +++ b/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). From 772489343c92d20fd0dbea08e110dfbdb03d3506 Mon Sep 17 00:00:00 2001 From: Jeff Cameron Date: Sat, 4 Jul 2026 21:50:13 +0000 Subject: [PATCH 2/2] docs: deprecate 'CodeZero is the source' roadmap header for platform Mirror the CodeZero roadmap fix: add a read-first migration note and reframe the description as historical/architectural context so repo docs no longer point agents back to a standalone repo. Co-Authored-By: Claude Opus 4.8 --- ROADMAP.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/ROADMAP.md b/ROADMAP.md index 0c89ab2..a42487e 100644 --- a/ROADMAP.md +++ b/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