Move non-core root reference docs under docs/reference
This commit is contained in:
parent
e61ecaf674
commit
6d67fd0f31
140
docs/reference/CLAUDE_GPT_COORDINATION.md
Normal file
140
docs/reference/CLAUDE_GPT_COORDINATION.md
Normal file
@ -0,0 +1,140 @@
|
||||
# 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.
|
||||
Loading…
Reference in New Issue
Block a user