Files
settled-reach/decisions/questions.md
T
jpmschweitzerandClaude Opus 4.6 f63691069c docs(docs): split questions.md into per-domain files
Mirror the D-record pattern: questions.md becomes an index,
full question content moves to questions-architecture.md,
questions-perception.md, questions-content.md, questions-scope.md.

Also incorporates final Sprint 22 team findings into Q-053/Q-054:
- Q-053: transit map as incidental discovery surface, confidence
  signal, boards as entitlement map (Paula round 3)
- Q-054: stateless DiagramData renderer architecture, annotation
  event model (Gestalt round 3)

Corrects question counts: 16 resolved, 4 partially resolved,
34 open (previously undercounted).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-28 13:25:22 +01:00

37 lines
1.9 KiB
Markdown

# Open Questions
Tracked questions awaiting discussion or resolution. Split by domain, mirroring the D-record structure.
## Domain Files
| File | Domain | Questions |
|------|--------|-----------|
| [questions-architecture.md](questions-architecture.md) | Technical foundation | Q-001, Q-006, Q-009, Q-018, Q-019, Q-020, Q-021, Q-022, Q-023, Q-029, Q-030, Q-046 |
| [questions-perception.md](questions-perception.md) | Player observation | Q-003, Q-014, Q-016, Q-024, Q-025, Q-026, Q-051, Q-053, Q-054 |
| [questions-content.md](questions-content.md) | Narrative, NPCs, setting | Q-010, Q-012, Q-013, Q-015, Q-017, Q-028, Q-031, Q-033, Q-040, Q-041, Q-042, Q-043, Q-044, Q-045, Q-047, Q-048, Q-049, Q-050, Q-052 |
| [questions-scope.md](questions-scope.md) | Game concept, prototype | Q-002, Q-004, Q-005, Q-007, Q-008, Q-011, Q-027, Q-032, Q-034, Q-035, Q-036, Q-037, Q-038, Q-039 |
## Status Summary
| Domain | Total | Resolved | Partial | Open |
|--------|-------|----------|---------|------|
| Architecture | 12 | 6 | 1 | 5 |
| Perception | 9 | 5 | 1 | 3 |
| Content | 19 | 5 | 1 | 13 |
| Scope | 14 | 0 | 1 | 13 |
| **Total** | **54** | **16** | **4** | **34** |
## Adding a Question
1. Claim an ID: `tooling/db/decision claim Q questions "title"`
2. Edit the appropriate domain file (`questions-{domain}.md`)
3. Follow the existing format (`### Q-NNN: Title` heading)
4. Update the domain file footer count
5. Update this index: add the ID to the domain table row, update status summary
## Domain Guide
When in doubt about where a question belongs: if it constrains **how we build**, it's architecture. If it defines **what the player observes or knows**, it's perception. If it defines **narrative, NPCs, dialogue, or setting**, it's content. If it defines **what we ship or how big it is**, it's scope.
*54 questions. Last updated: 2026-02-28 (split from single file into domain files).*