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>
912 B
912 B
Decisions Archive
Decision records live in the pql DQR governance tree, split by type and domain:
- 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:
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.