magicciv/.project
Natalie 9267d056d2
Some checks are pending
ci / regression gate (push) Waiting to run
docs(replay): source-verified blueprint for p3-31 + p3-32 (blocked on RUN host)
Game 1 EA is already release-ready; the only open objectives are the two
game1-stretch replay items. This blueprint (from the map-replay-subsystem ultracode
workflow: 6 parallel source-readers + Opus synthesis re-verified against the crates)
gives the surgical, ordered implementation plan — recorder in mc-player-api, round-trip
+ determinism cargo tests, GdGameRecorder bridge, GDScript triggers, then p3-32 map
projections — plus the 7 owner decisions to settle first.

Blocked: plum has no cargo toolchain, so all Rust verification + Godot proofs need
the cloud RUN host, which depends on the forge migration (ab8fd4d7) + a live golden
build. Execute when the fleet is reachable.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-30 01:55:19 -04:00
..
designs docs(replay): source-verified blueprint for p3-31 + p3-32 (blocked on RUN host) 2026-06-30 01:55:19 -04:00
experiments
future-games
handoffs docs(infra): handoff — mc packer leaked into cocotte DO account 2026-06-29 17:55:39 -04:00
history docs(review): Grok work review cycle 03 — reproduce sim_scenario headless proof 2026-06-28 14:38:55 -04:00
objectives feat(sim): land sim_scenario declarative harness + scenarios for headless Game 1 proof gate 2026-06-28 14:24:38 -04:00
reports
screenshots
tasks
team-leads
AGE-OF-DWARVES-FEATURES.md
audio-sourcing-checklist.md
audio-status.md
CHANGELOG.md feat(release): complete Game 1 "Age of Dwarves" Early Access 2026-06-28 11:58:36 -04:00
gdlintrc.local
README.md
RELEASE_READINESS.md docs(release): cite specific sim_scenario proof artifact (.local/proofs/... full BatchResult PASS from committed harness) 2026-06-28 14:28:07 -04:00
ROADMAP.md
SCREENSHOT_REGISTRY.md
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