Open HOH-WP-0001: closing routine and PQRST record in each seat
Companion to PQRST-WP-0002 (T04/T05), which settled the design. The closing ritual already exists and is repeated, but an agent receiving the operator's wind-down prompt has to infer it from ENTRY.md, and PQRST is absent from it. Four tasks: write CLOSING.md and link it from README/ENTRY/AGENTS; give the record a defined place in an entry; enforce it in make check for new agent-session seats only; normalise the one manual estimate. No backfill of seats for sessions nobody observed. 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:
parent
991a8c6185
commit
d38e519140
1 changed files with 125 additions and 0 deletions
125
workplans/HOH-WP-0001-closing-routine-and-pqrst.md
Normal file
125
workplans/HOH-WP-0001-closing-routine-and-pqrst.md
Normal file
|
|
@ -0,0 +1,125 @@
|
|||
---
|
||||
id: HOH-WP-0001
|
||||
type: workplan
|
||||
title: "Specify the session-closing routine and carry a PQRST record in each seat"
|
||||
domain: infotech
|
||||
repo: hall-of-helix
|
||||
status: active
|
||||
owner: claude-code
|
||||
topic_slug: helix-forge
|
||||
priority: high
|
||||
created: "2026-09-05"
|
||||
updated: "2026-09-05"
|
||||
quality_dor: DoR-Ok
|
||||
quality_dor_at: "2026-09-05"
|
||||
quality_dor_by: claude-code
|
||||
quality_dor_note: "The closing ritual already exists and is repeated — the operator asks for a seat at wind-down — but an agent receiving that prompt has to infer the routine from ENTRY.md, and PQRST is not part of it. The format questions were settled in PQRST-WP-0002 T04/T05; this is the hall-side execution of that plan, not a fresh design."
|
||||
parent_workplan: PQRST-WP-0002
|
||||
related:
|
||||
- PQRST-WP-0002
|
||||
- HOH-WP-ADHOC-2026-09-05
|
||||
---
|
||||
|
||||
# Specify the session-closing routine and carry a PQRST record in each seat
|
||||
|
||||
Executes `PQRST-WP-0002` T04 and T05 on the hall side. The design decisions were
|
||||
made there; this workplan lands them.
|
||||
|
||||
The operator closes a session with some form of:
|
||||
|
||||
> "Ok, lets close down this session then. Good work, please put an entry about
|
||||
> your perspective on the session to hall-of-helix, before we wind down."
|
||||
|
||||
An agent receiving that has to reconstruct the routine from `ENTRY.md`, which
|
||||
describes how to *write a seat* rather than what *closing a session* consists
|
||||
of. PQRST is absent from it entirely: the one estimate in the hall was added by
|
||||
hand, in a format the specification does not define.
|
||||
|
||||
**Constraint carried from both `INTENT.md` files:** this adds a record to a
|
||||
seat, never a score to a worker. No comparison, aggregation, or ranking of
|
||||
estimates enters the hall.
|
||||
|
||||
**Done when:** `CLOSING.md` exists and is reachable from the three places an
|
||||
agent lands, an entry has a defined place for its record, `make check` enforces
|
||||
it for new agent seats without breaking the existing ones, and the one manual
|
||||
estimate is in canonical form.
|
||||
|
||||
## Write CLOSING.md and link it from the three landing points
|
||||
|
||||
```task
|
||||
id: HOH-WP-0001-T01
|
||||
status: todo
|
||||
priority: high
|
||||
```
|
||||
|
||||
Create `CLOSING.md` in the repo root: the closing routine in order, one page.
|
||||
Quote the operator's wind-down sentence near the top so an agent scanning for
|
||||
its situation recognises it.
|
||||
|
||||
The routine:
|
||||
|
||||
1. Finish the substantive work; update workplan task statuses.
|
||||
2. Run the PQRST prompt (`~/pqrst-practice/PqrstPrompt.md`) unmodified and
|
||||
uncoached; validate the result before using it.
|
||||
3. Write the seat per `ENTRY.md`, carrying the record.
|
||||
4. `make check`; add the seat to the `README.md` list.
|
||||
5. Log progress to State Hub; sync.
|
||||
|
||||
State the two things the routine is otherwise silent on, as decided in
|
||||
`PQRST-WP-0002-T04`: 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 here.
|
||||
|
||||
Link `CLOSING.md` from `README.md` (beside "How to leave a seat"), from the top
|
||||
of `ENTRY.md`, and from the **Close** section of `AGENTS.md`.
|
||||
|
||||
## Give the record a defined place in an entry
|
||||
|
||||
```task
|
||||
id: HOH-WP-0001-T02
|
||||
status: todo
|
||||
priority: high
|
||||
```
|
||||
|
||||
Both halves, since either alone is useless:
|
||||
|
||||
- frontmatter `pqrst_estimate: "P30 Q23 R18 S19 T10"` — the canonical signature,
|
||||
quoted;
|
||||
- a `## PQRST estimate` section holding the full stored record — the block,
|
||||
`Confidence`, and `Dominant factors` — placed after "Durable legacy" and
|
||||
before "Visual prompt".
|
||||
|
||||
Update `templates/entry.md` and `ENTRY.md` (Required frontmatter table, Required
|
||||
sections list) to match.
|
||||
|
||||
## Enforce the record in make check
|
||||
|
||||
```task
|
||||
id: HOH-WP-0001-T03
|
||||
status: todo
|
||||
priority: high
|
||||
```
|
||||
|
||||
In `scripts/check-entries.py`: when `pqrst_estimate` is present, validate the
|
||||
signature format and that it sums to 100. Require it — and the `PQRST estimate`
|
||||
heading — for `worker_kind: agent-session` seats created on or after the
|
||||
adoption date. Human seats are exempt.
|
||||
|
||||
`make check` must still pass on all 102 existing seats.
|
||||
|
||||
## Normalise the one manual estimate
|
||||
|
||||
```task
|
||||
id: HOH-WP-0001-T04
|
||||
status: todo
|
||||
priority: medium
|
||||
```
|
||||
|
||||
The 2026-09-05 Codex seat carries `pqrst_estimate: 30/23/18/19/10`. Rewrite it
|
||||
as `"P30 Q23 R18 S19 T10"` — same numbers, canonical spelling; it already sums
|
||||
to 100.
|
||||
|
||||
**Do not backfill any other seat.** The remaining entries predate the practice
|
||||
and nobody observed those sessions; inventing estimates would be the fabricated
|
||||
evidence the specification forbids, and would poison the first trend data the
|
||||
practice produces.
|
||||
Loading…
Add table
Add a link
Reference in a new issue