Skip to content

docs: flag monorepo migration in CLAUDE.md #11

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jcameronjeff merged 1 commit into from
Jul 5, 2026
+24 −0
Merged

docs: flag monorepo migration in CLAUDE.md #11

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,29 @@
# CLAUDE.md — MCP AuthKit (Cloudflare)

> ## MONOREPO MIGRATION — READ FIRST
>
> **This repo is being consolidated into the `platform` monorepo
> (`OpZero-sh/platform`). Do NEW development there, not here.**
>
> | This repo | Canonical location in `platform` |
> |-----------|----------------------------------|
> | `src/` (OAuth Worker) | **`mcps/auth`** (`@opzero/auth`) |
> | SHA-256 / token validation / scopes | **`packages/auth-core`** (shared) |
>
> The monorepo build is green (`npx turbo typecheck` + `build`) and is the
> source of truth going forward. Changes made only in this repo drift out of
> sync — every fix then has to be hand-ported into `platform` (see that repo's
> `fix(auth): port …` commit history). Don't create that work.
>
> The **only** reason to touch this repo is an emergency production hotfix for a
> service not yet cut over. If you must, port the same change into
> `platform/mcps/auth` (or `packages/auth-core`) in the same session.
>
> Full status, deferred items, and open questions:
> **`platform/context/migration-status.md`**. This repo is archived once prod
> cutover, publish, and CI-secret setup land. (The `mcp-authkit-vercel`
> Vercel/Turso variant stays a separate repo — it is not part of this migration.)

## What this repo is

OAuth 2.1 gateway for MCP servers, deployed on Cloudflare Workers with D1 (SQLite) as the database. This is the Cloudflare-hosted variant — the Vercel variant lives in `mcp-authkit-vercel`.
Expand Down
Loading