jpmschweitzer/settled-reach
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(decisions): add D-040 wiki taxonomy and Q-012 through Q-017

Browse Source 
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:
jpmschweitzer
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
Download Patch File Download Diff File Expand all files Collapse all files
decisions/process.md
+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*