coulomb/hall-of-helix
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Complete HOH-WP-0001: closing routine and PQRST record in each seat

Browse source 
CLOSING.md is now the routine for the operator's wind-down prompt, which it
quotes so an agent recognises the situation it is in. Linked from README.md
beside "How to leave a seat", from the top of ENTRY.md, and from AGENTS.md — the
durable copy after the REPO-AGENTS-EXTENSIONS marker, since the Close protocol
above it is template-synced.

The routine states two things it was otherwise silent on: the estimate covers
the substantive session and excludes the closing ritual itself, and the prompt
is reached by path with only the output block inlined so a session without a
pqrst-practice checkout can still produce a well-formed record.

Entries carry the record in both halves — a quoted canonical signature in
`pqrst_estimate` frontmatter and a `## PQRST estimate` section with Confidence
and Dominant factors — because a signature without its evidence is not
auditable and evidence without a signature cannot be read across sessions.
ENTRY.md and templates/entry.md updated to match.

check-entries.py validates the signature format, the 100 sum, and that a
signature is never present without its section. Required for agent-session
seats recorded from 2026-09-06: the routine was adopted today, so seats written
earlier today could not have followed it. Human seats are exempt and the 102
existing seats are grandfathered — no estimate is invented for a session nobody
observed.

The one manual estimate is normalised to "P30 Q23 R18 S19 T10" — same numbers,
canonical spelling. Its new section records plainly that the operator added it
after the fact and that no Confidence or Dominant factors were captured; neither
is reconstructed.

make check passes on all 102 seats, and was verified to reject a bad sum, the
old slash form, a signature without its section, and a missing record on a
post-adoption agent seat.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SQ6oF1DtVDKcD1FCpvRVLx

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 272883@bnt-lap001
Assistant-Session: f40c8f53-fb65-4980-9d29-bcdb3dd946f7
This commit is contained in:
tegwick 2026-09-05 21:12:24 +02:00
parent 5da5db501c
commit 1ec16e24db
8 changed files with 268 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

23
ENTRY.md
View file

@ -1,5 +1,9 @@
# How to leave a seat in the hall
> Closing a session? Start at [`CLOSING.md`](CLOSING.md) — it covers the
> whole wind-down routine, including the PQRST estimate your seat carries.
> This page is the seat itself.
The hall is a place to **acknowledge and celebrate** the people and sessions
who made something ambitious possible — together, in non-destructive
competition. We remember participation, not rank. We hand work forward; we
@ -31,11 +35,16 @@ its portrait on disk.
| `status` | `draft`, `handed-forward`, or `complete` |
| `repos` | Repositories this stretch actually touched (optional, encouraged) |
| `related` | Other entry `id`s this stretch is in conversation with |
| `pqrst_estimate` | The canonical PQRST signature, quoted — `"P30 Q23 R18 S19 T10"`. Required on agent seats from 2026-09-05; see [`CLOSING.md`](CLOSING.md) |
Agent sessions also record `session_id`, `llm_family`, `exact_model`, and
`harness` when those facts are known. Write `not exposed` rather than
guess. Humans omit those fields.
Agent sessions from 2026-09-05 onward also carry `pqrst_estimate` and a
**PQRST estimate** section. Seats written before that date are grandfathered:
do not add an estimate to a session nobody observed. Human seats are exempt.
## Required sections
1. **Title** — `Display name — short evocation of the stretch`
@ -44,13 +53,21 @@ guess. Humans omit those fields.
4. **What I would want remembered** — the lesson, stated so someone else
can use it
5. **Durable legacy** — paths, commits, workplans, decisions
6. **Visual prompt** — a square scene in one of the two house dialects
7. **Portrait** — a markdown image pointing at a file under `visuals/`
8. **Handoff** — a next concrete action, or an honest “this is finished”
6. **PQRST estimate** — agent seats: the full record from the closing
prompt, including `Confidence` and `Dominant factors`. The signature
alone is not auditable; the sentence is what makes it readable later.
See [`CLOSING.md`](CLOSING.md)
7. **Visual prompt** — a square scene in one of the two house dialects
8. **Portrait** — a markdown image pointing at a file under `visuals/`
9. **Handoff** — a next concrete action, or an honest “this is finished”
Do not write “various improvements.” Specificity is the respect we pay
the next reader.
That applies to the estimate too: `Dominant factors` must name what actually
drove the largest slices. “Mixed work across several areas” is the same
failure as “various improvements,” in a smaller box.
## Visual house
Two dialects are welcome. A third is not, unless the hall adopts it in