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:
+5
-5
@@ -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
@@ -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
@@ -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*
|
||||
|
||||
Reference in New Issue
Block a user