@thebassclef/lite 1.0.4 → 1.1.1

package/dist/lite/.claude/skills/longrun/SKILL.md

@@ -0,0 +1,512 @@
+---
+name: longrun
+description: "Run a long autonomous session that paces itself. Prepares scope. Checkpoints at phase boundaries. Closes with session log and retrospective. Three modes: prep, checkpoint, closeout."
+problem: "Sessions over 50 turns drift. Context compacts and the goal disappears."
+value: "A long autonomous session that paces itself. Prep and checkpoint and closeout \u2014 clean state every wake."
+inputs: [prep or checkpoint or closeout mode plus scope hints]
+outputs: [Goal doc with time budget, Checkpoint status at phase boundaries, Session log at closeout]
+tier: lite
+modes: [prep, checkpoint, closeout]
+composes_with: [value-prop, kiss, temperance, luminary, roadmap-reconcile, retro, promote, session-end, chronicle, pattern-review]
+authoring_luminaries:
+  primary:
+    - john-ousterhout
+    - sophia-prater
+  supporting:
+    - alistair-cockburn
+    - don-norman
+    - edward-tufte
+    - jason-fried-dhh
+    - amazon-pr-faq
+    - kent-beck
+    - linus-torvalds
+---
+
+# /longrun
+
+## What you get
+
+A long autonomous session that stays on track. You type `/longrun prep` once at session start. I set up scope, land the goal doc, touch gate markers, and start work. I checkpoint at every phase boundary, after each compaction, and every 25 steps. At close I write the session log, update whereami, run the retrospective, and open the PR. You get one clean landing when I finish — not a session that drifts mid-way.
+
+## When to use it
+
+Use `/longrun` when any of these hold:
+
+- Two or more goals in flight this session
+- Estimated more than 50 steps of work
+- The session will cross at least one context compaction
+- You state "longrun" explicitly
+
+<!-- FKGL-EXEMPT: mirrors precedent shape from /shape /spec /build /launch /decompose per bassclef-upstream#1363 — literal header + prose required by scripts/tests/adr-consult-step.test.sh -->
+## ADR-consult — fire before scope confirmation (per bassclef-upstream#424)
+
+Read every relevant ADR in `architecture/decisions/` before confirming scope. If your scope deviates from any ADR's decision or constraints, surface the deviation as the first agenda item — operator decides amend-ADR vs. revise-scope.
+
+Per `.claude/rules/adr-discipline.md`. Mechanism: `adr-discipline-check.sh` fires on substantive architectural edits (wired in `.claude/settings.json` since goal 28a Step 1). The Tier 0 test for this step greps for the literal header `## ADR-consult — fire before scope confirmation` in each of `/build /launch /spec /decompose /shape /longrun`.
+<!-- /FKGL-EXEMPT -->
+
+## Tier gate (bassclef#740 Task 1.4; amended bassclef#1383)
+
+`/roadmap-reconcile` and `/retro` both flipped to `tier: lite` as deep modules per canvas 2026-07-19-bassclef-lite Q6 Option E. Both run identically at every tier. Prep Step 0.5 and Closeout Step 2 run as documented for every adopter — lite, standard, and ultra.
+
+The tier-check pattern below stays available for future skills that need per-tier branching:
+
+```bash
+source lib/tier-check.sh
+tier=$(resolve_adopter_tier)
+```
+
+Per canvas 2026-07-19-bassclef-lite Q6 Option E — one SKILL.md file, same name in both tiers. When a skill's body genuinely diverges per tier, the body carries runtime tier awareness with graceful degrade. Skills that share behavior across tiers stay simple and drop the branch.
+
+For single-goal sessions under 50 steps with no compaction risk, use `/autonomous start` directly. `/longrun` adds prep and checkpoint discipline whose overhead exceeds value on shorter work.
+
+## Composes with — cluster shape
+
+`/longrun` sits at the center of a larger cluster. Skills around it feed in, close out, or fire mid-session as helpers.
+
+**Upstream — feed the session:**
+
+- Discovery layer (Sam bootstrap, Louis kickoff): `/interview-me`, `/extract-intent`, `/interpret-input`, `/empathy-map`, `/jtbd-tasks`, `/lean-canvas`, `/value-prop-canvas`, `/personas`
+- Strategy authoring (mid-session per persona): `/state-a-problem`, `/value-prop`, `/requirement`, `/use-case`, `/user-stories`, `/spec`, `/ticket`
+
+**Downstream — close the session:**
+
+- `/session-log` — write the session's log entry
+- `/session-end` — tiered obligations (must + should + may)
+
+**Helpers — fire mid-session across every stage:**
+
+- 5 gates — `/temperance`, `/verify`, `/diagnose`, `/kiss`, `/luminary`
+
+The verb is porcelain (Git's word for a small user-typed command). All discipline runs by composition inside — you type `/longrun` and the cluster runs itself.
+
+Strategy skills serve Sam AND Louis directly. Sam types `/state-a-problem` when a ticket needs a problem opener. Louis types `/lean-canvas` when designing a business shape. They stand alone at lite. `/longrun` composes them per stage of a spec-authoring session.
+
+## FAQ
+
+### What are the three modes?
+
+- **prep** — you type this once at session start. I set up scope, mount the goal doc, touch markers, and confirm ready state.
+- **checkpoint** — I fire this on my own at phase boundaries, after compaction events, every ~25 steps, or when a step exceeds 1.5× its time budget. Updates the session board; audits for `/promote` candidates; reports status.
+- **closeout** — I fire this when the Stop hook fires or you invoke `/session-end`. Runs `/retro`, files missed `/promote` items, extracts insights, updates whereami, then runs `/session-end`.
+
+### What is the default configuration?
+
+Orchestrator-gated and sequential. You only step in at real decision points — phase boundaries, PR merges, scope beyond time budget (the steps you'll spend at your current pace before cutting scope), hard ceilings, production deploy approvals. Everything else runs on its own.
+
+I read `longrun.orchestrator_merge.mode` from `.claude/bassclef-configs.jsonc`:
+
+- `operator-gated` (default) — every PR pauses for your review.
+- `agent-merges-within-scope` — I merge PRs on my own when the change stays inside the goal's scope and does not hit a hard ceiling.
+
+Hard ceilings are not overridable: `auth`, `schema`, `security`, `prod-deploy`, `blast-radius-floor`.
+
+### What are the checkpoint triggers?
+
+- **Phase boundary** — the last step in a phase lands. I re-fire session `/temperance`. I update the session board.
+- **Post-compaction** — a compaction event fires. I re-read the survival kit and re-anchor on the goal.
+- **Turn-counter** — every ~25 steps. Verify no scope drift; surface budget status.
+- **Context saturation** — I self-check for context pressure (large file reads, broad codebase exploration, test output accumulation). Fires proactively before the system compacts.
+- **Scope drift** — a step exceeds its time budget × 1.5. Pause and re-anchor.
+- **/promote audit** — I detected a bug in the rules or a pattern to file. Do it now; do not defer to closeout.
+
+### How does /longrun compose with other skills?
+
+| Skill | Where it fires |
+|---|---|
+| `/temperance` | Prep (scope anchor), checkpoint (re-anchor) |
+| `/luminary` | Prep (pick lenses), applied at authoring |
+| `/retro` | Closeout (retrospective) |
+| `/promote` | Checkpoint (proactive), closeout (audit backstop) |
+| `/session-end` | Closeout (extends; does not replace) |
+| `/whereami` | Closeout (update at session end) |
+| `/sprint` | Post-compaction checkpoint (re-orient) |
+| `/session-log` (formerly `/chronicle`) | Closeout (write narrative record) |
+| `/autonomous start` | Prep delegates after pre-flight clears |
+
+### How is /longrun distinct from /retro, /autonomous start, and /session-end?
+
+- `/retro` covers a single goal at end only. No `/promote` audit; no insight extraction. `/longrun closeout` builds on `/retro` and adds those two.
+- `/autonomous start` boots agents but does not manage the reflection cycle. `/longrun prep` delegates to `/autonomous start` AFTER installing the reflection scaffolding.
+- `/session-end` covers tiered obligations (MUST/SHOULD/MAY). `/longrun closeout` runs `/retro`, files `/promote` items, extracts insights, then runs `/session-end`.
+
+### How does the operator dispatch each mode?
+
+You type `/longrun prep` once. Checkpoint and closeout fire on their own. Overrides:
+
+- `/longrun checkpoint --now` — you noticed a pattern and want to anchor before the next auto-firing.
+- `/longrun closeout --now` — you want to end deliberately before Stop fires.
+
+Unknown args are rejected with a helpful message. `/longrun` does NOT silently proceed with defaults.
+
+## Details below the fold
+
+### Prep procedure — you type once at session start
+
+**Step 0** — Open with a `/value-prop tweet` claim and a `/kiss words` grade-10 summary before any tables land. The operator scans on mobile; the tables come after.
+
+**Step 0.4** — Read `docs/whereami.md` before scope confirmation. Post the line that shows the read landed: `**Whereami read:** docs/whereami.md at <ISO timestamp>`. Whereami is the source of truth for in-flight work.
+
+**Step 0.5** — Dispatch `/roadmap-reconcile --dry-run`. Silent when no drift. Surface the diff inline when drift is detected; wait for operator acknowledgement, canvas amend, or explicit deferral.
+
+**Step 0.6** — Read related goals across repos. Read the active goal's `parent_drivers`, `acceptance`, and `out_of_scope`. Read each parent goal up the chain until there is no parent. Read `parent_roadmap` if any goal in the chain has one. Touch `state/markers/orientation-gate/<branch-slug>.marker`.
+
+**Step 0.65** — Complete lookback. List every open item before you pick scope. `parent_drivers` names what the parent knew. This step names what is open now. Closes bassclef-upstream#776.
+
+Cover each class:
+
+- Every ticket named in whereami recap sections. The `operator_recap` and `prior_operator_recap` blocks list them by number.
+- Every entry from a grade audit that reads above the ceiling.
+- Every deferred, paused, or stuck item from a prior recap.
+- Every canvas at `docs/canvases/` and curation doc at `docs/curation/`.
+- Every consultation output at `docs/operator-private/consultations/` tied to open threads.
+- Chained skills that lite skills dispatch. Read tier tags of skills the active goal calls. Lite work needs to know which chained skills need inlining or tagging.
+
+Silence on any class is not deferral. Enumerate the items or state which classes are out of scope this session and why.
+
+**Step 0.66** — Read active canvases. List `docs/canvases/*.md`. For each canvas whose frontmatter carries `verification_status: draft` or `accepted`, Read the full body before proposing options. Cite the canvas file path plus the Q number that informs each option. Whereami recap is a summary. Read the canvas file for the source. Closes bassclef-upstream#813.
+
+<!-- FKGL-EXEMPT: Steps 0.7 + 0.75 technical procedure blocks — short SVO loses precision on the git-log check and release-pipeline surfaces (per bassclef-upstream#1589) -->
+**Step 0.7** — Release pipeline status check (bassclef-upstream only). Surface open release PRs older than 24 hours, CI failures, or commits ahead of public before scope confirmation. Stuck PRs get first priority.
+
+**Step 0.75 — Shipped-state check (per bassclef-upstream#1589).** Before compressed prep fires, run `git log` on every path named in the plan doc `## Recommended` section. Cite the top commit inline. Classify per path:
+
+- **NEW** — no prior commit; work is fresh
+- **EXTENDS** — prior commit exists but does not cover the recommended scope; extend on top
+- **SHIPPED** — prior commit references the recommendation; work already landed; reshape prep
+
+Format for the block:
+
+```
+Shipped-state check:
+- <artifact path> → <top commit SHA> <title> — <NEW|EXTENDS|SHIPPED>
+```
+
+When any path lands SHIPPED, prep reshapes: skip that recommendation. Propose the closing ticket for that scope OR route to the exploratory preset. Silence is not skip.
+
+Detection command per path:
+
+```bash
+git log --all --oneline -1 -- <plan-doc-artifact-path>
+```
+
+Rule: `.claude/rules/longrun-prep-plan-doc-compression.md`. Anchor luminary: @luminary michael-feathers — pin actual behavior via source of record before naming it.
+<!-- /FKGL-EXEMPT -->
+
+**Step 0.8** — Run the pre-flight helper for code work. Source the helper. Call it with the /longrun name and turn estimate. Skip when the session plans no code. Fire when the session plans to touch app code, hooks, libs, or scripts. The helper runs Check 7. Check 7 looks for a use case, spec, or decomposition on disk. The floor per code class lives at `.claude/rules/oo-ad-entry-point.md`.
+
+```bash
+source "${BASSCLEF_DIR:-$REPO_ROOT}/lib/composer-preflight.sh"
+composer_preflight_check "longrun" "${ESTIMATED_TURNS:-100}" | composer_preflight_render "longrun"
+```
+
+The helper stays advisory through 2026-10-31 per ADR-031. Old hooks and libs land without a retrofit brief use case. New hooks and libs merit one per Cockburn tiering.
+
+<!-- FKGL-EXEMPT: Step 0.85 preset picker — technical procedure block; short SVO loses precision on the picker logic per bassclef-upstream#1598 -->
+**Step 0.85 — Preset picker (per bassclef-upstream#1598).** Prep renders in the shape that fits the mode. Three presets ship. The picker reads signals + writes a marker + fires the matching shape:
+
+| Preset | Fires when | Rendered shape |
+|---|---|---|
+| **converged** | Plan doc newer than 48h + carries `## Recommended` section, OR fresh `/state-a-problem` marker present | Lean canvas — Problem + Value + Solution + options table + card on ask |
+| **exploratory** | No plan doc + operator typed `/longrun` alone + no fresh problem marker | Scan-table dominant — options table + one line per row + recommend row marker |
+| **reversible-small** | Small scope stated in the invocation + won't break other work | Three-chunk compact — one line per option, one recommend line, one action line |
+
+Ambiguous cases: picker asks the operator directly — `Converged / Exploratory / Small? (c/e/s/skip)`.
+
+Detection commands:
+
+```bash
+# Converged signal — plan doc present + fresh
+find docs -maxdepth 1 -name 'next-session-plan-*.md' -mtime -2 -type f 2>/dev/null | head -1
+
+# Fresh problem statement
+find state/markers/state-a-problem -type f -mtime -2 2>/dev/null | head -1
+```
+
+The picker writes the preset marker at `state/markers/longrun-preset/<branch>.marker`. Downstream Stop hook reads the marker + applies the per-preset axis set from `.claude/rules/compounding-sequence-fresh-analysis.md` § Per-preset axis sets.
+
+Converged preset triggers Step 0.75 shipped-state check first. When any recommended path lands SHIPPED, prep reshapes to exploratory automatically.
+
+Operator override: at any point, type `browse` (force exploratory) or `quick fix` (force reversible-small) or `full` (force full ceremony with 6-axis default).
+
+Rule: `.claude/rules/longrun-prep-plan-doc-compression.md`. Anchor luminaries: @luminary don-norman (obvious action — picker names the mode + reshape path); @luminary ash-maurya (lean canvas shape for converged); @luminary sophia-prater (progressive disclosure — cards behind on-ask expansion).
+
+Rationale: `/longrun prep` output ran too long. One shape did not fit every situation. Operator asked for a shape that reads clean in under 15 seconds. #1598 filed 2026-09-10; design session at 2026-09-12 picked the three presets under Path 2.
+<!-- /FKGL-EXEMPT -->
+
+**Step 0.87 — Amendment A1: OOAD chain read at pre-flight (per #1150 + #1167 + #1414).** When the goal doc references touch adopter app paths (`src/`, `apps/`, `packages/`, `app/`) OR substrate paths (`lib/`, `scripts/`, `.claude/hooks/`, `.claude/skills/`, `.claude/rules/`, `.claude/luminaries/`, `standards/state-spine/schemas/`, `presence/install/`) OR scope prose names UI or code work, read the design chain per `.claude/bassclef-orientation.md` L100-108. Ceremony depth scales per `.claude/rules/oo-ad-entry-point.md` matrix — script bug fix = skip tier; script extension = brief use case; hook + lib = fully-dressed:
+
+```
+Canvas → Spec → Personas → JTBD → Task-scenarios / Use-case → IA-model → Interaction-design → Decompose
+```
+
+For each of the 9 chain steps, check whether a matching artifact exists on disk:
+
+- Canvas — `docs/canvases/*.md`
+- Spec — `docs/specs/*.md`
+- Personas — `docs/personas/*.md`
+- JTBD — `docs/jtbd/*.md`
+- Task-scenarios — `docs/task-scenarios/*.md`
+- Use-case — `docs/use-cases/*.md`
+- IA-model — `docs/ia-models/*.md`
+- Interaction-design — `docs/interaction-designs/*.md`
+- Decomposition — `docs/decompositions/*.md`
+
+Emit one-line note per gap. Do not BLOCK. Operator picks fold-or-skip per gap. Skip this step when the scope is prose only. This keeps the adopter contract per ADR-031. Old prose sessions see no new dispatches.
+
+The step trigger reads two sources. First the goal doc frontmatter `references` array. Second the scope prose from the goal's Problem and Goal sections. Scope signal present means chain read fires. Absent means chain read skips. Vernon anti-corruption layer per pattern annotation. Bug-fix scope does not fire the chain. Prose-only scope does not fire the chain.
+
+**Step 1** — Pre-flight check:
+
+- Parent roadmap state read via `state_roadmap_get`
+- Recursive parent-goal walk complete
+- BLOCKED items resolved or explicit deferral stated
+- Stack manifests written upfront (one per goal)
+- Session board written if two or more goals or phases are active
+- Survival kit declared (paths to re-read after compaction)
+- Time budget grounded per `.claude/rules/turn-estimate-grounding.md` — cite past goal actuals, range not point, name the shape driver
+- Orchestrator merge mode surfaced
+
+**Step 1.4b** — Name the option-set shape (per bassclef-upstream#832). Two choices:
+
+- **MECE** — each option covers a different scope. No overlap.
+- **Nested** — option a is smallest. Option b builds on a. Option c builds on b.
+
+Pick one shape. Do not mix them.
+
+**Step 1.4c** — Section-anchor rule (per bassclef-upstream#853; Norman + Garrett). Every table in prep output ships under a distinct `###` header. One anchor per concern:
+
+- `### Options` — the option-set table
+- `### Compounding value — recommended only` — the 6-axis block (Step 1.5; new default per bassclef-upstream#1555 PR-2. Legacy 5-axis accepted through 2026-10-31 grace window)
+- `### Adopter benefit per option` — the 3-axis block (Step 1.6)
+- `### Step sequencing` — the step table (Step 1.7)
+- `### Per-step compounding` — the axis-per-step block (Step 1.7a; 6-axis default, 5-axis grace)
+
+Between top-level `###` anchors, use at least 2 blank lines OR a horizontal rule (`---`). Never stack two tables under one anchor. See the Norman + Garrett debate below. It carries the design principles.
+
+<!-- FKGL-EXEMPT: worked example — code fence + heading hierarchy per bassclef-upstream#1535 -->
+**Worked example — H2 / H3 / H4 hierarchy** (per bassclef-upstream#1535; Norman signifier + Feathers sprout). The `### Compounding value — recommended only` anchor names the section. Individual options nest at H4 (`#### Option a`) beneath it. The hook regex accepts H2 through H6 or bold prefix (`**Option a`) since PR #1534; H4 nested under H3 is the canonical shape adopters most often reach for.
+
+Copy this shape and the hook clears first-shot:
+
+```markdown
+### Compounding value — recommended only
+
+#### Option a — <label>
+
+- Where the payoff shows up: <value>
+- How often it fires: <value>
+- What must be true first: <value>
+- Does this teach a shape later work reuses: <value>
+- What breaks if we ship this half-done: <value>
+
+#### Option b — <label>
+
+- Where the payoff shows up: <value>
+- How often it fires: <value>
+- What must be true first: <value>
+- Does this teach a shape later work reuses: <value>
+- What breaks if we ship this half-done: <value>
+```
+
+Same H3 container + H4 options shape applies to `### Adopter benefit per option` (Step 1.6) and `### Per-step compounding` (Step 1.7a). Do NOT stack two options under one H4 header. Do NOT skip the container anchor. See fixture `.claude/hooks/tests/fixtures/2026-09-08-step-1-4c-worked-example/prep-message.txt` (pinned by Test 28 in `longrun-prep-compounding-sequence-check.test.sh`) for the exact body the hook accepts.
+<!-- /FKGL-EXEMPT -->
+
+**Step 1.4d** — Delta-rendering rule (per bassclef-upstream#853; Norman feedback loop). When the operator asks for a refinement (add column, change filter, reshape one option), render ONLY the delta. Cite the source anchor by name.
+
+Anti-pattern — silent rebuild:
+
+> Operator: "add a change-class column"
+> Agent re-renders all 4-5 tables verbatim plus one new column
+
+Correct pattern — named delta:
+
+> Operator: "add a change-class column"
+> Agent: "Adding column to § Options above:"
+> [renders only the new column with the option labels]
+
+Full re-render is only correct when the operator asks for it explicitly ("show me the full picture again") OR the underlying option set changed.
+
+**Step 1.4e** — Card + scan-table shape (per goal 24e; Tufte + Prater). Multi-option output has three parts. First, a compact scan-table on top. Second, one card per option. Third, step cards for the recommended option only. See `standards/scannable-multi-option-output.md` § Card template + § Glyph legend + § Progressive disclosure.
+
+<!-- FKGL-EXEMPT: Step 1.5 preset note — technical procedure reference to the picker per bassclef-upstream#1598 -->
+**Step 1.5 preset note (per bassclef-upstream#1598).** The axis rendering below applies to the FULL ceremony path (no preset picked, or `full` override). When Step 0.85 picker fires a converged / exploratory / reversible-small preset, the axis set adjusts per `.claude/rules/compounding-sequence-fresh-analysis.md` § Per-preset axis sets. Stop hook reads the preset marker and applies the matching check.
+<!-- /FKGL-EXEMPT -->
+
+**Step 1.5** — Recommendation lands FIRST at the top of Step 1.5 (per bassclef-web#152 R1). One sentence naming the recommended option, its scope, turn range, and risk. Reader sees the pick before scrolling. Format:
+
+> **Recommend:** Option a (scope X · N-M turns · risk 🟢/🟡/🔴) because Y.
+
+<!-- FKGL-EXEMPT: procedure body — 6-axis default + 5-axis grace window reference per bassclef-web#325 -->
+Then under `### Compare options`, render a compact scan-table. Then under `### Compounding value — recommended only`, render the 6-axis block for the recommended option only (5-axis legacy accepted through 2026-10-31 grace window per ADR-031; hook accepts both shapes per PR #1591). Per bassclef-upstream#1376. Non-recommended options carry axis values as cells in the scan-table row above. One cell per axis per option. Reader lands the recommended card fast. Other options stay auditable from the scan-table row.
+<!-- /FKGL-EXEMPT -->
+
+<!-- FKGL-EXEMPT: column enumeration + glyph-legend cross-ref -->
+Scan-table columns: `Option`, `Scope`, `Turns`, `Compounds`, `Risk`, `Why not (non-rec.)`. Glyphs encode risk (🟢/🟡/🔴). Words carry compounding rate. The `Why not` column carries one line per non-recommended option — what the operator gives up. The recommended option's cell reads `—` (recommended). Fresh analysis per option; do not copy from other docs.
+<!-- /FKGL-EXEMPT -->
+
+Then the axis block under `### Compounding value — recommended only`. Bullets carry each axis for the recommended option. Per `.claude/rules/compounding-sequence-fresh-analysis.md` postcondition. The section satisfies the rule and the `longrun-prep-compounding-sequence-check.sh` hook. Cells carry each axis for other options. One cell per axis per option.
+
+<!-- FKGL-EXEMPT: axis enumeration + grace-window note -->
+**Recommended option only.** Other options show in the scan-table cells above. Render this block once.
+
+The 6-axis default. These read as practical decision fields for Sam and Louis:
+
+- **Deliverable** — noun/artifact list (files shipped, PRs opened, tags cut, hooks wired). Not a verb-heavy sentence.
+- **Problem** — user pain the option removes; ≤500 chars.
+- **Value prop** — claim + sharpener; ≤280 chars.
+- **Turns** — grounded range citing past goal actuals.
+- **Risk** — one line: `🟢/🟡/🔴 <severity> — <what could fail; who catches it>`. Three bands:
+  - 🟢 low — CI catches it. No adopter impact. Under 15 min to fix.
+  - 🟡 med — needs a rebuild cycle. Local rollback. Under 2h to fix.
+  - 🔴 high — adopter sees the drift. Compat shim or release rollback. Over 2h to fix.
+  Example row: `🟡 med — hook fixture drifts on rewrite; caught by Tier 0 CI`. Bands anchor to Klein premortem plus Tufte data density plus Maurya riskiest assumption.
+- **Shipping priority** — P1 / P2 / P3 / P4 or blank. Blank prompts `Run /eisenhower to prioritize?`. P-prefix differs from Eisenhower Q1-Q4. Matches the bassclef `p1` GitHub label.
+
+The 5-axis legacy shape (grace window through 2026-10-31):
+
+- **Where the payoff shows up** (was: Compounding surface) — per-PR / per-release / per-session / per-adopter / per-quarter.
+- **How often it fires** (was: Compounding rate) — continuous / frequent / per-session / per-adopter / per-quarter.
+- **What must be true first** (was: Foundation prereq) — none, or specific ticket / config flag / prior goal.
+- **Does this teach a shape later work reuses** (was: Inverse-dependency) — yes (name the later work) / no.
+- **What breaks if we ship this half-done** (was: Risk class) — one line: glyph + severity word + failure mode + detection. See 6-axis Risk definition above for the blast-radius bands.
+
+Hook accepts either shape through the grace window. Fresh analysis per option — do not copy from other docs.
+<!-- /FKGL-EXEMPT -->
+
+**Step 1.6** — Under `### <label> · <scope> · <turns> · <risk>`, render a full card for recommended-only. Non-recommended options do NOT get a card by default (per #959 + bassclef-web#152 R2; Prater + Tufte + Cooper). They ship their rationale in the Step 1.5 `Why not` column plus the § Compounding value — recommended only block above. Default prep volume drops by roughly half. Operators pick from the scan table. They read the card only for the option they lean toward. Progressive disclosure per Prater. Operator asks "show cards for B and C too" to expand.
+
+<!-- FKGL-EXEMPT: card field enumeration + progressive disclosure rule -->
+The recommended card carries `**Problem**`, `**Value**`, `**Compounds**` (one-line summary — 5 axes live in the § Compounding value — recommended only section per Step 1.5), `**Adopter**` (mechanism + visibility + action). Full field spec at `standards/scannable-multi-option-output.md` § Card template.
+
+On operator ask ("show cards for B and C too") — render full cards for every option using the same template. Progressive disclosure per Prater.
+<!-- /FKGL-EXEMPT -->
+
+**Step 1.7** — Under `### Steps for <recommended option>`, render step cards only for the option this run recommends.
+
+<!-- FKGL-EXEMPT: step-card field enumeration + progressive disclosure rule -->
+Each step card carries `**Problem**`, `**Produces**`, `**Consumes**`, `**Teaches**`, risk glyph. Not for all options. Progressive disclosure per Prater. On operator ask ("show steps for B and C too"), expand for all.
+<!-- /FKGL-EXEMPT -->
+
+**Step 1.7b** — Recommendation at end. One sentence citing compounding + risk. Reader scans anchors first. Recommendation lands after.
+
+**Step 2** — Session `/temperance` fires with the stated scope question: "Am I about to ship X (inside the time budget) — or am I drifting into adjacent scope Y or Z?" Right thing, right way, scope drift trigger declared.
+
+**Step 2a — /pre-mortem light BEFORE any code work (per `.claude/rules/loop-discipline.md` Step 0.5).** When the session will ship code or substrate, dispatch `/pre-mortem light` — 3 luminary lenses × 5-8 risks per lens, 30 min per Klein workshop shape. Write the risk ledger to `docs/risk-ledgers/<date>-<slug>.md`. Touch the marker at `state/markers/pre-mortem/<branch-slug>.marker` citing the ledger path. Strongest concerns fold into the plan before edits begin. Skip Step 2a when scope is prose-only or research-only. The pre-commit-gate hook enforces the marker at first Edit on substrate paths per goal 24a / #836.
+
+**Step 2b — Amendment A2: /luminary consult on design decision (per #1150 + #1167).** When scope signals a design decision, dispatch /luminary consult. Design decision means new SKILL, new rule, new hook, new lib, structural refactor, or UX surface change. Read the goal doc `authoring_luminaries.primary` frontmatter field. Pass the primary lens to /luminary. Skip Step 2b when scope is a bug-fix or a one-line change per `.claude/rules/oo-ad-entry-point.md` matrix skip tier.
+
+**Step 3** — Register checkpoint triggers (phase boundary, compaction detection, turn counter, saturation milestone, scope drift, `/promote` audit).
+
+**Step 4** — Register closeout trigger. The Stop hook composes `/longrun closeout` before existing `/session-end` runs.
+
+### Checkpoint procedure — I fire on my own
+
+1. State the trigger.
+2. Lead with a `/value-prop tweet` claim and a `/kiss words` grade-10 opener.
+3. Re-read the parent roadmap state via accessor. Detect if another worker released a step.
+4. Re-anchor `/temperance` with the current scope question.
+5. Update the session board.
+6. Audit for `/promote` candidates. File proactively rather than deferring.
+6.5. **Amendment A3: /pattern-review per step (per #1150 + #1167).** When the current step's goal references a decomposition doc AND that doc names `@pattern` references, dispatch `/pattern-review` with the decomposition path. Skip when the decomposition names no `@pattern`. Contract per `.claude/rules/pattern-annotation.md` L57-62.
+7. Report status: steps used, time budget remaining, goals in flight, next step, any pivots since last checkpoint.
+8. Continue vs pause: continue on budget; pause if a step exceeds 1.5× time budget; pause if a hard ceiling is hit.
+
+### Closeout procedure — I fire on my own
+
+1. Lead with a `/value-prop tweet` claim and a `/kiss words` grade-10 opener.
+2. Run `/retro`.
+3. Audit for `/promote` candidates. Backstop for anything missed at checkpoints.
+4. Extract discoveries from the session log. Propose `design/discoveries/` files.
+4.5. **Amendment A4: OOAD chain-dispatch counter (per #1150 + #1167).** Read the session-wide count of chain-dispatch events fired during this session (A1 chain reads + A2 luminary consults + A3 /pattern-review dispatches). Surface at closeout as: "OOAD chain fired N times across M steps." Audit trail for operator confirming the chain honored the promise.
+5. Release pipeline status check (bassclef-upstream only). Flag stuck PRs or commits ahead.
+5.5. Clean up turn-prose-surface markers. Remove any prep + checkpoint markers left in `state/markers/turn-prose-surface/` — `longrun_prep_proposal.marker`, `longrun_checkpoint.marker`, `longrun_closeout.marker`, `status_update.marker`. Per `.claude/rules/compounding-sequence-fresh-analysis.md` § "Remove the surface marker AFTER scope confirmation". The marker's purpose is satisfied once the surface it gates has landed. Leaving it present makes every post-prep Stop event block under V2 strict default. Bootstrap-pair discipline per `.claude/rules/bootstrap-pair-discipline.md` — every touch owes a paired remove.
+
+    ```bash
+    rm -f state/markers/turn-prose-surface/longrun_prep_proposal.marker \
+          state/markers/turn-prose-surface/longrun_checkpoint.marker \
+          state/markers/turn-prose-surface/longrun_closeout.marker \
+          state/markers/turn-prose-surface/status_update.marker
+    ```
+
+    Idempotent — the `-f` flag makes missing markers a no-op. Closes sunj-labs/bassclef-upstream#866.
+6. Update the session board frontmatter (`session_ended`, `session_outcome`).
+7. Update `docs/whereami.md` via `state_whereami_set` accessor, or fallback to direct edit.
+
+<!-- FKGL-EXEMPT: Step 7.5 references paths + skip criteria per architect-review SKILL; technical dispatch step resists further simplification without losing precision -->
+7.5. **/architect-review auto-dispatch (per #1437 Step 2 wiring).** Check skip criteria per `.claude/skills/architect-review/SKILL.md` § Skip criteria. If any skip criterion holds (docs-only session, single-file quick-fix, under 10 commits since last review, operator explicit-defer), log a one-line skip note in the session log Step 8 and continue. Otherwise dispatch `/architect-review`. The review writes its own report at `docs/architecture/reviews/YYYY-MM-DD.md` + creates finding tickets. Return summary line into the session log's Work Done section. See `.claude/skills/architect-review/SKILL.md` § Distinct from Reviewer agent for boundary vs the per-PR CodeReviewer agent.
+<!-- /FKGL-EXEMPT -->
+
+8. Run `/session-end` for tiered obligations (session log, journal, etc.).
+9. Wiki refresh check: did this run produce material surface changes that need a wiki refresh? Discriminator list per `.claude/rules/session-artifacts.md`.
+10. Retroactive sweep against the newest discipline shipped this run.
+
+### Self-check step — before posting any operator facing prose
+
+Before I post any prep, checkpoint, closeout, or status response, I:
+
+1. Touch the surface marker at `state/markers/turn-prose-surface/<surface>.marker`.
+<!-- FKGL-EXEMPT: technical enumeration — prose part list + 6-check list are reference content -->
+2. Dispatch `/kiss words --rewrite` on the full rendered draft — opener + tables + cards + step details + recommendation + closing prose. Not just the opener. Not an inline BLOCK-term scan. Actual skill dispatch. The two-flag form runs vocabulary substitution AND six heuristic checks (passive voice, hyphen words, long sentences, non-SVO openers, noun stacks, adverb density). The skill reads `standards/bassclef-internal-jargon.md` as single source of truth per bassclef#907.
+<!-- /FKGL-EXEMPT -->
+3. Apply the rewrite. When /kiss returns no changes, accept the pass.
+4. Cite the dispatched skill inline per `.claude/rules/operator-facing-prose.md` Rule 3.
+5. Post the response.
+
+The Stop hook `.claude/hooks/turn-prose-kiss-check.sh` is the post-write safety net. This self-check catches misses before you read. The full-draft dispatch closes bassclef-upstream#858 — the opener carried /kiss but tables + cards + steps + recommendations did not.
+
+### Design principles for Steps 1.4c + 1.4d
+
+Steps 1.4c and 1.4d encode 6 principles. Norman + Garrett drove them. Sam + Louis are the readers.
+
+See `standards/scannable-multi-option-output.md` for the full debate + principle set. Closes bassclef-upstream#853.
+
+### Args reference
+
+| Position | Accepted |
+|---|---|
+| mode | `prep`, `checkpoint`, `closeout` |
+| `--now` | modifier on checkpoint or closeout; rejected on prep |
+| `--operator-gated` | modifier on prep; rejected on checkpoint or closeout |
+| `--parallel` | reserved; not implemented today |
+
+### Rules
+
+- Never start `/longrun prep` without operator confirmation.
+- Pre-flight items must be resolved or explicitly deferred. Silence is not deferral.
+- Hard ceilings are operator-gated regardless of `/longrun` config.
+- Every checkpoint must update the session board (no silent skips).
+- Closeout must run `/retro` and `/promote` audit and insight extraction. The three are not optional.
+- `/longrun` is not a substitute for `/autonomous`; it composes it.
+- Scope choices presented to the operator carry a value-prop per option per `.claude/rules/plan-enumeration-needs-value-props.md`. Bare names are not options.
+
+### Grace window on old vocabulary
+
+Old vocabulary (bet → goal, appetite → time budget, WU → step, parent bet → parent goal, arc → thread, chronicle → session log) still works through 2026-10-31 per ADR-031 and `.claude/rules/we-dont-break-adopters.md`. The old `/chronicle` skill name still resolves alongside the new `/session-log` name during the same window.
+
+### Refs
+
+- ADR-040 planning skill vocabulary and lite profile — vocabulary rename table + template shape
+- `.claude/rules/plain-english-discipline.md` — master rule
+- `.claude/rules/we-dont-break-adopters.md` — grace window discipline
+- `.claude/rules/turn-estimate-grounding.md` — time budget grounding
+- `.claude/rules/plan-enumeration-needs-value-props.md` — scope choice discipline
+- `.claude/rules/longrun-prep-plan-doc-compression.md` — Step 0.85 compressed prep discipline (bassclef-upstream#1307 R1)
+- `standards/bassclef-internal-jargon.md` — self-check wordlist
+- `.claude/luminaries/don-norman.md` — signifiers + mapping + feedback lens for Steps 1.4c + 1.4d
+- `.claude/luminaries/jesse-james-garrett.md` — five planes lens for section-anchor discipline
+- `.claude/luminaries/sophia-prater.md` — OOUX + progressive disclosure lens for Steps 1.5-1.7 card format
+- `.claude/luminaries/edward-tufte.md` — data-ink + glyph-encodes-data lens for scan-table + glyph legend
+- `docs/personas/sam.md` — primary reader (15-30 min budget; bounces on friction)
+- `docs/personas/2026-07-12-bet11c-louis.md` — secondary reader (skims group headings first)
+- `standards/scannable-multi-option-output.md` — full 12 principles + card template + glyph legend
+- bassclef-upstream#853 — parent ticket (Steps 1.4c + 1.4d + Norman + Garrett debate)
+- bassclef-upstream#830 — Shape to Option rename (already applied in this file)
+- bassclef-upstream#1150 — auto-inject /decompose + /pattern-review + /architect-review (A1 + A3 chain wiring)
+- bassclef-upstream#1167 — per-step OOAD dispatch chain (A2 + A4 luminary consult + counter)
+- bassclef-web#152 — iterate /longrun prep output shape (R1 + R2 + R3 reshape)
+- `.claude/rules/pattern-annotation.md` L57-62 — @pattern annotation contract (A3 trigger)
+- `.claude/rules/oo-ad-entry-point.md` — ceremony matrix (A2 skip tier)
+- `.claude/bassclef-orientation.md` L100-108 — OOAD chain sequence (A1 canonical list)
+- `.claude/luminaries/john-ousterhout.md` — co-lead (deep modules + narrow interface)
+- `.claude/luminaries/amazon-pr-faq.md` — supporting (decision at top; PR/FAQ working-backwards)