Files
settled-reach/docs/workshops/content-gap-analysis_v0_1/SUMMARY.md
T
jpmschweitzerandClaude Opus 4.6 e96ec80d9c 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

21 KiB

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