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 <noreply@anthropic.com>
This commit is contained in:
2026-02-11 20:28:17 +01:00
co-authored by Claude Opus 4.6
parent 17ea8a49a1
commit 36ffd3f6fa
3 changed files with 66 additions and 10 deletions
+5 -5
View File
@@ -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
+21 -1
View File
@@ -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*
+40 -4
View File
@@ -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*