jpmschweitzerandClaude Opus 4.6
4f5ee0274b
Replace monolithic 474-line DECISIONS.md with 7 domain files under decisions/: architecture, perception, content, scope, process, questions, rejected. Each file owns its decisions with cross-reference hyperlinks. Root DECISIONS.md becomes a redirect with domain index. Reduces per-agent context load by ~70-80% (80-150 lines vs 474). Taxonomy: architecture (D-008..D-031), perception (D-011..D-019), content (D-023..D-029), scope (D-001..D-027), process (D-004..D-022), questions (Q-001..Q-011), rejected (R-001..R-010). Restores D-002 original text (was a tombstone referencing D-005). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
44 lines
1.9 KiB
Markdown
44 lines
1.9 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 |
|
|
| [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 |
|
|
| [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
|
|
db/connectors/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.*
|