jpmschweitzerandClaude Opus 4.6
f63691069c
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>
48 lines
3.0 KiB
Markdown
48 lines
3.0 KiB
Markdown
# Decisions
|
||
|
||
Confirmed decisions, open questions, and rejected alternatives for The Settled Reach.
|
||
|
||
Decisions are split by domain. Each agent's briefing indicates which files to read. When in doubt about where a decision belongs: if it constrains **how we build**, it's architecture. If it defines **what we build**, it's scope. If it defines **what the player experiences**, it's content or perception. If it defines **how the team works**, it's process.
|
||
|
||
Cross-domain decisions live in one file with cross-reference notes in related files. Split threshold: when any file exceeds ~350 lines, review whether it should split.
|
||
|
||
## Domain Files
|
||
|
||
| 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, D-041, D-042, D-054, D-055, D-066, D-068, D-073, D-085, D-088, D-094, D-096, D-097, D-099, D-100, D-101, D-102, D-103, D-106, D-108, D-109 |
|
||
| [perception.md](perception.md) | Player observation | D-011, D-015, D-016, D-017, D-018, D-019, D-033, D-035, D-043, D-044, D-045, D-046, D-047, D-048, D-049, D-052, D-056, D-057, D-058, D-059, D-060, D-061, D-067, D-069, D-070, D-071, D-072, D-076, D-077, D-078, D-086 |
|
||
| [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, D-050, D-062, D-063, D-064, D-074, D-075, D-084, D-090, D-092, D-093, D-095, D-098, D-104, D-105, D-107 |
|
||
| [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, D-051, D-053, D-065, D-087, D-089, D-091 |
|
||
| [process.md](process.md) | Team, workflow | D-004, D-021, D-022, D-040 |
|
||
| [questions.md](questions.md) | Open questions (index) | Q-001 through Q-054 |
|
||
| [questions-architecture.md](questions-architecture.md) | Technical questions | Q-001, Q-006, Q-009, Q-018–Q-023, Q-029, Q-030, Q-046 |
|
||
| [questions-perception.md](questions-perception.md) | Observation questions | Q-003, Q-014, Q-016, Q-024–Q-026, Q-051, Q-053, Q-054 |
|
||
| [questions-content.md](questions-content.md) | Narrative questions | Q-010, Q-012–Q-015, Q-017, Q-028, Q-031, Q-033, Q-040–Q-050, Q-052 |
|
||
| [questions-scope.md](questions-scope.md) | Scope questions | Q-002, Q-004, Q-005, Q-007, Q-008, Q-011, Q-027, Q-032, Q-034–Q-039 |
|
||
| [rejected.md](rejected.md) | Rejected alternatives | R-001 through R-010 |
|
||
|
||
## Querying Decisions
|
||
|
||
The SQLite database contains a `decisions` table synced from these files. Common queries:
|
||
|
||
```bash
|
||
# All active architecture decisions
|
||
tooling/db/sqlite-query "SELECT id, title FROM decisions WHERE domain='architecture' AND status='active'"
|
||
|
||
# Decisions without implementing tickets
|
||
make decisions-orphan
|
||
|
||
# Decision coverage by domain
|
||
make decisions-coverage
|
||
```
|
||
|
||
## Adding a Decision
|
||
|
||
1. Edit the appropriate domain file
|
||
2. Follow the existing format (`### D-NNN: Title` heading)
|
||
3. Commit — the pre-commit hook runs `decisions-sync` automatically
|
||
4. Update relevant agent briefings if needed
|
||
|
||
*Maintained by Qatux.*
|