jpmschweitzerandClaude Opus 4.8
05d7bffd6f
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>
22 lines
912 B
Markdown
22 lines
912 B
Markdown
# Decisions Archive
|
|
|
|
Decision records live in the **pql DQR governance tree**, split by type and domain:
|
|
|
|
- [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)
|
|
|
|
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.*
|