@thebassclef/lite 0.1.0 → 0.1.2

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

@@ -0,0 +1,90 @@
+---
+tier: lite
+name: feynman
+description: "Explain a technical concept in plain English \u2014 Feynman style. For CTO-vettable sidebars in journal entries or standalone micro-posts."
+problem: "Technical concepts get explained with jargon. Non-technical readers stop reading."
+value: "Explains a technical concept in plain English \u2014 Feynman style. For CTO-vettable sidebars in journal entries."
+inputs: [A concept name or paragraph text]
+outputs: [Feynman-style explanation, Analogy anchors, Grade-8 prose]
+user_invocable: true
+disable_model_invocation: false
+---
+
+# Feynman — Plain-English Technical Explanation
+
+Explain a technical concept so that:
+- A PE operating partner understands why it matters economically
+- A CTO confirms it's technically precise
+- A board member can repeat the core idea in their own words
+
+Named after Richard Feynman's principle: if you can't explain it simply,
+you don't understand it well enough.
+
+## When to use
+
+- Flagged by /journal as `[FEYNMAN: concept]`
+- User asks "explain X simply" or "feynman this"
+- A post references a technical concept that needs unpacking for
+  non-technical senior leaders while remaining CTO-credible
+
+## Method
+
+### Step 1: State what it does in one sentence
+
+No jargon. No analogies yet. Just the function.
+
+"Temperance is a mandatory pause that forces the system to justify
+its approach before executing."
+
+### Step 2: Explain why it exists — the failure it prevents
+
+Connect to a real failure mode that the audience recognizes.
+
+"It exists because autonomous systems optimize for throughput. Without
+a pause, the system will retry failed approaches faster rather than
+understanding why they failed — the same pattern that causes large
+engineering organizations to ship broken features faster instead of
+fixing the root cause."
+
+### Step 3: Give the analogy (optional — only if it clarifies)
+
+Pick an analogy from the audience's world:
+
+- PE: "It's the investment committee memo before deploying capital"
+- Enterprise: "It's the pre-flight checklist — not bureaucracy, but
+  the minimum discipline that prevents expensive mistakes"
+- Board: "It's the governance gate between strategy approval and execution"
+
+### Step 4: State the technical precision (for the CTO)
+
+One sentence that a technical reviewer would nod at.
+
+"Implemented as a pre-execution checklist that evaluates five dimensions:
+simplicity, blast radius, verification cost, reversibility, and whether
+the system is treating symptoms or root causes."
+
+## Output format
+
+```markdown
+### [Concept Name]
+
+**What it does**: [one sentence, no jargon]
+
+**Why it exists**: [the failure it prevents, in operating terms]
+
+**Analogy**: [from the audience's world — PE, enterprise, or board]
+
+**Technical precision**: [one sentence a CTO would verify]
+```
+
+## Rules
+
+- Never more than 4 sentences total for the core explanation
+- The analogy must come from enterprise/PE/board — not academia, not startups
+- If the concept doesn't need all 4 parts, drop the analogy
+- The explanation must be accurate enough that a CTO wouldn't correct it
+- Avoid "it's like..." phrasing — state what it IS, then use analogy only to illuminate
+
+## Output discipline
+
+Dispatch `/kiss words --rewrite` on your skill output before you return it. See `standards/skill-output-discipline.md` for the contract.

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

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: howdoi
-description: Run an LLM-assisted intent search over bassclef skills and rules for an adopter goal. Two modes — search (top matches) and compose (matches plus suggested chains). Ranks by semantic fit; cites what each match does.
+description: "Search bassclef skills and rules for an adopter goal \u2014 LLM-assisted. Two modes \u2014 search (top matches) and compose (matches plus suggested chains). Ranks by semantic fit and cites what each match does."
 problem: "Adopters know what they want to do but not which bassclef skill or rule fits."
 value: "One question in. A short list of the skills and rules that match your goal."
 inputs: [A one-sentence goal in plain English]

