jpmschweitzerandClaude Opus 4.6
abff69a632
- 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>
81 lines
4.5 KiB
Markdown
81 lines
4.5 KiB
Markdown
# 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:
|
|
|
|
1. **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`.
|
|
2. **Trait modifiers reshape delivery** — Two NPCs with different personality traits deliver the same base information differently (different mood, different wording or selection weight).
|
|
3. **Time is visible** — The insert HUD shows current game time in a diegetic format. Time advances visibly as ticks pass.
|
|
4. **POIs exist on the map** — Server spawns POI entities with the `PointOfInterest` component. POIs can be discovered via walking into a location (physical discovery).
|
|
5. **Protocol version field exists** — All messages include a version field. Client logs a warning on version mismatch.
|
|
6. **E-Talk overlay is informative** — The interaction overlay shows NPC name (if known), relationship color, and a dialogue tier hint.
|
|
7. **Insert wireframe is specified** — Both smuggler and detective variants are wireframed with layout, colors, and interaction states documented.
|
|
8. **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 |
|