From 36ffd3f6fa571e410821bc85aa471f3235344181 Mon Sep 17 00:00:00 2001 From: Jeroen Schweitzer Date: Wed, 11 Feb 2026 20:28:17 +0100 Subject: [PATCH] docs(decisions): add D-040 wiki taxonomy and Q-012 through Q-017 D-040: hierarchical wiki structure with YAML frontmatter. 6 new open questions from content gap analysis workshop covering generation expansion, line previewer, audio timing, FRIEND content authoring, knowledge hierarchy, and triangle pressure thresholds. Co-Authored-By: Claude Opus 4.6 --- decisions/README.md | 10 +++++----- decisions/process.md | 22 ++++++++++++++++++++- decisions/questions.md | 44 ++++++++++++++++++++++++++++++++++++++---- 3 files changed, 66 insertions(+), 10 deletions(-) diff --git a/decisions/README.md b/decisions/README.md index 409d3cf18..d2f545a90 100644 --- a/decisions/README.md +++ b/decisions/README.md @@ -11,11 +11,11 @@ Cross-domain decisions live in one file with cross-reference notes in related fi | File | Domain | Decisions | |------|--------|-----------| | [architecture.md](architecture.md) | Technical foundation | D-008, D-009, D-010, D-012, D-020, D-026, D-030, D-031 | -| [perception.md](perception.md) | Player observation | D-011, D-015, D-016, D-017, D-018, D-019 | -| [content.md](content.md) | NPC, dialogue, templates | D-023, D-024, D-025, D-028, D-029 | -| [scope.md](scope.md) | Game concept, prototype | D-001, D-003, D-005, D-006, D-007, D-013, D-014, D-027 | -| [process.md](process.md) | Team, workflow | D-004, D-021, D-022 | -| [questions.md](questions.md) | Open questions | Q-001 through Q-011 | +| [perception.md](perception.md) | Player observation | D-011, D-015, D-016, D-017, D-018, D-019, D-033 | +| [content.md](content.md) | NPC, dialogue, templates | D-023, D-024, D-025, D-028, D-029, D-032, D-034, D-035, D-036, D-037 | +| [scope.md](scope.md) | Game concept, prototype | D-001, D-003, D-005, D-006, D-007, D-013, D-014, D-027, D-038, D-039 | +| [process.md](process.md) | Team, workflow | D-004, D-021, D-022, D-040 | +| [questions.md](questions.md) | Open questions | Q-001 through Q-017 | | [rejected.md](rejected.md) | Rejected alternatives | R-001 through R-010 | ## Querying Decisions diff --git a/decisions/process.md b/decisions/process.md index c2f7251e7..e1460ef6b 100644 --- a/decisions/process.md +++ b/decisions/process.md @@ -42,6 +42,26 @@ How the team works: composition, naming, workflow. - **Dissent:** None. - **Effective:** Immediately (Round 15 onward). +### D-040: Wiki taxonomy structure — hierarchical with YAML frontmatter +- **Date:** 2026-02-11 +- **Decision:** The project maintains a wiki at `wiki/` with a hierarchical directory structure, YAML frontmatter metadata on every entry, and template-driven creation. The structure must be established NOW (project lead directive) and scale from v0.1 (1 system, 1 station, 15 NPCs) to full game (hundreds of systems, thousands of NPCs). +- **Directory structure:** + - `wiki/_templates/` — entry templates (star-system, station, district, location, character, faction, technology, cultural-group, contraband-type, lore-entry, institution, species, event, concept) + - `wiki/star-systems/` — spatial hierarchy (system → station → district → location) + - `wiki/characters/` — flat structure (characters move between locations) + - `wiki/factions/` — political and institutional bodies + - `wiki/technology/` — technology categories with tier sub-entries + - `wiki/cultural-groups/` — cultures, subcultures, movements + - `wiki/contraband/` — illegal/restricted goods + - `wiki/lore/` — historical events, concepts, cosmology + - `wiki/concepts/` — game-mechanical concepts with lore basis + - `wiki/_meta/` — naming conventions, style guide, cross-reference index +- **Design principles:** (1) Game-first, not encyclopedia-first — every entry serves the content pipeline. (2) Hierarchical with cross-references via IDs, not file paths. (3) Metadata-rich YAML frontmatter enabling programmatic queries. (4) Template-driven — new entries follow category templates. (5) Every entry has a `status` field: `proposed` → `draft` → `canonical`. +- **Governance:** Miri owns wiki structure (new categories, templates, structural decisions). Anyone can create entries within their domain following templates. Qatux maintains the index and cross-references. +- **Cross-reference:** Setting ([D-036](content.md#d-036-sova-transit-district--krenn-system-as-v01-setting)) +- **Raised by:** Miri (Round 2 proposal with full directory structure and 7 YAML schemas), project lead (non-negotiable, directive #5) +- **Dissent:** None + --- -*3 decisions. Last updated: 2026-02-11* +*4 decisions. Last updated: 2026-02-11* diff --git a/decisions/questions.md b/decisions/questions.md index c92c98da4..3c2e55a25 100644 --- a/decisions/questions.md +++ b/decisions/questions.md @@ -12,9 +12,9 @@ Tracked questions awaiting discussion or resolution. - **Assigned to:** Full team ### Q-003: Art direction / presentation style -- **Status:** Partially resolved for v0.1 (D-014: boxes with labels, atmosphere via dialog/interaction) -- **Remaining:** Long-term art direction beyond tech demo. -- **Assigned to:** TBD +- **Status:** Further resolved for v0.1 via Content Gap Analysis Workshop. Araminta's v0.1 Visual Grammar proposal covers: entity color palette (D-033), zone-specific color palettes (3 zones with hex values), fog rendering (4 states), monologue presentation spec, insert dual-character variants. Long-term art direction beyond v0.1 remains open. +- **Remaining:** Long-term art direction, sprite replacement timeline, full visual identity. +- **Assigned to:** Araminta (lead) ### Q-004: One campaign spanning all eras or separate era scenarios? - **Status:** Not yet discussed @@ -52,6 +52,42 @@ Tracked questions awaiting discussion or resolution. - **Question:** Which characters are playable in the prototype? How different are their starting positions? Can you play canon characters or only original ones? - **Assigned to:** Miri, Paula +### Q-012: Generation expansion method for dialogue +- **Status:** Open +- **Question:** How does the 4x generation expansion pass work? LLM-based, template-based, or rule-based? Affects how base lines are authored — LLM needs style-strong anchors; rules need substitution patterns. +- **Assigned to:** Gestalt, Mellanie +- **Source:** Content Gap Analysis Workshop (Mellanie R2) + +### Q-013: Line previewer temporal progression +- **Status:** Open +- **Question:** How does the line previewer (#193) handle THE FRIEND's multi-visit contradiction arc? Needs sequence mode to simulate interaction progression over multiple encounters. +- **Assigned to:** Gestalt, Dudley +- **Source:** Content Gap Analysis Workshop (Mellanie R2) + +### Q-014: Audio timing with monologue chime +- **Status:** Open +- **Question:** When does the monologue chime fire relative to text appearance? Before, simultaneous, or overlapping? Affects monologue line writing rhythm. +- **Assigned to:** Gestalt, Ozzie +- **Source:** Content Gap Analysis Workshop (Mellanie R2) + +### Q-015: Generation expansion for THE FRIEND content +- **Status:** Open +- **Question:** Does the 4x generation expansion apply to THE FRIEND's custom lines, or are all ~70-100 lines per FRIEND hand-authored? Recommendation: no expansion on FRIEND lines — risk of flattening hand-crafted voice. +- **Assigned to:** Mellanie, Gestalt +- **Source:** Content Gap Analysis Workshop (Ozzie R2, Gestalt R2) + +### Q-016: Knowledge hierarchy for monologue prerequisites +- **Status:** Open +- **Question:** Monologue prerequisites currently use binary flags (`knows: smuggling_operation`). Need a hierarchy: `suspects` < `knows_of` < `knows_details`. How granular? +- **Assigned to:** Gestalt, Paula +- **Source:** Content Gap Analysis Workshop (Gestalt R2) + +### Q-017: Triangle pressure threshold +- **Status:** Open +- **Question:** Triangles need a numeric pressure value that increases based on events. When it crosses a threshold, `confrontation` situation activates. What events increase pressure? What's the threshold? +- **Assigned to:** Gestalt, Paula +- **Source:** Content Gap Analysis Workshop (Gestalt R2) + --- -*11 questions (3 resolved, 2 partially resolved, 6 open). Last updated: 2026-02-11* +*17 questions (3 resolved, 2 partially resolved, 12 open). Last updated: 2026-02-11*