package/substrate/.claude/skills/ia-model/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: ia-model
-description: Build information architecture from entity inventory + task flows. Derives nav structure, labeling, and screen map from objects.
+description: "Build information architecture from an entity inventory plus task flows. Derives nav structure, labeling, and screen map from the domain nouns."
 problem: "Screens get designed before the nouns behind them are named. Nav drifts across pages."
 value: "One entity map that drives every downstream screen. Nav stays clean because the model is clean."
 inputs: [Task flows from spec, Entity inventory from decompose]

package/substrate/.claude/skills/interaction-design/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: interaction-design
-description: IA + task flows → interaction design — state diagrams, sequence diagrams, user flows. Final step in the UX translation chain.
+description: "Turn IA plus task flows into interaction design \u2014 state diagrams, sequence diagrams, user flows. Final step in the UX translation chain before decompose."
 problem: "Nav and entities are drawn but the flow between screens is not. Devs invent transitions."
 value: "State diagrams and sequence diagrams that name every screen transition and API call."
 inputs: [IA model plus task flows]

package/substrate/.claude/skills/interpret-input/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: interpret-input
-description: "Produce a schema-validated InputArtifact from any input (text/URL/image/repo/transcript/napkin/mixed). text + repo modes work today. Other modes return schema-valid stubs (see #1427). First step of the cameo pipeline. Read-only on disk except --persist mode."
+description: "Turn any input into a schema-valid InputArtifact. Modes: text, URL, image, repo, transcript, napkin, mixed. text + repo ship today. Others return valid stubs. First step of the cameo pipeline."
 problem: "Different sessions start with different input shapes \u2014 text or URL or image or repo or transcript."
 value: "One schema-validated artifact from any input. Downstream skills read one shape not seven."
 inputs: [Any input — text or URL or image or repo ref or transcript]
@@ -102,21 +102,21 @@ With `--persist`: JSON written to `docs/input-artifacts/<slug>.json`. Stdout pri
 
 ## Mode status
 
-Two modes work today. Five return schema-valid stubs pending #1427.
+Two modes work today. Five return schema-valid stubs pending future work.
 
 <!-- FKGL-EXEMPT: mode reference table -->
 | Mode | Status | Behavior |
 |---|---|---|
 | `text` | works | Identity — `extracted_text = source`; URL regex for `external_urls` |
 | `repo` | works | Walks local git dir or clones URL; populates `entities_seen`, `actor_candidates`, `boundary_objects`, `readme_excerpt`, `title`. Falls back to a stub if the path cannot be resolved. |
