jpmschweitzerandClaude Opus 4.6
cff4c74d75
Update Key Documents sections to reference decisions/ directory instead of monolithic DECISIONS.md. Add Development Workflow sections to implementation agents (Dudley, Hoshe, Justine, Oscar, Si, Stig, Tyre) with relevant Makefile targets and directory conventions. Streamline decision references to point to specific domain files. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
48 lines
2.5 KiB
Markdown
48 lines
2.5 KiB
Markdown
# Tyre - Project Briefing
|
|
Last updated: 2026-02-10
|
|
|
|
## Current Project State
|
|
The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 29 confirmed decisions, 17 discussion rounds complete. Engine selected (D-020: Godot + Rust/bevy_ecs subprocess). Vertical slice defined (D-027).
|
|
|
|
## Decisions Relevant to Your Role
|
|
Read `decisions/architecture.md` (primary) and `decisions/perception.md` (secondary). Key decisions:
|
|
- **D-010:** Four architectural principles (client-server, info boundaries, deterministic sim, input events)
|
|
- **D-020:** Godot client + Rust/bevy_ecs server via subprocess/IPC, MessagePack serialization
|
|
- **D-026:** Simulation tier budgets (Active 30-80 NPCs, Background 500-2K, State-saved 10K+)
|
|
- **D-030:** Testability architecture (hybrid test org, gdUnit4, CauseChain, three-layer IPC testing)
|
|
- **D-031:** Time system (10 ticks = 1 game-minute, 4 day phases)
|
|
|
|
## Open Questions Assigned to You
|
|
- Q-001: Engine selection (LEAD, CRITICAL - next priority)
|
|
- Q-002: v0.1 scope definition (co-lead)
|
|
- Q-005: Prototype scale (co-lead with Gestalt, Miri)
|
|
- Q-007: Target platforms
|
|
|
|
## Current Priorities
|
|
Vertical slice technical implementation:
|
|
1. NPC ECS component model (10 axes + optional CombatCapability component)
|
|
2. Template instantiation system (single-ownership + reference links with metadata)
|
|
3. Simulation tier transitions (timestamp LRU + scope tags + bevy_ecs component add/remove)
|
|
4. Access tier system (content filtering by tier 0-3)
|
|
5. Basic cargo/goods system (for smuggling ring mechanics)
|
|
6. Line previewer CLI (weekend build — YAML templates → trait-modified line pools)
|
|
|
|
**Future flag:** Base builder DLC requires data model stub now: `modifications: Vec<Modification>` on relevant entities. Add to schema early.
|
|
|
|
## Development Workflow
|
|
See `docs/DEVOPS.md` for full procedures. You own the technical build pipeline.
|
|
- `make setup` — verify dev environment (Rust toolchain, Godot, Python)
|
|
- `make build` — build both client and server
|
|
- `make ci` — run full CI pipeline locally (lint → build → test)
|
|
- `make clean` — clear build artifacts and `.cache/`
|
|
- Server code: `server/` (Rust/bevy_ecs, cargo)
|
|
- Client code: `client/` (Godot 4, GDScript)
|
|
- Cross-boundary tests: `tests/` (IPC fixtures, integration)
|
|
- Shared config: `.config/` (linters, formatters)
|
|
|
|
## Key Documents
|
|
- decisions/ - domain-split decision files (see decisions/README.md for index)
|
|
- docs/DEVOPS.md - build, test, lint, CI procedures
|
|
- docs/discussions/ - archived rounds
|
|
- TEAM.md - team roster
|