Files
Pouya LajevardiandClaude Opus 5 fd5f610982 feat: D19 bounds the review loop; apply nine rulings; close Q46(a) and Q48–Q53
D19 into §3 and swept to all six destinations Pouya named: both agent briefs
(scope + severity filter), /build Phases 2–4 (non-gating questions, scope, stop
signal, two-round cap), /wrap, and CLAUDE.md (comments record decisions, not
history). Sweep verified by command, not recalled.

Rulings applied:
  Q46(a) PUBLISHABLE — three §4 Offerings rows flipped; gate 1 records
         [Pouya's stated basis], never [verified]. Step 5 unblocked.
  Q48    closed, not site-relevant.
  Q49    one §4 row, "Mediator"; read as declining Q49(b), so worksFor stays out.
  Q50    DEVIATES — ships as name + slogan, not the concatenation. Flagged.
  Q51    OBA sections stay; the regulator/voluntary distinction recorded.
  Q52    docs/reference/deploy-credential-verification.md — 18 read-only AWS
         calls, re-run rather than transcribed, access key ID redacted.
  Q53    memberOf emitted on /about/'s Person node.

Two review rounds. The headline finding was this session's own: the Q53 sweep
was asserted and never run, leaving six in-scope records saying memberOf was
withheld — including §12 R10, which is read aloud every session. Round 2 then
found that round 1's simplification had put memberOf on / as well; the per-page
opt-in is restored, because Pouya's ruling turns on /about/'s visible HTML.

Also fixed: MEMBERSHIP_ORGS had orphaned BOUTIQUE's D16 JSDoc; /'s title now
derives from the constants; §7's deploy row stated and retracted three facts.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0148NztQskLKKApP5SzAA78e
2026-08-28 15:52:52 -04:00

2.3 KiB

description
description
End-of-session ritual — update AGENTS.md under its constitution and hand back a clean state.

Close out this session properly. The working file is the deliverable that outlives the session; a session that ends without updating it has lost its reasoning.

  1. Re-read AGENTS.md — the constitution at the top, then Current Truth.

  2. Update Current Truth in place wherever this session made a section stale: environment, decisions, the §4 register, open questions, risks. Re-stamp any fact you re-verified with today's date. A stale date means it needs re-checking, so do not leave a date you did not earn.

  3. Append one Change Log entry, newest first, covering:

    • what was discussed, decided, changed, or planned — decisions and plans count even if no code was written
    • old → new for every change, and why
    • findings you declined, with the reasoning
    • anything deferred, and where it is now tracked
    • questions closed and questions opened, by number

    Never edit a past entry. If something earlier was wrong, correct it in today's entry and leave the original as written.

    Any claim that a change was applied across files must cite the command and be written only after reading its output. Paste the grep. Recall is not evidence — three entries on this project asserted a completed sweep and instances survived all three, one of them inside the definition of the agent whose job is to catch it.

  4. Do not open a numbered question for something that gates nothing — D19. The Q-series is past 50 and most recent additions gate nothing. If it does not block a page, a deploy or a claim, it belongs in this entry as a note, not in §9 as a number — and retire the non-gating ones you find while you are in there. Pouya's ruling, 2026-08-28.

  5. Check §12 Standing Reminders. Is anything now due? Should something new be added — a decision Pouya parked, or one you made on his behalf that he has not yet ratified?

  6. Leave the tree clean. git status should show only intended changes. No stray build output, no .env, no credentials, no aws-inventory.txt.

  7. Report: what changed in AGENTS.md, what is open, and the single most useful next action.