-| `url` | not yet | Target — fetch + readable text scrape (see #1427) |
-| `image` | not yet | Target — vision-based UI extraction (see #1427) |
-| `transcript` | not yet | Target — speaker-tagged actor mapping (see #1427) |
-| `napkin` | not yet | Target — hand-drawn diagram extraction (see #1427) |
-| `mixed` | not yet | Target — compose multiple extractors (see #1427) |
+| `url` | not yet | Target — fetch + readable text scrape |
+| `image` | not yet | Target — vision-based UI extraction |
+| `transcript` | not yet | Target — speaker-tagged actor mapping |
+| `napkin` | not yet | Target — hand-drawn diagram extraction |
+| `mixed` | not yet | Target — compose multiple extractors |
 <!-- /FKGL-EXEMPT -->
 
-Stubs are still schema-valid InputArtifacts. The current stub value is `extracted_text: "deferred to Phase C"` — a legacy marker string that #1427 will update. Downstream consumers should not crash on it. They may surface a warning that BCE extraction will be empty.
+Stubs are still schema-valid InputArtifacts. The current stub value is `extracted_text: "deferred to Phase C"` — a marker string a future release will update. Downstream consumers should not crash on it. They may surface a warning that BCE extraction will be empty.
 
 ### Repo extractor heuristics
 

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

@@ -0,0 +1,209 @@
+---
+tier: lite
+name: journal
+description: "Draft a journal entry from this session's work \u2014 tuned to PE, search, and board audiences per the writing guide and brand questionnaire."
+problem: "Session work fades from memory. Insight worth sharing with PE partners or eng leaders never gets written."
+value: "Drafts a journal entry from this session's work. Tuned for PE, search, and board audiences."
+inputs: [Optional audience filter — PE or search or board]
+outputs: [Journal draft with voice per audience, Audience recommendations table]
+user_invocable: true
+disable_model_invocation: false
+requires:
+  files: [standards/writing-guide.md]
+  network: true
+---
+
+# /journal — Draft Journal Entries from Session Work
+
+Draft 3 short-form journal entries from the current session's work,
+calibrated to the operator's target audience and brand positioning.
+Publishable to LinkedIn, Substack, an internal blog, or held as
+archive.
+
+## Plain-English requirement (Phase II Trim the Fat — bassclef#559)
+
+journal entries have personal/sensory/story-driven voice (per `feedback_writing_voice` memory) — voice trumps strict rule. The substrate-clarity-gate hook treats journal entry path as ADVISORY tier: it emits notices on bassclef-internal jargon, long sentences, and passive voice but never blocks.
+
+INSTEAD of running /kiss words mechanically over draft prose: read the advisory notices and decide. Some passive voice in journal entries is fine ("the deploy was approved" reads naturally in narrative). Some long sentences carry rhythm. Pure mechanical substitution would flatten the voice.
+
+What DOES still apply: drop bassclef-internal jargon (substrate, primitive, load-bearing, composer, tier-preset). LinkedIn audiences include investors, eng leaders, board operators — none have bassclef context. If the draft uses these words, run /kiss words on those specific terms (or rewrite by hand).
+
+## Before writing
+
+1. Read `standards/writing-guide.md` — the journal-entry style guide
+2. Read the brand questionnaire from memory (if it exists) for audience,
+   tone, topics, and positioning
+3. Read the current session's chronicle entry for raw material
+4. If called after `/journal mine`: use the selected moment as primary
+   source material. Read the full chronicle for that session.
+5. Check what angles have been covered (read existing drafts in
+   `docs/operator-private/journals/`). This is **informational context, not a
+   filter** — repeating themes across posts is intentional. It builds
+   recognition. But knowing what's been said helps pick fresh angles.
+
+## Two audiences — every notable moment gets two variants
+
+Each notable decision, trade-off, or insight produces **two post variants**:
+
+### Variant A: CPTO → Board / PE / Executive Search
+
+The operator speaking to people who evaluate operating talent and back
+enterprise transformations.
+
+- **Primary audience**: PE senior partners, executive search leaders,
+  board-level decision-makers
+- **Tone**: Bezos/Jassy/Collison — calm, analytical, operator-grade
+- **Depth**: Business outcome, capital efficiency, governance model.
+  One concrete technical detail as proof, no more.
+- **Vocabulary**: "governance primitive" not "SKILL.md". "Coordination
+  framework" not "agent choreography." See writing guide.
+- **Connects to**: EBITDA, capital efficiency, operating model, scale,
+  talent leverage, risk management
+
+### Variant B: CPTO → Senior Engineers / Technical Founders
+
+The same operator speaking to people who will build or evaluate the
+technical approach.
+
+- **Primary audience**: CTOs, VP Engineering, staff+ engineers,
+  technical founders, eng managers
+- **Tone**: Thoughtful practitioner — shows the work, not just the result
+- **Depth**: Architecture decisions, trade-offs, what was tried and
+  rejected, specific patterns used. Technical enough that a senior
+  engineer learns something.
+- **Vocabulary**: Use real terms — ADRs, choreography, hooks, substrate.
+  No need to abstract. This audience knows what a pre-commit hook is.
+- **Connects to**: Engineering quality, developer experience, system
+  reliability, team velocity, technical debt management
+
+### How to pair them
+
+The same moment becomes two posts:
+- **Variant A**: "We killed three features before writing a line of code.
+  Here's why that's the highest-leverage thing a technical operator can do."
+- **Variant B**: "Our Shaper agent runs Five Whys before any spec reaches
+  Construction. Here's the gate architecture and why it caught a scope
+  creep we would have shipped."
+
+Both posts reference the same work. They land differently because they
+answer different questions: A answers "is this person a credible operator?"
+B answers "is this approach technically sound?"
+
+## Rules
+
+- **Two variants per notable moment** — label as (A: Board) and (B: Engineering)
+- **Name concepts, not implementations** in Variant A. Real terms in Variant B.
+- **Connect to enterprise economics** in Variant A. Connect to engineering
+  quality in Variant B.
+- **Bezos/Jassy/Collison tone** for Variant A. Thoughtful practitioner for B.
+- **Structure**: Hook → Setup → Body (with → arrows) → Takeaway
+- **Every post must stand completely on its own** — no "in my last post"
+  references, no series context, no callbacks. Each post works for someone
+  who has never read anything you've written before.
+- **Repetition across posts is intentional** — the LinkedIn algorithm shows
+  each post to a subset of your network. Covering the same theme from
+  different angles builds recognition. Don't avoid a topic just because
+  you've posted about it before.
+- **600-1200 words** per post
+- **3-7 posts per session** — across both variants. A session with 2 notable
+  moments produces 4 posts (2A + 2B).
+
+## Audience recommendations table (MUST — include in every draft file)
+
+Every draft file must start with a master audience recommendations table:
+
+```markdown
+| # | Variant | Title | Primary audience | Hook strength | Publish priority |
+|---|---------|-------|-----------------|--------------|-----------------|
+| 1A | Board | [title] | PE partners — "[angle]" | Strong | 1 |
+| 1B | Eng | [title] | Senior engineers — "[angle]" | Very strong | 2 |
+| 2A | Board | [title] | Board/search — "[angle]" | Medium | Hold |
+| 2B | Eng | [title] | CTOs — "[angle]" | Strong | 3 |
+```
+
+For each post, specify:
+- **Variant**: A (Board/PE) or B (Engineering)
+- **Primary audience**: PE partners, board, exec search (A) or CTOs, eng leaders, technical founders (B)
+- **Hook strength**: rate honestly. "Very strong" = contrarian or cautionary. "Strongest" = thought leadership.
+- **Publish priority**: recommended sequence with rationale, or "Hold" for article/longer form
+- **Pair notes**: which A/B posts cover the same moment — they should not publish same day
+
+End the table with:
+- **Recommended publish sequence** with rationale (alternate A/B to reach both audiences)
+- **Hold for articles** — posts that work better as longer LinkedIn articles
+- **Pairing notes** — which A and B posts are about the same moment
+
+## When a concept needs technical explanation
+
+Flag it for the /feynman skill. In the draft, mark it:
+
+```
+[FEYNMAN: concept name — for CTO sidebar]
+```
+
+After drafting all 3 posts, run /feynman on each flagged concept.
+Weave the Feynman explanation into the post or note it as a comment-thread follow-up.
+
+## Output
+
+1. Check for gaps: when was the last journal entry? Are there missed
+   sessions? **Backfill those FIRST, oldest to newest** (per session-artifacts rule).
+2. Write drafts to `docs/operator-private/journals/YYYY-MM-DD.md` with audience
+   recommendations table at the top
+3. Push drafts to the repo's journal-entry Google Doc — use `--dir` for
+   automatic chronological ordering (the script sorts by filename):
+   ```bash
+   # Batch push — script sorts YYYY-MM-DD filenames automatically
+   cd ~/src/your-org/your-app && npx tsx scripts/push-to-gdoc.ts \
+     --dir [drafts directory] \
+     --doc-id [journal_doc_id from substrate.config.md]
+
+   # Single file push (when only one new draft)
+   cd ~/src/your-org/your-app && npx tsx scripts/push-to-gdoc.ts \
+     --file [draft path] \
+     --doc-id [journal_doc_id from substrate.config.md]
+
+   # Fix out-of-order doc: clear and re-push everything sorted
+   cd ~/src/your-org/your-app && npx tsx scripts/push-to-gdoc.ts \
+     --dir [drafts directory] --replace \
+     --doc-id [journal_doc_id from substrate.config.md]
+   ```
+   Google Doc IDs (for reference — always read from substrate.config.md):
+   - Bassclef: `1f9nUSmwpFvcZhnfmYvhyNWZuElMwqfz3muWdIcwMUrA`
+   - POA: `1Gwhsh6aC6lq1jRQhGSpZ9BUNBlpdY3SNFpnIlMP97Zk`
+4. **Verify the push succeeded** — check the output for "Appended N chars"
+5. Note in the chronicle that posts were drafted and pushed
+6. If Google Doc push fails (no script, no auth): drafts stay local in
+   `docs/operator-private/journals/` AND a deferred-action entry is written so the
+   next capable session completes the push. Do not silently skip.
+
+### Deferring a failed push
+
+When the current session cannot push to the configured `journal_doc_id`
+(missing `gcloud-auth` / `google-docs-write` — typical in mobile,
+cloud-web, or a desktop session without the SA key):
+
+```bash
+TS=$(date -u +"%Y-%m-%dT%H-%M-%SZ")
+ID="${TS}-journal-gdoc-push"
+cp templates/deferred-action-template.md \
+   "docs/deferred-actions/${ID}.md"
+# Fill frontmatter:
+#   pending_action: push-journals-to-gdoc
+#   requires_capability: [gcloud-auth, google-docs-write]
+#   priority: medium
+#   origin_skill: /journal
+#   resolves_when: |
+#     Google Doc <journal_doc_id> reflects docs/operator-private/journals/ in chronological order
+# Cross-ref the draft file(s) in the body.
+git add "docs/deferred-actions/${ID}.md"
+git commit -m "chore: defer journal gdoc-push (<draft-date>)"
+```
+
+See `.claude/rules/deferred-actions.md` and
+`standards/deferred-actions-schema.md`. Silent skip violates
+`session-artifacts.md` ("silence is not deferral").
+
+## Output discipline
+
+Dispatch `/kiss words --rewrite` on your skill output before you return it. See `standards/skill-output-discipline.md` for the contract.

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

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: kiss
-description: "Keep It Simple. Two modes — scope (compress what we're shipping; runs /value-prop brief + /feynman + MUST/SHOULD/COULD buckets) and words (rewrite vocabulary at grade-10 reading level; mechanical big-word→small-word swap). Default mode read from input: ticket/goal → scope, paragraph text → words. Reads vocabulary from standards/bassclef-internal-jargon.md (bassclef#907 single source of truth)."
+description: "Keep it simple. Two modes: scope (compresses what ships; runs /value-prop brief plus MUST/SHOULD/COULD buckets) and words (rewrites to grade 8; big word to small word swap). Reads standards/bassclef-internal-jargon.md."
 problem: "Scope grows. Prose fills with jargon. Adopters read a wall of bassclef-internal words and give up."
 value: "Two modes \u2014 scope compresses what ships. Words rewrites vocabulary to grade 8. Plain English at the wire."
 inputs: [A ticket or goal path for scope mode, Paragraph text for words mode]

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

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: launch
-description: "Turn an idea into a buildable plan. Produces a clickable mock gallery PLUS the spec, user stories, decomposition, and migration plan. Two sizes (medium, full). Two deploy modes — extended deploys mocks to a configured subdomain; --local writes everything to disk and serves the gallery on localhost (Anthropic API key only; no vendor accounts). For variants-only, use /stage."
+description: "Turn an idea into a buildable plan. Ships a clickable mock gallery plus the spec, user stories, decomposition, and migration plan. Two sizes: medium and full. Two deploy modes: extended (subdomain) and --local (localhost)."
 problem: "An idea is a doc. A working feature is code. The gap in between is where projects stall."
 value: "Turns an idea into a buildable plan \u2014 mock gallery and spec and INVEST stories. Ready for /build."
 inputs: [A rough idea or ticket or canvas]
@@ -135,19 +135,15 @@ case $PREFLIGHT_RC in
 esac
 ```
 
-Override: `SKIP_COMPOSER_PREFLIGHT=1` (logged via trace-helper). Use
-sparingly — defeats the purpose. See
-`standards/composer-prerequisites.md` for full discipline.
+Override: `SKIP_COMPOSER_PREFLIGHT=1` (logged). See
+`standards/composer-prerequisites.md` for the full contract.
 
-The 6 checks: feature-branch, state-spine (auto-prep), personas,
-budget, skill-registry (bassclef#271 race detection), deploy-host
-(bassclef#449/#450 — refuses dispatch when `hosting_platform=none`
-and `/launch-preview` would have nowhere to land).
+The 6 checks are feature-branch, state-spine, personas, budget,
+skill-registry, and deploy-host. See bassclef#271, #449, #450 for
+the race + hosting-platform edge cases.
 
-The `--no-launch` mode is the variants-only escape hatch: produces
-the prototype gallery without committing to launch a deploy host.
-Use when `/stage` (light) or `/launch` is dispatched purely
-for design exploration. Default is full chain (deploy-host required).
+`--no-launch` skips the deploy-host check for design exploration.
+Default is the full chain (deploy-host required).
 
 ### Phase 0 — Pre-flight
 
@@ -318,7 +314,7 @@ Same as `/stage` Phase 2 — Jacobson method via `/objectory-decompose`.
 Output: `docs/decompositions/<slug>-domain.md` with entity inventory
 + actor list + verb-goal pairs + BCE matrix.
 
-**Distinction from /stage (formerly /preview)**: medium + full consume the FULL BCE
+**Distinction from `/stage`**: medium + full consume the FULL BCE
 matrix downstream (in /ia-model + /interaction-design + /decompose
 steps). Quick + light only consume the verb-goal pairs (for
 /value-prop input).
@@ -822,7 +818,7 @@ PR body MUST surface: "Operator's next action: review the Construction
 iteration-goal draft at <path>; if approved, run `/build-iteration
 <slug>-construction` (bassclef#335)."
 
-## Tier behavior (BUILD-only — see /stage (formerly /preview) for prototype tiers)
+## Tier behavior (BUILD-only; `/stage` for prototype tiers)
 
 | Tier | Phase B MVP | Status |
 |---|---|---|
@@ -861,15 +857,10 @@ Same baseline as `/stage` PLUS:
 - ux-migration step fails (no chosen variant): operator must run with
   `base=<slug>` OR pick winner via gallery review
 
-## Reserved-names check
-
-`launch` is NOT on `standards/reserved-skill-names.md` list.
-Verified during this skill creation.
-
 ## Relationship to other skills + standards
 
 - `/stage` — sibling (prototype tiers; same input-handler interface)
-- `/interpret-input` — Phase 1 producer (same as /stage (formerly /preview))
+- `/interpret-input` — Phase 1 producer (same as `/stage`)
 - `/objectory-decompose` — Phase 2 producer (same as /stage)
 - `/value-prop` — Phase 3 producer (different mode by tier)
 - `/personas`, `/jtbd-tasks`, `/value-prop-canvas` — Phase 3b
@@ -916,9 +907,9 @@ This is the Construction-transition step in the
 
 Methodology-level. State-validate.sh hook enforces preview-state.yml
 + iteration-goal.schema.json validation. PR-first discipline enforced
-via branching.md rule + pre-build-gate hook. Reserved-names check
-passes. No additional hook enforcement added.
+via branching.md rule + pre-build-gate hook. No additional hook
+enforcement added.
 
 ## Output discipline
 
-Dispatch `/kiss words --rewrite` on your skill output before you return it. See `standards/skill-output-discipline.md` for the contract.
+Dispatch `/kiss words --rewrite` on output. See `standards/skill-output-discipline.md`.

package/substrate/.claude/skills/lean-canvas/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: lean-canvas
-description: Produce a Lean Canvas — Ash Maurya's 9-box business model template — filled through persona lenses. Two modes — commercial (revenue=dollars) and growth-loop (revenue=audience+credibility). Outputs a chain-of-beliefs file naming the riskiest assumption to validate next.
+description: "Produce a Lean Canvas \u2014 Ash Maurya's 9-box template \u2014 filled through persona lenses. Two modes: commercial (revenue in dollars) and growth-loop (audience plus credibility). Outputs the riskiest assumption to validate next."
 problem: "New products get built without naming the customer or the problem or the unfair advantage."
 value: "Ash Maurya's 9-box canvas filled through persona work. One page names the business."
 inputs: [Personas file, Value proposition data, A rough product idea]

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

@@ -1,6 +1,6 @@
 ---
 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."
+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]
@@ -240,12 +240,40 @@ 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)
+- `### Compounding value per option` — 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 5-axis-per-step block (Step 1.7a)
+- `### 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 subsection below for the underlying design principles.
+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 per option` 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 per option
+
+#### 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.
 
@@ -268,16 +296,25 @@ Full re-render is only correct when the operator asks for it explicitly ("show m
 
 > **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).
+Then under `### Compare options`, render a compact scan-table. Then under `### Compounding value per option`, render the 5-axis block for the recommended option only. 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: 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.
+Then the axis block under `### Compounding value per option`. 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 -->
-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`):
+The 6-axis default (new; per bassclef-upstream#1555 PR-2). These read as practical decision fields for Sam and Louis:
+
+- **Deliverable** — what ships when this option lands (plain sentence)
+- **Problem** — user pain the option removes (draft via `/state-a-problem brief`; ≤500 chars)
+- **Value prop** — claim + sharpener (draft via `/value-prop tweet`; ≤280 chars)
+- **Turns** — grounded range citing past goal actuals per `.claude/rules/turn-estimate-grounding.md`
+- **Risk** — 🟢 low / 🟡 medium / 🔴 high
+- **Shipping priority** — Q1 / Q2 / Q3 / Q4 or blank (blank prompts `Run /eisenhower to prioritize?`)
+
+The 5-axis legacy shape (grace window through 2026-10-31 per ADR-031; hook accepts both):
 
 - **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
@@ -285,7 +322,7 @@ The 5 axes (plain-English preferred per ADR-040 D4; compressed compound-noun for
 - **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.
+Hook accepts either shape through the grace window per PR #1591. R8 catch preserved via `/state-a-problem` + `/value-prop` skill dispatches — those tools resist copy-paste and force fresh per-option analysis.
 <!-- /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.

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

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: luminary
-description: Browse and preview luminary files — filter by discipline (ux, visual, architecture, product), by claiming agent (designer, architect), or preview a specific luminary by slug. Catalog analog to /skills.
+description: "Browse and preview luminary files. Filter by discipline (ux, visual, architecture, product), by claiming agent (designer, architect), or preview a specific luminary by slug. Catalog analog to /skills."
 problem: "Design lenses live in files no one reads. Adopters pick generic patterns because they don't know the catalog."
 value: "A browser for the luminary catalog. Filter by discipline. Preview by slug before you pin one to a goal."
 inputs: [Optional discipline filter — ux or visual or architecture or product]

package/substrate/.claude/skills/ogilvy-writing-audit/SKILL.md

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: ogilvy-writing-audit
-description: "Audit prose against Ogilvy's 10 writing rules + Roman-Raphaelson principles. Produces severity-tagged violations with fixes. Diagnoses; /kiss words fixes. Trigger on 'audit this memo', 'review my writing', 'check this draft', or paste-and-ask-feedback."
+description: "Audit prose against Ogilvy's 10 writing rules plus Roman-Raphaelson principles. Produces severity-tagged violations with fixes. Diagnoses; /kiss words fixes. Fires on 'audit this memo', 'review my writing', 'check this draft'."
 problem: "Prose ships with jargon and long sentences and hedge words. Readers stop reading."
 value: "Ogilvy's ten rules applied to your prose. Severity-tagged findings that /kiss can fix."
 inputs: [A file path or PR body or paragraph text]