Files

T

jpmschweitzerandClaude Opus 4.6 4525e0a4bc docs(briefings): add frontmatter to all agent briefings

Standardized YAML frontmatter on all 18 docs/briefings/ files with
title, description, type, status, and agent fields. Each description
captures the agent's role and current focus areas.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-13 15:22:10 +01:00

4.4 KiB

Raw Blame History

title, description, type, status, agent, updated

title	description	type	status	agent	updated
Hoshe - Project Briefing	QA and test infrastructure agent — owns generator output validation, integration tests, content schema validation, and legibility test criteria for the v0.2 generator spike	briefing	active	Hoshe	2026-03-13

Hoshe - Project Briefing

Last updated: 2026-03-13

Current Project State

The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 137+ confirmed decisions. Where's the Fun? Workshop complete (2026-03-05) — 24 decisions locked. v0.2 direction: generator-first proof-of-life, tycoon bookmark, all NPCs generated. Sprint 25 generator spike confirmed as critical path.

Status

ACTIVE. Test infrastructure from earlier sprints is operational. v0.2 focus: generator output validation — can the generator produce legible NPCs? Are relationships readable from generator output?

Decisions Relevant to Your Role

Read decisions/architecture.md (D-010, D-020, D-030) and decisions/perception.md (D-011, D-017, D-018). Key decisions:

D-010: Information boundaries — testable? Can we verify information never leaks?
D-020: MessagePack serialization — correct round-trip? No data loss at protocol boundary?
D-030: Testability architecture (hybrid Rust tests, gdUnit4, three-layer IPC, CauseChain)
D-119: Generator spike Sprint 25 — the success criterion is "can the player read NPC relationships from generator output?" Hoshe defines and verifies this criterion.

What's Been Delivered (Sprints 2-4)

Test infrastructure now in place:

Integration test: tile type data in live server mode (#410, Sprint 4)
Integration test: input roundtrip through live server (#411, Sprint 4)
Knowledge graph unit test suite (#367, Sprint 2)
make validate-content CLI (#392, Sprint 3)

Content pipeline (testable surface):

YAML content loader Phase 2 (#408) — content loading is live
Content schema definitions (#386) — validation rules exist
Global knowledge files (#388) — canonical FactId source for validation
Line previewer CLI (#407) — can verify content loads without errors

Current Priorities

Consult docs/sprints/ for active sprint briefing.

Generator spike validation (v0.2 critical path):

Generator output legibility test plan — define what "can the player read NPC relationships from generator output?" means as a testable criterion. Produce test plan before the Sprint 25 generator spike begins.
NpcBlueprint struct tests — when Tyre delivers the NpcBlueprint struct design, write unit tests verifying the 10-axis model (D-024) is correctly encoded in generator output.
Generated NPC relationship readability test — functional test: given a generated location with generated NPCs, can a blind observer describe social relationships correctly? Design the test protocol.

Infrastructure maintenance:

Verify existing integration tests still pass — regression check after any architectural changes
Test harness improvements — reusable fixtures for server+client pairs
Dedicated test map — minimal map for routing, pathfinding, visibility, protocol correctness (not dependent on hand-authored content)
Edge case coverage — malformed packets, disconnects, entities at map edges, interactions at max range

Development Workflow

See docs/DEVOPS.md for full procedures. Your key targets:

make test — run all tests (server + client)
make test-server — Rust unit + integration tests
make test-client — gdUnit4 tests (headless runner pending)
make lint — run all linters
make ci — full CI pipeline locally (lint -> build -> test)
make validate-content — content schema validation
Server tests: server/ (inline #[cfg(test)] + tests/ directory per D-030)
Client tests: client/ (gdUnit4 per D-030)
Cross-boundary tests: tests/ (IPC fixtures, serialization round-trips)
Test caches: .cache/ (gitignored, cleared by make clean)

Key Documents

decisions/ — domain-split decision files (see decisions/README.md for index)
docs/DEVOPS.md — build, test, lint, CI procedures
docs/sprints/ — current sprint briefings
docs/workshops/wheres-the-fun/workshop-outcomes.md — v0.2 success criteria context
tests/ — integration and end-to-end tests
TEAM.md — team roster

4.4 KiB Raw Blame History