coulomb/pqrst-practice
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Close PQRST storage decision and record pilot blockers

Browse source 
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a0e759-301a-78b1-bbc1-040ef094b12d
This commit is contained in:
tegwick 2026-09-28 11:32:41 +02:00
parent 7d070310e1
commit 37b49a9517
4 changed files with 109 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

43
docs/adr/0002-record-storage-boundary.md Normal file
View file

@ -0,0 +1,43 @@
# ADR-002 — Record storage boundary
**Status:** accepted 2026-09-28
**Work:** PQRST-WP-0002-T02
**State Hub decision:** `dc5d49d5-8b79-4c57-a1a8-78c3532082fc`
## Decision
Use **hall-of-helix as the default human-facing store** when a session closes
with a voluntary hall entry. The hall owns entry storage, its closing routine,
and consumer validation. This repository owns the normative specification and
canonical prompt; it stores neither session records nor collection tooling.
The hall is not the only permitted store. Sessions without a seat may retain
their records in a consuming repository's chosen external store. No separate
machine-facing collector is selected or commissioned by this decision. Any
future collector and its operation belong to the consuming repository, with
the full evidence-bearing record preserved alongside its session metadata.
## Evidence and tradeoffs
Reviewed hall-of-helix at commit
`82caae23b3098aa4bdf4346cd4af8a88c03c7d68`: `CLOSING.md` references the canonical
prompt, `ENTRY.md` defines the signature and body record, and
`scripts/check-entries.py` checks signatures and requires PQRST on finished
agent seats from 2026-09-06. Existing entries carry repository and session
metadata as well as concrete dominant factors. The hall checker is not proof
of every spec §5.5 condition or of an uncoached first attempt.
Seats are voluntary, and drafts may lack records. The collection is a biased
sample, not a session census. Qualitative review and Markdown searches are
sufficient for current use; the hall is not a metrics warehouse. Neither the
hall nor this practice ranks agents, models, developers, or teams by PQRST.
## Consequences
The storage question can close independently of the pilot. No spec meaning,
validation rule, or record format changes, so v0.1 remains in force. The
eight-session first-attempt pilot and the subsequent version decision remain
under the existing T01 and T03; this decision does not establish their outcome.
See [SCOPE.md](../../SCOPE.md) and the
[existing workplan](../../workplans/PQRST-WP-0002-validate-v01-against-real-sessions.md).