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

docs(meta): repoint decisions/ paths to governance/ tree (pql migration)

Browse Source 
Phase 1 follow-up: update the active instruction layer (CLAUDE.md, project
structure rule, DECISIONS.md redirect, agent personalities, skill docs) to
reference governance/{decisions,questions,rejected}/<domain>.md instead of the
retired flat decisions/*.md layout.

Path references only — command-surface references (tooling/db/decision*,
decisions-sync, Makefile targets, clerk) are repointed to the pql CLI in the
Phase 4 consumer cutover. Historical archives (docs/sprints, docs/discussions,
docs/workshops) keep their point-in-time decisions/ paths; the separate
whatsinagame/ template distribution is untouched. Agent-memory is gitignored
and out of scope.

The agent/skill repath was applied by tooling/pql-migrate/repath_references.py
(ordered, meaning-preserving replacements; bare-dir rule uses a negative
lookbehind so it can't corrupt a freshly-created governance/decisions/ path),
committed for provenance. CLAUDE.md, project-structure.md, and DECISIONS.md
were hand-edited (structural tree/table changes).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
jpmschweitzer
2026-06-06 12:18:49 +02:00
co-authored by Claude Opus 4.8
parent f936e503da
commit 05d7bffd6f
25 changed files with 137 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files
DECISIONS.md
+17 -13
View File
@@ -1,17 +1,21 @@
# Decisions Archive
Decisions have been reorganized by domain. See:
- [decisions/README.md](decisions/README.md) for the domain index
- Individual domain files in `decisions/`
Decision records live in the **pql DQR governance tree**, split by type and domain:
| File | Domain | Count |
|------|--------|-------|
| [architecture.md](decisions/architecture.md) | Technical foundation | 8 |
| [perception.md](decisions/perception.md) | Player observation | 6 |
| [content.md](decisions/content.md) | NPC, dialogue, templates | 5 |
| [scope.md](decisions/scope.md) | Game concept, prototype | 9 |
| [process.md](decisions/process.md) | Team, workflow | 3 |
| [questions.md](decisions/questions.md) | Open questions | 11 |
| [rejected.md](decisions/rejected.md) | Rejected alternatives | 10 |
- [governance/README.md](governance/README.md) — domain guide + pql-maintained record index
- `governance/decisions/<domain>.md` — confirmed decisions (D-NNN)
- `governance/questions/<domain>.md` — open questions (Q-NNN)
- `governance/rejected/<domain>.md` — rejected alternatives (R-NNN)
*Restructured 2026-02-11. Original monolithic format in git history.*
Domains: `architecture`, `content`, `economics`, `perception`, `process`, `scope`.
Query the records with pql instead of grepping files:
```bash
pql decisions list # every record
pql decisions show D-010 --with-tickets # a record + implementing tickets
pql decisions read D-238 # full markdown body
```
*Restructured into the governance/ DQR tree 2026-06-06 (pql migration). Earlier
flat `decisions/*.md` layout and the original monolithic format are in git history.*