mirror of
https://github.com/jcreek/CosmicClash.git
synced 2026-09-16 16:22:03 +00:00
docs(multiplayer-todo): add Phase 8 task breakdown for matchmaking and autoscaling
multiplayer-next.md carried the Phase 8 checklist but not the numbered tasks with acceptance criteria that work actually gets picked up from. That format lives in multiplayer-todo.md section 7, which already hosts Phase 7 as in-progress, so Phase 8 goes there too. Tasks 8.1-8.20 across four groups: backend service (identity, rating store, Glicko-2, queue), server orchestration and autoscaling, playlists and client UI, and keeping Docker/CI green. Section 0's short list gains an index entry, and the status header now says Phase 8 is a 1.0 launch blocker and the first phase to add a component outside the Godot project. Three entries are measured findings rather than plans, each of which would break a naive implementation: stdout block-buffering making a log-grep readiness probe hang forever, the hardcoded 7777/udp port preventing more than one match per host, and compose.phase6-smoke.yml's dependence on the exact behaviour allocation work would change. Also fixes a now-false cross-reference: a Phase 4 note read 'not Phase 8' meaning 'not a later phase', written when no Phase 8 existed. CLAUDE.md's 'never add new work to multiplayer-todo.md' rule gains the new-phase exception it always had in practice - Phase 7 was already there.
This commit is contained in:
@@ -15,7 +15,7 @@ Because the gameplay concept (vehicle soccer) can't be copyrighted but specific
|
||||
The prose docs carry far more design rationale than the code comments, and several are load-bearing:
|
||||
|
||||
- `multiplayer-next.md` — **the current** multiplayer checklist. Short. Read this first for "what's left".
|
||||
- `multiplayer-todo.md` — 250 KB of historical design decisions, per-task implementation evidence, and §9's numbered "gotchas" list. Code comments cite it constantly by section/task number (`§2.4`, `task 5.10`); when a comment does, that section is the real explanation. Don't add new work here — it's the archive.
|
||||
- `multiplayer-todo.md` — 250 KB of historical design decisions, per-task implementation evidence, and §9's numbered "gotchas" list. Code comments cite it constantly by section/task number (`§2.4`, `task 5.10`); when a comment does, that section is the real explanation. Mostly an archive: Phases 0–6 are done, and day-to-day work is tracked in `multiplayer-next.md` instead. The exception is a *new phase* — Phase 7 (Steam) and Phase 8 (matchmaking) both keep their numbered task breakdown and acceptance criteria in §7, because that is the format tasks are picked up from.
|
||||
- `TRAINING.md` — the full RL workflow (training, curriculum generations, export, eval, difficulty tiers).
|
||||
- `SERVER.md` — dedicated-server build, config, systemd deploy, sizing.
|
||||
- `STEAM.md` — optional GodotSteam custom-build setup and the transport contract.
|
||||
|
||||
Reference in New Issue
Block a user