Files

T

jpmschweitzerandClaude Opus 4.6 abff69a632 chore(meta): Sprint 17 planning — briefings, workshop brief, close Q-025

- Write sprint 17 briefings for server, client, copy, visual, joint
- Add Knowledge Flow & NPC Boundaries workshop brief
- Close Q-025 (KG cap/eviction not needed at current scale)
- Assign 9 tickets to Sprint 17: Tell

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

2026-02-23 23:25:08 +01:00

4.5 KiB

Raw Blame History

Sprint 17: Tell — Joint Tasks

Goal: NPCs volunteer information unprompted and express personality through delivery; the player can read time and orientation at a glance from the insert HUD; POI infrastructure lands on the server.

Pre-Sprint: Knowledge Flow & NPC Boundaries Workshop

Brief: docs/workshops/knowledge-flow-npc-boundaries/workshop-brief.md Participants: Tyre (arch), Gestalt (mechanics), Dudley (impl), Paula (narrative), Qatux (docs) Timing: After Sprint 16 closes, before Sprint 17 starts

Topics and Sprint Impact

Topic	Resolves	Feeds tickets
1. Knowledge grant mechanism	#141 remaining gap	#172, #149
2. NPC-NPC knowledge propagation	Q-024	#172
3. Unprompted disclosure design	—	#172, #173
4. NPC information boundaries	#142	#172
5. Contradiction detection pipeline	Q-026	Future (THE FRIEND arc)

Expected Outputs

D-record resolving Q-024 and Q-026
Implementation scope for #141 (wire knowledge_grant) and #142 (NPC boundary retrofit priority)
Mechanical spec for #172 unprompted disclosure
Updated ticket descriptions for #172 and #173

#172 is blocked until workshop completes. Other server tickets can start in parallel.

Pre-Sprint Decisions

Decision	Who	Blocks
Workshop Topics 1-5	Tyre, Gestalt, Dudley, Paula	#172, #173
Q-028: Collision-resistant line IDs	Gestalt, Tyre	Copy authoring conventions

Cross-Team Integration Points

Server ticket	Client ticket	Integration
#148 POI data model	#263 Time display	POI data feeds future minimap; time data already in snapshot
#232 Protocol versioning	All client	Client must handle version field in messages
#172 Unprompted disclosure	#537 E-Talk UX	Disclosure lines appear in dialogue UI; E-Talk overlay should hint at NPC willingness

Server ticket	Visual ticket	Integration
#148 POI data model	#314 Insert/HUD wireframe	POI categories must match wireframe's display elements

Sprint Completion Proof

Sprint 17 is DONE when:

Unprompted disclosure fires — An NPC with high trust and relevant knowledge volunteers information to the player without being asked. The volunteered line appears in the dialogue UI. The player's KnowledgeGraph gains a new fact via knowledge_grant.
Trait modifiers reshape delivery — Two NPCs with different personality traits deliver the same base information differently (different mood, different wording or selection weight).
Time is visible — The insert HUD shows current game time in a diegetic format. Time advances visibly as ticks pass.
POIs exist on the map — Server spawns POI entities with the PointOfInterest component. POIs can be discovered via walking into a location (physical discovery).
Protocol version field exists — All messages include a version field. Client logs a warning on version mismatch.
E-Talk overlay is informative — The interaction overlay shows NPC name (if known), relationship color, and a dialogue tier hint.
Insert wireframe is specified — Both smuggler and detective variants are wireframed with layout, colors, and interaction states documented.
Tutorial monologue fires — First-time events (move, fog, sound, NPC proximity) trigger diegetic tutorial lines for both characters.

Test Plan (D-030 alignment)

Sprint 17 is in the integration testing phase (Sprints 3-4 per D-030):

#172 + #173: Integration test — NPC with specific axis values and KG state triggers unprompted disclosure; trait modifier changes the selected line.
#148 + #149: Unit tests for POI component CRUD; integration test for discovery event → KG update.
#232: Unit test for version serialization roundtrip; integration test for version mismatch handling.
#263: Manual verification — time display updates as simulation advances.
#537: Manual verification — overlay shows correct NPC data.
#330: Line preview test — tutorial lines fire on first-time triggers, respect cooldown -1 (fire once).

Teams

Team	Branch	Agents	Tickets
server	`server`	Dudley, Tyre, Hoshe	#172, #173, #232, #148, #149
client	`client`	Stig, Tyre, Hoshe	#263, #537
copy	`copy`	Mellanie, Paula, Gestalt	#330
visual	`visual`	Araminta	#314

4.5 KiB Raw Blame History