magicciv/.project
autocommit 39bf244f74 docs(p1-29j): 📋 File autoplay→Rust action-application objective (p1-29d unblock)
p1-29i's full-game validation pinned the root cause that gates all of Wave-C
AI convergence: the autoplay AI applies city-founding/capture via GDScript
(`ai_turn_bridge_dispatch.gd:170 dispatch_found_city` → CityScript.new() →
EventBus.city_founded.emit), NEVER calling Rust `mc_turn::processor::
try_found_city` / `process_siege` where the balance levers live. So every
Rust-side founding/siege lever (p1-29i refound_suppression, and successors) is
inert by construction on the p1-29d gate surface — a Rail-1 violation on the
action-application seam.

Spec-only (Rail-1, scope game1, owner warcouncil, status stub). Large separate
effort, gated on p2-65 (mc-state gives the bridge a persistent GdGameState to
apply actions against). References p1-29d Findings A/2/3 and p1-29i's terminal
result. Added to objectives README dashboard.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 19:00:19 -07:00
..
designs feat(@projects/@magic-civilization): add mcts telemetry service and parity tests 2026-05-16 07:26:37 -07:00
experiments
future-games
handoffs docs(docs): 📝 Update Phase 3 military communications and resources documentation with handoff notes for data schema drift 2026-05-26 02:21:14 -07:00
history docs(history): 📝 Add markdown entry documenting the "odd-q axial consistency" fix in project history 2026-05-26 02:21:13 -07:00
objectives docs(p1-29j): 📋 File autoplay→Rust action-application objective (p1-29d unblock) 2026-06-04 19:00:19 -07:00
reports
screenshots feat(@projects/@magic-civilization): add survival scorecard tooling 2026-05-29 19:47:24 -06:00
tasks
team-leads feat(sprites): OSS standin coverage p2-23..27 (536 PNGs) + xi-v11 charter 2026-06-04 04:40:14 -07:00
AGE-OF-DWARVES-FEATURES.md
audio-sourcing-checklist.md
audio-status.md
CHANGELOG.md docs(core): 📝 document technical audit findings and AI milestones in CHANGELOG.md 2026-05-26 02:21:13 -07:00
FINISH_GAME1_PLAN.md docs(plan): finish-game1 gap analysis (28 objectives) + plan of record 2026-06-04 14:50:59 -07:00
gdlintrc.local
README.md
ROADMAP.md
SCREENSHOT_REGISTRY.md feat(@projects/@magic-civilization): add phase-13 claudio-vs-ai gameplay screenshots 2026-05-12 12:34:36 -07:00
TERMINOLOGY.md

.project/ — Directory Map

Build-process docs for Magic Civilization. Each file owns exactly one responsibility. Status of work-in-flight is tracked only in objectives/ (SSoT).

File / dir → responsibility

Path Responsibility Rule
README.md This map Maintained by hand when structure changes
ROADMAP.md Phase sequence + scope per milestone Never carries status; references objective IDs only
TERMINOLOGY.md Glossary (terms, acronyms, design vocabulary) Facts only, no status
CHANGELOG.md Dated narrative events (append-only) References objective IDs; never restates status
objectives/ Single source of truth for current state One .md per objective, YAML frontmatter status: field
objectives/README.md Dashboard index (grouped by P0/P1/P2) Generated by tools/objectives-report.py — do not hand-edit
tasks/milestones/ Per-milestone work packages (scoping docs) HOW, not WHAT-DONE
tasks/topics/ Cross-cutting topic work (balance tuning etc.) HOW, not WHAT-DONE
tasks/deferred/ Parked work packages HOW, not WHAT-DONE
handoffs/ Agent-to-agent context transfer YYYYMMDD_slug.md
history/ Archived one-off docs (reports, snapshots, obsolete plans) YYYYMMDD_slug.md; immutable once filed
reports/batches/ Autoplay batch output Tool artifacts
reports/simulation/ Simulator reports Tool artifacts
reports/screenshots/ Proof screenshots Tool artifacts
future-games/ Game 2 design drafts Out of scope for Game 1
gdlintrc.local Local gdlint overrides Config

Invariants

  1. Status lives in objectives/*.md frontmatter, nowhere else.
  2. ROADMAP, CHANGELOG, tasks/ may reference objective IDs; they may not restate status.
  3. objectives/README.md is machine-generated from frontmatter. Regenerate after any objective edit: python3 tools/objectives-report.py.
  4. history/ is append-only. Archived files get a YYYYMMDD_ prefix and are never edited in place; if a superseding doc is needed, create a new one.

Quick regen

python3 tools/objectives-report.py     # rebuilds objectives/README.md from frontmatter