docs(workshops): archive v0.1 content gap analysis workshop

6 agents × 2 rounds examining 9 content layers. Produced D-032 through D-039, THE FRIEND NPC pattern, converged tag taxonomy, and Sova Transit District setting. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 20:27:31 +01:00
parent 56ee8305ae
commit e96ec80d9c
13 changed files with 6116 additions and 0 deletions
@@ -0,0 +1,373 @@
+# v0.1 Content Gap Analysis Workshop — Summary
+
+**Workshop dates:** 2026-02-11
+**Participants:** Mellanie, Paula, Araminta, Miri, Gestalt, Ozzie
+**Facilitator:** Team Leader (Jeroen)
+**Documenter:** Qatux
+
+---
+
+## Executive Summary
+
+The v0.1 Content Gap Analysis Workshop examined 9 content layers across the vertical slice (D-027) to identify what content exists, what's missing, and what blocks production. Six agents delivered independent Round 1 analyses, then synthesized across all outputs in Round 2. The project lead made 9 directive decisions between rounds.
+
+**Key outcomes:**
+- 9 new confirmed decisions (D-032 through D-040)
+- THE FRIEND NPC pattern established as emotional centerpiece (one production-level NPC per character)
+- Converged tag taxonomy for line pools (6 structural + 3 selection tags)
+- Sova Transit District / Krenn System confirmed as first concrete setting
+- Audio confirmed in v0.1 scope (8 files via Stable Audio Open)
+- All 6 wow moments promoted to v0.1 scope
+- Wiki taxonomy structure declared non-negotiable
+- ~50 new tickets identified across all agents (deduplicated below)
+- Full dependency chain mapped with critical path: Dual Lens Guide → Voice Kits → THE FRIEND → Validation → Scale
+
+---
+
+## Workshop Structure
+
+**Round 1:** Each agent independently analyzed 9 content layers against the vertical slice spec (D-027). Layers: character voice, dialogue, monologue, environmental text, NPC profiles, spatial layout, audio, visual design, wiki/lore.
+
+**Between rounds:** Project lead reviewed all 6 outputs and issued 9 directive decisions.
+
+**Round 2:** Each agent read all 6 Round 1 outputs plus directives. Synthesis: convergences, disagreements, dependency chains, concrete next steps, missing tickets.
+
+**Workshop brief:** `docs/workshops/content-gap-analysis_v0_1/content-gap-analysis-workshop-brief.md`
+**Round 1 outputs:** `round1-{agent}.md` (6 files)
+**Round 2 outputs:** `round2-{agent}.md` (6 files)
+
+---
+
+## Project Lead Decisions (Between Rounds)
+
+These 9 directives were issued by the project lead after reviewing Round 1 outputs. They are non-negotiable constraints for Round 2 and all downstream work.
+
+| # | Directive | Status |
+|---|-----------|--------|
+| 1 | Separate monologue pools per character | Confirmed, non-negotiable → D-032 |
+| 2 | Color = relationship to player | Approved → D-033 |
+| 3 | Audio included in v0.1 (6-8 files via Stable Audio Open, self-hosted) | Confirmed → D-038 |
+| 4 | One NPC per character = THE FRIEND, production-level complex | Confirmed → D-034 |
+| 5 | Wiki taxonomy structure: non-negotiable, must be established NOW | Confirmed → D-040 |
+| 6 | Sova Transit District / Krenn System: first concrete star system | Confirmed (worldbuilding milestone) → D-036 |
+| 7 | Detective's FRIEND: Sera Venn (Paula's design) | Confirmed → D-034 |
+| 8 | All 6 wow moments in scope (Ozzie's 4 essential + 2 nice-to-have all promoted) | Confirmed → D-039 |
+| 9 | Stable Audio Open licensing confirmed (free commercial under $1M revenue) | Confirmed → D-038 |
+
+---
+
+## Decisions Produced (D-032 through D-040)
+
+Full decision text in `decisions/*.md`. Summary:
+
+| ID | Title | Domain | Source |
+|----|-------|--------|--------|
+| D-032 | Separate monologue pools per character | content.md | Project lead directive #1 |
+| D-033 | Entity color = relationship to player | perception.md | Araminta R1 proposal, project lead directive #2 |
+| D-034 | THE FRIEND production-level NPC pattern | content.md | Ozzie R1 concept, project lead directive #4, Paula R2 designs |
+| D-035 | Converged tag taxonomy for line pools (6+3) | content.md | Gestalt R1/R2 + Mellanie convergence |
+| D-036 | Sova Transit District / Krenn System as v0.1 setting | content.md | Miri R1, project lead directive #6 |
+| D-037 | Contraband specification | content.md | Miri R1/R2 proposal, team validation |
+| D-038 | Audio in v0.1 scope via Stable Audio Open | scope.md | Project lead directives #3, #9; Ozzie R2 spec |
+| D-039 | v0.1 wow moment scope — all 6 moments | scope.md | Ozzie R1/R2, project lead directive #8 |
+| D-040 | Wiki taxonomy structure | process.md | Miri R2 proposal, project lead directive #5 |
+
+---
+
+## Key Convergences
+
+Areas where multiple agents independently reached the same conclusion:
+
+### Fully aligned (no further discussion needed)
+- **Dual Lens Guide is the root dependency** — all 6 agents identified this
+- **Monologue carries the game** — perception, tells, atmosphere, tutorial, character voice (Gestalt, Mellanie, Ozzie)
+- **YAML for line pools** — Mellanie proposed, Gestalt refined, no disagreement
+- **5 tell categories for v0.1** — text-via-monologue as renderer (Gestalt, Araminta, Mellanie)
+- **30/50/20 entanglement ratio works** — validated against 15 NPCs (Paula, Gestalt)
+- **Spatial layout is load-bearing** — sightlines are gameplay (Araminta, Paula, Ozzie)
+- **Miri's setting is the substrate** — everyone builds on Sova Transit District
+
+### Converged during Round 2
+- **Tag taxonomy**: 6 structural + 3 selection tags per dialogue line; 3 additional for monologue (Gestalt R2 section 1)
+- **Situation taxonomy**: 13 situations from Gestalt + Mellanie merge
+- **THE FRIEND mechanical spec**: full pipeline depth test, ~70-100 authored lines per NPC
+- **Audio architecture**: event-driven with asset registry + visual fallback (Gestalt R2 section 6)
+- **Line previewer MVP**: Rust CLI sharing pipeline code, 7 must-have features (Gestalt R2 section 7)
+- **NPC relationship web**: 15 NPCs, 5 triangles (Paula R2 reconciliation)
+- **Dependency chain**: three parallel tracks converging at content packs (Paula R2 section 2)
+- **Placeholder art pipeline**: four phases, zero image files for v0.1 (Araminta R2 section 3)
+
+### Minor divergences resolved
+- **Paula proposed 7 triangles, Gestalt proposed 4** → Paula reconciled to 5 triangles
+- **Mellanie proposed 8 per-line tags, Gestalt proposed more** → Converged to 6+3 (dropped location and type from per-line, made them directory-level)
+- **Mellanie wanted to defer audio** → Project lead overruled; audio confirmed
+- **Araminta wanted to defer audio entirely** → Project lead overruled; visual indicators complement audio
+- **Detective's FRIEND candidate** → Mellanie proposed Lera (bar owner), Paula proposed Sera Venn (Commission tech) → Project lead confirmed Sera Venn
+
+---
+
+## Open Questions
+
+### Updated existing questions
+- **Q-003 (Art direction)**: Further resolved. Araminta's v0.1 Visual Grammar proposal covers color palette, entity rendering, fog states, zone palettes. Long-term art direction remains open.
+- **Q-005 (Prototype scale)**: Further resolved. 15 NPCs, 3 social sites, 1 district (Sova Transit). Full game scale TBD.
+
+### New questions raised during workshop
+
+| ID | Question | Owner | Context |
+|----|----------|-------|---------|
+| Q-012 | How does the generation expansion pass work? LLM, template-based, or rule-based? | Gestalt, Mellanie | Affects how base lines are authored. LLM needs style-strong anchors; rules need substitution patterns. |
+| Q-013 | How does the line previewer handle THE FRIEND's temporal progression? | Gestalt, Dudley | Previewer needs sequence mode to simulate multi-visit contradiction arcs. |
+| Q-014 | Audio timing with monologue — when does the chime fire relative to text? | Gestalt, Ozzie | Affects monologue line writing rhythm (first word shouldn't be the important one if chime precedes). |
+| Q-015 | Does 4x generation expansion apply to THE FRIEND's custom lines? | Mellanie, Gestalt | Ozzie recommends no expansion on FRIEND lines — every line hand-authored. |
+| Q-016 | Knowledge hierarchy for monologue prerequisites | Gestalt, Paula | Need `suspects` < `knows_of` < `knows_details` hierarchy, not binary `knows: X`. |
+| Q-017 | Triangle pressure threshold — what events trigger escalation? | Gestalt, Paula | Need numeric pressure model for `confrontation` situation activation. |
+
+---
+
+## Ticket Inventory (Deduplicated)
+
+Tickets identified across all 6 agents, deduplicated and categorized. Cross-referenced against existing tickets where applicable.
+
+### THE FRIEND (Critical — pipeline depth test)
+
+| Ticket | Owner | Priority | Notes |
+|--------|-------|----------|-------|
+| THE FRIEND: Smuggler (Kael Davan) — full profile + contradiction arc | Paula (profile), Mellanie (voice) | Critical | ~75-100 authored lines |
+| THE FRIEND: Detective (Sera Venn) — full profile + contradiction arc | Paula (profile), Mellanie (voice) | Critical | ~75-100 authored lines |
+| Contradiction arc design document (reusable pattern) | Paula | High | Template for future complex NPCs |
+| THE FRIEND visual treatment spec | Araminta | High | Color transition, earned visual detail |
+
+### Opening Experience (Critical — first impression)
+
+| Ticket | Owner | Priority | Notes |
+|--------|-------|----------|-------|
+| Opening hook content — smuggler (10-15 monologue lines) | Mellanie | Critical | Diegetic tutorial, sets voice |
+| Opening hook content — detective (10-15 monologue lines) | Mellanie | Critical | Different emotional register |
+| First monologue surprise moment (per character) | Mellanie, Paula, Gestalt | High | Core mechanic proof before minute 15 |
+
+### Character & Narrative Architecture (Critical path)
+
+| Ticket | Owner | Priority | Notes |
+|--------|-------|----------|-------|
+| Character voice speech patterns | Paula + Mellanie | High | Speech-level detail for voice kits |
+| Access tier shift design document | Paula + Gestalt | High | How access changes during gameplay |
+| Mirror moment design document | Paula + Mellanie | Medium | 10-12 paired observation triggers |
+| Flat NPC "almost interesting" pass | Mellanie | High | Investigation noise floor |
+| Diegetic insert flavor text (per character) | Mellanie | Medium | Character-specific HUD text |
+| Diegetic tutorial monologue lines (8-10 per character) | Mellanie | Medium | Movement, fog, sound, NPC interaction |
+| News ticker content — Sova (20-30 lines) | Mellanie + Miri | High | Cheap worldbuilding, high atmosphere |
+
+### Setting & Worldbuilding
+
+| Ticket | Owner | Priority | Notes |
+|--------|-------|----------|-------|
+| Sova Texture Appendix (slang, idioms, decoration, local complaint) | Miri | Critical | Blocks Mellanie's dialogue authoring |
+| Krenn System wiki entry (first star system profile) | Miri | High | Sets template for all future systems |
+| Sova Station Profile | Miri | High | Off-district references in dialogue |
+| Detective institutional chain of command | Miri + Paula | High | Blocks detective character build |
+| Meridian coverage map for Sova Transit | Miri | Medium | Investigation mechanics, ring ops |
+| Off-station connections brief | Miri | Medium | Ring NPC dialogue consistency |
+| Span gate transit schedule | Miri | Medium | NPC routine design, ring timing |
+| Observation gallery / viewport description | Miri | Low | Ozzie's "something out the window" |
+
+### Wiki & Taxonomy
+
+| Ticket | Owner | Priority | Notes |
+|--------|-------|----------|-------|
+| Wiki taxonomy structure + first entries | Miri + Qatux | Critical | Project lead: non-negotiable, NOW |
+| Tag taxonomy wiki page | Gestalt | High | Reference document for all content authors |
+| Line pool format specification (standalone doc) | Gestalt | High | Formalize Round 1/2 YAML format |
+
+### Visual & Spatial Design
+
+| Ticket | Owner | Priority | Notes |
+|--------|-------|----------|-------|
+| v0.1 Visual Grammar document | Araminta | Critical | Root visual dependency |
+| Entity color system spec | Araminta | Critical | Relationship-to-player color mapping |
+| Spatial layout: Logistics Hub | Araminta | High | Floor plan, sightlines, NPC positions |
+| Spatial layout: Bar (The Last Shift) | Araminta | High | Corner booth as key observation position |
+| Spatial layout: Corridors + Smuggling spaces | Araminta | High | Hidden spaces, maintenance corridors |
+| Insert/HUD wireframe + dual-character variants | Araminta | High | Smuggler social map vs detective case file |
+| Monologue display system visual spec | Araminta | High | Typography, animation, stacking rules |
+| Text display hierarchy spec | Araminta | High | 4 text pipelines, 4 visual treatments |
+| Sound indicator visual design | Araminta | High | Fog-edge pulse, complementary to audio |
+| Fog rendering visual spec | Araminta | Medium | 4-state visibility model |
+| Span gate signature visual element | Araminta | Medium | Rhythmic glow, first-impression anchor |
+| Visual asset taxonomy (wiki structure) | Araminta | Medium | Future-ready directory structure |
+| Environmental text visual standards | Araminta | Medium | Bilingual signage, terminal screens |
+
+### Systems / Server (Content-Supporting)
+
+| Ticket | Owner | Priority | Notes |
+|--------|-------|----------|-------|
+| Dialogue selection pipeline (4-layer filter) | Dudley + Gestalt | Critical | Core runtime: access → situation → trust → weighted |
+| Monologue trigger system | Dudley + Gestalt | Critical | 9 triggers, character-specific pools, prerequisite gates |
+| YAML content loader (hot-reload for previewer) | Dudley | High | Parses YAML into indexed line pools |
+| Sound event system architecture | Dudley + Gestalt | High | Event emitter with audio + visual fallback |
+| NPC mood state machine | Dudley | High | Drives Layer 4 selection + tell system |
+| Trust progression system | Dudley | High | Surface → real → secret per NPC pair |
+| Interaction tracking component | Dudley | High | Per-NPC-pair counters drive Layer 2 |
+| Knowledge state component | Dudley + Gestalt | High | Gates monologue prerequisites |
+| Observation event generator | Dudley | Critical | Bridge between simulation and perception |
+| Tell state derivation system | Dudley | Medium | Reads axes, outputs observable tells |
+| Line variety tracker | Dudley | Medium | Prevents repeat lines per session |
+
+### Audio
+
+| Ticket | Owner | Priority | Notes |
+|--------|-------|----------|-------|
+| Audio asset set — 8 files via Stable Audio Open | TBD | High | See Ozzie R2 section 4 for full spec |
+
+### Existing Ticket Scope Updates
+
+| Ticket | Update Needed |
+|--------|---------------|
+| #90 (Tell system) | Scope to 5 categories; text-via-monologue as v0.1 renderer |
+| #124 (Sound system) | Include sound event emitter architecture + visual fallback |
+| #168 (Tag taxonomy) | Reference converged taxonomy (D-035) |
+| #179 (NPC profiles) | THE FRIEND depth split: 2 production-level, 13 standard |
+| #189 (Cultural generation guide) | Sova Transit District as first concrete instance |
+| #190-192 (Template content packs) | Parallel spatial layouts as co-deliverables |
+| #193 (Line previewer) | Concrete MVP: 7 must-have features, Rust CLI, sequence mode |
+| #261 (Dual Lens Authoring Guide) | Add: emotional divergence, access tier shifts, authoring checklist, THE FRIEND section |
+
+---
+
+## Dependency Chain (Converged)
+
+Three parallel tracks converge at content pack production. Critical path highlighted.
+
+```
+TRACK A: Narrative (Paula)        TRACK B: Setting (Miri)         TRACK C: Systems (Gestalt+Araminta)
+
+1. Dual Lens Guide (#261)    ←─  1. Sova Setting Brief (#189)     1. Line Pool Format Spec
+   **CRITICAL PATH**              (Round 1 output = v0.1 draft)    2. Visual Grammar (Araminta)
+   |                              |                                 3. Spatial Layouts x3 (Araminta)
+2. Character Voice Patterns       2. Wiki Taxonomy + Krenn Entry    4. Line Previewer (#193)
+   |                              |
+3. THE FRIEND profiles (x2)      3. Sova Texture Appendix
+   **CRITICAL PATH**              |
+   |                              4. Contraband Spec
+4. NPC Profiles (Tier 1-3)           + Detective Chain of Command
+   |                              |
+   └────────────┬─────────────────┘
+                |
+                v
+   5. Character Voice Kits (Mellanie) ← **CRITICAL PATH**
+                |
+   6. Opening Hooks (Mellanie) ← **CRITICAL PATH**
+                |
+                └──────────────────────────────────────────────────┘
+                                    |
+                                    v
+                           7. THE FRIEND Content Packs (Mellanie) ← **CRITICAL PATH**
+                                    |
+                           8. VALIDATION: Previewer test
+                                    |
+                           9. Content Packs x3 (#190-192) (Mellanie)
+                                    |
+                          10. Polish: Tell lines, mirror moments, environmental text
+```
+
+**Critical path:** Dual Lens Guide → Voice Kits → THE FRIEND Content → Validation → Scale
+
+**Parallel work (no dependencies):**
+- Miri: Wiki taxonomy, Krenn System entry, Sova Texture Appendix, contraband spec
+- Araminta: Visual Grammar, spatial layouts, insert wireframe
+- Gestalt: Line pool format spec (formalize), knowledge state vocabulary
+- Mellanie: Tag taxonomy smoke test (20 lines), environmental text templates, news ticker draft
+- Audio: Generate station ambient + monologue chime (the two most important files)
+
+---
+
+## Content Volume Estimates (Mellanie R2)
+
+| Category | Authored Lines | After Expansion |
+|----------|---------------|-----------------|
+| THE FRIEND: Kael Davan (full pack) | 75-100 | Hand-authored only |
+| THE FRIEND: Sera Venn (full pack) | 75-100 | Hand-authored only |
+| Template dialogue (3 packs) | 400-500 | ~1,600-2,000 (4x) |
+| NPC-specific lines (~13 remaining) | 80-140 | ~320-560 (4x) |
+| Monologue — smuggler | 120-160 | ~240-320 (2x) |
+| Monologue — detective | 120-160 | ~240-320 (2x) |
+| Opening hooks (2 characters) | 20-30 | Hand-authored only |
+| Environmental text | 50-60 | N/A |
+| News ticker / Meridian feed | 20-30 | N/A |
+| UI microcopy | 40-50 | N/A |
+| Tell monologue lines | 30-50 | N/A |
+| **Total** | **~1,030-1,380** | **~3,200-4,200** |
+
+---
+
+## Per-Agent Next Steps
+
+### Paula (Critical path owner)
+1. Dual Lens Authoring Guide — full draft (blocks everything)
+2. THE FRIEND: Kael Davan — full production profile
+3. THE FRIEND: Sera Venn — full production profile
+4. Relationship web formalization (15 NPCs, 5 triangles with Krenn names)
+5. NPC Profiles: Tier 1 (4 entangled), Tier 2 (7 mundane), Tier 3 (3 flat)
+
+### Mellanie (Content production)
+1. Tag taxonomy smoke test (20 lines in YAML, immediate)
+2. Environmental text templates + news ticker draft (unblocked)
+3. Voice kits (3 options per character, needs Dual Lens Guide)
+4. Opening hooks (needs voice kit validation)
+5. THE FRIEND content packs (needs FRIEND profiles)
+
+### Miri (Setting foundation)
+1. Contraband Specification (unblocked, immediate)
+2. Sova Texture Appendix (slang, idioms — blocks Mellanie)
+3. Wiki taxonomy structure + Krenn System entry
+4. NPC name finalization (mapping to Paula's web)
+5. Detective chain of command
+
+### Gestalt (Systems specification)
+1. Lock tag taxonomy + line pool format (formalize as document)
+2. Knowledge state vocabulary (blocks monologue prerequisites)
+3. Dialogue selection pipeline specification
+4. Sound event system architecture
+5. Line previewer (#193) MVP scope
+
+### Araminta (Visual design)
+1. v0.1 Visual Grammar document (unblocked, immediate)
+2. Spatial layouts x3 (needs Visual Grammar + Miri's setting)
+3. Insert/HUD wireframe (dual-character variants)
+4. Monologue display system spec
+5. Sound indicator visual design
+
+### Ozzie (Validation)
+1. Review THE FRIEND contradiction arcs (gut check)
+2. Audio asset specification finalization
+3. Playtest readiness evaluation
+4. Wow moment dependency tracking
+
+---
+
+## Workshop Assessment
+
+**Strengths:**
+- Remarkable convergence across 6 independent analyses
+- THE FRIEND concept evolved from Ozzie's emotional instinct through Paula's structural design to Mellanie's authoring plan in a single workshop
+- Miri's Sova Transit District gave the entire team a concrete foundation
+- Tag taxonomy converged without coordination — Mellanie and Gestalt proposed nearly identical structures
+- Dependency chain was independently identified by Mellanie, Paula, and Gestalt with compatible structures
+
+**Risks:**
+- Dual Lens Guide is a single point of failure — everything downstream blocks on Paula's deliverable
+- Content volume (~1,030-1,380 lines) is significant for one writer (Mellanie)
+- 17 content-supporting systems identified, 0 built — server team has substantial work
+- Generation expansion on monologue risks flattening character voice (Ozzie, Mellanie flag 2x max for monologue vs 4x for dialogue)
+
+**Flags for Qatux:**
+- Mellanie proposed Lera Sessik as detective's FRIEND in Round 2; Paula proposed Sera Venn. Project lead confirmed Sera Venn. Lera remains the bar owner, not THE FRIEND.
+- Paula reconciled from 7 triangles to 5 triangles in Round 2. The 5-triangle model is canonical.
+- Miri proposed different NPC name assignments than Paula's Round 2 reconciliation. Paula's Round 2 assignments are canonical (verified by project lead's Sera Venn confirmation).
+- Gestalt's "17 content needs, 0 built" assessment accurately describes the systems gap.
+
+---
+
+*Compiled by Qatux. Workshop outputs archived at `docs/workshops/content-gap-analysis_v0_1/`.*
+*Decisions recorded in `decisions/*.md` (D-032 through D-040).*
+*Last updated: 2026-02-11*