@thebassclef/lite 0.0.1 → 0.1.0

package/substrate/.claude/skills/longrun/SKILL.md

@@ -0,0 +1,426 @@
+---
+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.
+
+**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.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.
+
+**Step 0.85** — Plan-doc detection (per bassclef-upstream#1307 R1). Check for `docs/next-session-plan-*.md` files newer than 48 hours. If a matching plan doc exists AND its body carries a `## Recommended session sequence` (or `## Recommended sequence` OR `## Next-session pickup`) section, enter compressed prep mode. In compressed mode:
+
+1. Read the plan doc's Recommended section
+2. Cite the plan doc path inline as source
+3. Present the pre-authored sequence as-is (scan-table + step cards for the recommended item only)
+4. Skip Step 1.4c full ceremony (section-anchor rule still holds; the option-table + 5-axis-per-option blocks compress to one recommended-option card)
+5. Ask operator "proceed with plan doc pick, pick a smaller item, or reshape?"
+
+If no plan doc matches: run the full Steps 1.4c-1.7b ceremony as documented.
+
+Detection command:
+
+```bash
+find docs -maxdepth 1 -name 'next-session-plan-*.md' -mtime -2 -type f 2>/dev/null | head -1
+```
+
+Rule extension: `.claude/rules/longrun-prep-plan-doc-compression.md`. Anchor luminary: @luminary john-ousterhout (deep module — compression path hides plan-doc detection behind a narrow interface).
+
+Rationale: operator files a plan doc AFTER a prior session to pre-pick next scope. Re-authoring the full option table at the next prep wastes ~15-25 turns. #1307 filed 2026-08-19 as workflow-overhead R1 with evidence — one session ran ~25-40 turns of ceremony vs ~5 turns needed.
+
+**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 per option` — the 5-axis block (Step 1.5)
+- `### Adopter benefit per option` — the 3-axis block (Step 1.6)
+- `### Step sequencing` — the step table (Step 1.7)
+- `### Per-step compounding` — the 5-axis-per-step block (Step 1.7a)
+
+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 subsection below for the underlying design principles.
+
+**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.
+
+**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.
+
+Then under `### Compare options`, render a compact scan-table. Then under `### Compounding value per option`, render the 5-axis block for every option (hook postcondition per compounding-sequence-fresh-analysis.md requires per-option coverage today; hook extension to recommended-only lives at a follow-on ticket per bassclef-web#152).
+
+<!-- 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 5-axis block under `### Compounding value per option`. Each option carries all 5 axes as bullets with distinct values. Per `.claude/rules/compounding-sequence-fresh-analysis.md` postcondition — the section satisfies both the rule postcondition and the `longrun-prep-compounding-sequence-check.sh` hook. The scan-table's `Compounds` column is a one-line summary; the per-option block carries the distinct values.
+
+<!-- FKGL-EXEMPT: axis enumeration + grace-window note -->
+The 5 axes (plain-English preferred per ADR-040 D4; compressed compound-noun forms accepted through 2026-10-31 grace window per `.claude/rules/we-dont-break-adopters.md`):
+
+- **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) — low / medium / high
+
+Both label forms match the hook regex through the grace window. After 2026-10-31 only plain-English forms match.
+<!-- /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 per option 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 per option 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)