diff --git a/CLAUDE_GPT_COORDINATION.md b/CLAUDE_GPT_COORDINATION.md deleted file mode 100644 index 78d0370..0000000 --- a/CLAUDE_GPT_COORDINATION.md +++ /dev/null @@ -1,140 +0,0 @@ -# Claude ↔ GPT Coordination Guide - -**For GPT (Ceàrd) to read when context feels stale or unclear.** - -Last Updated: April 10, 2026 - ---- - -## The Role Split - -| AI | Repo | What it owns | -|----|------|--------------| -| Claude | `jester/knowledge-base` | Architecture, strategy, canonical decisions, owner profile | -| GPT/Ceàrd | `jester/zlh-grind` | Execution, implementation, session handovers, debug notes | - -Both AIs share the same Gitea MCP (`https://git.zerolaghub.com/mcp`). - ---- - -## What Claude Does to Repos - -### Claude writes to `knowledge-base` -Claude is the sole author of `knowledge-base`. It writes and maintains: -- `ZeroLagHub_Master_Bootstrap_Apr2026.md` — platform state, architecture, infrastructure -- `OWNER_PROFILE.md` — James's background, working style, solo operator context -- `GHOST_SHELL_VISION.md` — long-term platform strategy -- `CLAUDE_PROJECT_INSTRUCTIONS.md` — Claude's own session start instructions -- `README.md` — index and session start URLs - -**GPT should not write to `knowledge-base`.** If GPT needs an architecture -decision recorded, it should flag it to James who will bring it to Claude. - -### Claude writes to `zlh-grind` only when asked -Claude does not routinely write to `zlh-grind` — that is GPT's workspace. -Claude may write to `zlh-grind` when: -- James asks Claude to create or update a specific file -- Claude is archiving resolved SCRATCH files (housekeeping) -- Claude is writing a coordination note like this one - -When Claude writes to `zlh-grind`, it will note what it changed so GPT is -not surprised. - ---- - -## What GPT Should Own in zlh-grind - -GPT is responsible for keeping these files current: - -| File | When to update | -|------|----------------| -| `OPEN_THREADS.md` | After completing work, discovering new issues, or changing priorities | -| `SCRATCH/handover-*.md` | At the end of every session — write a new handover or update the current one | -| `INFRASTRUCTURE.md` | If IPs or VM inventory changes | -| `PROJECT_CONTEXT.md` | If stack or naming conventions change | - -**GPT must not mark work as complete unless it has been verified.** - ---- - -## SCRATCH/ Directory Rules - -`SCRATCH/` is for active working notes — session docs, debug findings, specs. - -`SCRATCH/archive/` is for resolved work. Files get moved there (not deleted) -when the problem they describe is fully resolved. - -**Who archives:** Either Claude or GPT can archive SCRATCH files. Claude did -a bulk archive on April 10, 2026 covering all Denver migration and FQDN -migration notes. Going forward GPT should archive its own resolved SCRATCH -files as part of normal session hygiene. - -**Currently active SCRATCH files (as of Apr 10, 2026):** -- `handover-apr-2026.md` — primary handover, current state -- `session-stabilization-fabric-findings.md` — active bug, agent fix needed -- `velocity-plugin.md` — reference doc -- `service-discovery.md` — reference doc -- `minecraft-velocity-forwarding.md` — reference doc - ---- - -## Infrastructure Reality (Critical) - -**All active VM IDs are in the 9000s range on GTHost Detroit.** - -VM IDs in the 100s, 300s, 2000s range are **legacy/unused** — old -Pterodactyl-era VMs kept for reference only. Do not treat them as active. - -Denver host was fully decommissioned April 2, 2026. - -Authoritative VM/IP list: `INFRASTRUCTURE.md` - ---- - -## Knowledge Base — What's There Now - -Claude rebuilt `knowledge-base` on April 10, 2026. The following files are -current and accurate: - -| File | Purpose | -|------|---------| -| `README.md` | Index, session start URLs for both AIs | -| `ZeroLagHub_Master_Bootstrap_Apr2026.md` | Full platform state, architecture rules, pre-launch blockers | -| `OWNER_PROFILE.md` | James's background, AI workflow role, solo operator context | -| `GHOST_SHELL_VISION.md` | Ghost Shell / ZLH platform strategy | -| `CLAUDE_PROJECT_INSTRUCTIONS.md` | Claude's project-level instructions | - -Older files (`ZeroLagHub_Master_Bootstrap_Dec2025.md`, etc.) are still in -the repo for historical reference but are superseded. - ---- - -## Session Start Checklist for GPT - -At the start of every session, read: - -1. `SCRATCH/handover-apr-2026.md` — current platform state -2. `OPEN_THREADS.md` — active and outstanding work -3. This file if anything feels out of sync - -Before making architectural decisions, read: -- `knowledge-base/ZeroLagHub_Master_Bootstrap_Apr2026.md` - -If unsure whether a decision is architectural, stop and ask James to bring it -to Claude. - ---- - -## Pre-Launch Blockers (Current Priority Order) - -1. **Billing / Stripe** — scaffolded, DB writes missing, launch blocker -2. **Game server world backup / restore** — not started, trust-critical -3. **User onboarding flow** — not started -4. **Fabric readiness gating** — agent fix, supervisor.go + autostart.go -5. **Password reset flow** — verify wired up -6. **Usage limits / quota enforcement** — not started -7. **Email notifications** — not started -8. **Velocity resync endpoint** — route missing, data model ready -9. **Upload testing**, **stress testing**, **OPNsense audit**, **provisioning validation** - -See `OPEN_THREADS.md` for full detail.