Consolidates all connector scripts under tooling/ per project structure conventions. Symlink at db/connectors → tooling/db/ preserves backwards compatibility (remove after Sprint 22). Updated references in CLAUDE.md, Makefile, DEVOPS.md, all skill files, agent files, rules, schema comments, and Sprint 21 briefings. Python scripts updated with correct SCHEMA_PATH (now relative to WORKTREE_ROOT/db/schema.sql). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
44 lines
2.4 KiB
Markdown
44 lines
2.4 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 | Q-001 through Q-050 |
|
|
| [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.*
|