@thebassclef/lite 1.4.0 → 1.5.1

package/dist/lite/standards/lite-manifest.json

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.8.5",
-  "generated_at": "2026-09-18T12:53:51Z",
+  "manifest_version": "1.9.4",
+  "generated_at": "2026-09-21T12:32:12Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -104,7 +104,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/08-settings-drift.sh",
       "tier": "lite",
-      "content_hash": "sha256:610c46bab04ca47af207824cc5faa24c7754c00b976b71d9be77057e9ea87a63",
+      "content_hash": "sha256:8c2884630f16301023b943b08f8e12b17eb1d7ea6e04bec838198dca2ec0ba05",
       "description": "Drift detector — fires at every SessionStart via session-reflection.sh."
     },
     {
@@ -136,7 +136,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/20-artifact-staleness.sh",
       "tier": "lite",
-      "content_hash": "sha256:5a406be60669e106c99e98da00d7acb8e9ce834a84e1145d244f5121cfd0f9a9",
+      "content_hash": "sha256:24d1c0513b88bde625ab0bdbd7e4bd6678cdfc47ba76900bc06e3fbfe543f24c",
       "description": "Artifact-staleness checks: chronicle, danger-mode summary,"
     },
     {
@@ -144,7 +144,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/30-metrics-staleness.sh",
       "tier": "lite",
-      "content_hash": "sha256:6a296054a37741db7a9161a11e8582ce31f489f8fb1683d3c2cf2daf981242a7",
+      "content_hash": "sha256:a4b2f436c218c15230c126fa2f2748fca36cdf9778185cab90a8aac4a6416f41",
       "description": "Metrics-staleness check: version tags, iteration closeouts, metrics"
     },
     {
@@ -208,7 +208,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/60-deferred-actions.sh",
       "tier": "lite",
-      "content_hash": "sha256:b119d0700df5823afeed631a6f4ddfb9cb0f302577e3b3977a30c8ddb85acd60",
+      "content_hash": "sha256:ae167ab6b1626b9155a0539618678ca7a08d1f619cb054f94476df3ad9f7dff9",
       "description": "Deferred-actions scan: enumerate docs/deferred-actions/*.md, detect current"
     },
     {
@@ -232,7 +232,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/80-hook-heartbeat-check.sh",
       "tier": "lite",
-      "content_hash": "sha256:4467390bb6f7dfa418c799ce175a9febc395e3b883c720c562e2c42ffdb1ff81",
+      "content_hash": "sha256:9f20ebd080a1a7364fe6e6c16266547b56b95c820297310cdd5be559852bab5f",
       "description": "Hook heartbeat check — reads standards/hook-cadence.json, calls"
     },
     {
@@ -339,14 +339,6 @@
       "content_hash": "sha256:6981fedc02dc0b683db7872519e06bd16b68fd346a2e566a7e8503f28822db10",
       "description": "bassclef-source-config-validate.sh — PreToolUse hook validating"
     },
-    {
-      "slug": "bassclef-sync",
-      "type": "hook",
-      "path": ".claude/hooks/bassclef-sync.sh",
-      "tier": "lite",
-      "content_hash": "sha256:03c813d942e42a8a4a37744e3cb14219fa4364ce18e2269957dc3a2f954fa983",
-      "description": "Bassclef Substrate Sync — fires on SessionStart."
-    },
     {
       "slug": "bet-doc-gate",
       "type": "hook",
@@ -547,6 +539,14 @@
       "content_hash": "sha256:38665938cb3bac6d249d94b814cc3f43600456abcbb045bff5a5d0d0128a7cbb",
       "description": "PreToolUse: Bash"
     },
+    {
+      "slug": "pre-commit-manifest-autoregen",
+      "type": "hook",
+      "path": ".claude/hooks/pre-commit-manifest-autoregen.sh",
+      "tier": "lite",
+      "content_hash": "sha256:b3641c5c2402fdedb9fb23b812548e94809dcc732e8d5e19af4fd5b488b023e0",
+      "description": "PreToolUse: Bash"
+    },
     {
       "slug": "pre-gh-pr-body-scrub",
       "type": "hook",
@@ -592,7 +592,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.sh",
       "tier": "lite",
-      "content_hash": "sha256:a9f2492fcf1ae86da3da2e0b6311d8e68a01472e9d68e9504fe6044a5f55d99d",
+      "content_hash": "sha256:ece32cd8261bafe4597563aa18237b504bba335c0a1e8d94e1d8d69f4a8e97ae",
       "description": "Session Start hook coordinator. Injects reflection prompt and iterates"
     },
     {
@@ -699,6 +699,22 @@
       "content_hash": "sha256:867d05c8da773e8aef3d077ec7c171d8e9a208b579596f77dd73e18cc8fcf2e2",
       "description": "whereami-utc-gate.sh — PreToolUse hook that BLOCKs Edit|Write|MultiEdit"
     },
+    {
+      "slug": "wirings",
+      "type": "hook",
+      "path": ".claude/hooks/_lib/wirings.sh",
+      "tier": "lite",
+      "content_hash": "sha256:65fb14b5c7b4a919516c96f4587b492d5eb3bcf6f939bbc7c1809205de49498d",
+      "description": "Shared accessor library for hook-wiring inspection."
+    },
+    {
+      "slug": "ancestor-claude-check",
+      "type": "lib",
+      "path": "lib/ancestor-claude-check.sh",
+      "tier": "lite",
+      "content_hash": "sha256:f84c7b57ae28ef15b0c4c138ee4781030e04e7bb858ff0c53a80a538672d64dd",
+      "description": "ancestor-claude-check.sh — walks up from a starting directory to $HOME"
+    },
     {
       "slug": "bassclef-dir-resolver",
       "type": "lib",
@@ -752,7 +768,7 @@
       "type": "lib",
       "path": "lib/fixture-builder.sh",
       "tier": "lite",
-      "content_hash": "sha256:85a59597e8898ea38e7d7442423381f0c4caa5ecf6780bbd0a71d63b819d3b13",
+      "content_hash": "sha256:5831bcd49c162ec131cf14d402150821bd8f623e87eb3c1bcdc545fc701aaefd",
       "description": "Deep module for adopter-environment fixtures used by bassclef Tier 0 tests."
     },
     {
@@ -808,7 +824,7 @@
       "type": "lib",
       "path": "lib/mechanism-fidelity.sh",
       "tier": "lite",
-      "content_hash": "sha256:7ccd6751d3ff3c31b142aac3c1739cd1cb1863f5e13db29ce1eb8206def1b7ca",
+      "content_hash": "sha256:3253ce24b845e601486dea9dab4a9e27d11f7fc72f5b9084ab5fb473bea84826",
       "description": "lib/mechanism-fidelity.sh — shared scanner for the mechanism-fidelity"
     },
     {
@@ -899,6 +915,14 @@
       "content_hash": "sha256:7ee5cc3c7372ca6aef3c81f614ec119ffed8874e00a78d441ce8d0304c7b6308",
       "description": "lib/tier-dependency-audit.sh"
     },
+    {
+      "slug": "workflow-metrics",
+      "type": "lib",
+      "path": "lib/workflow-metrics.sh",
+      "tier": "lite",
+      "content_hash": "sha256:4615d673185021f484887b6a674b08f209e8f93db195189f77aff58c618ccf3e",
+      "description": "Workflow metrics measurement library — Module B4 per"
+    },
     {
       "slug": "alan-cooper",
       "type": "luminary",
@@ -971,6 +995,14 @@
       "content_hash": "sha256:ec2bb153111b28d5f505825f107fb0ac5da354a4cc3a6a474e1d1b153c81eafb",
       "description": "\\\"The whole idea was to imagine what it's like to be inside someone else's head."
     },
+    {
+      "slug": "david-farley",
+      "type": "luminary",
+      "path": ".claude/luminaries/david-farley.md",
+      "tier": "lite",
+      "content_hash": "sha256:db45f22a2e893137ad0a09ed7a090dc145b3e92dd0c3a5db718e63305921ca91",
+      "description": "Continuous Delivery co-author; deployment pipeline mechanics; author of Modern Software Engineering."
+    },
     {
       "slug": "david-ogilvy",
       "type": "luminary",
@@ -1067,6 +1099,14 @@
       "content_hash": "sha256:8275c70d25fb8e8acad9dc68ade399993d5f1432ae82449fe14db8533342fd70",
       "description": "\\\"Every user experience has five planes: strategy, scope, structure, skeleton, surface."
     },
+    {
+      "slug": "jez-humble",
+      "type": "luminary",
+      "path": ".claude/luminaries/jez-humble.md",
+      "tier": "lite",
+      "content_hash": "sha256:312d4e5cbf21824a50f120c9f7b54b30e00afb4b33782537eda67500269fb7f3",
+      "description": "Continuous Delivery co-author; deployment pipeline framework; DORA metrics researcher."
+    },
     {
       "slug": "john-ousterhout",
       "type": "luminary",
@@ -1128,7 +1168,7 @@
       "type": "luminary",
       "path": ".claude/luminaries/martin-fowler.md",
       "tier": "lite",
-      "content_hash": "sha256:7fbf6ec65206fcbb6dbf2df1d24fed37555d495c6597885ff1a7f201ce3c2544",
+      "content_hash": "sha256:c81089dbc3aaeb9d67a91cf19517571452ecc6505fe6ffd065e4029698ae39ec",
       "description": "\\\"Any fool can write code that a computer can understand."
     },
     {
@@ -1227,6 +1267,13 @@
       "content_hash": "sha256:9b5d51d106b5f4398c15c1412c781b81f2cde55fecc294c120479a06b8de92a9",
       "description": "\\\"A bad system will beat a good person every time.\\\""
     },
+    {
+      "slug": "bassclef-configs-template-jsonc",
+      "type": "presence-template",
+      "path": "presence/install/bassclef-configs.template.jsonc",
+      "tier": "lite",
+      "content_hash": "sha256:e796b9736e9b00468822bfed2e2cdbed220c25ee8541f66fe7b743fe50d1a893"
+    },
     {
       "slug": "bassclef-hook-connect",
       "type": "presence-template",
@@ -1248,7 +1295,7 @@
       "type": "presence-template",
       "path": "presence/install/bassclef-sync.template.sh",
       "tier": "lite",
-      "content_hash": "sha256:f202c2bb2d252e72e3c2f80a99fea4fece95b9db3744721ce4fea12e3a4b4eb1",
+      "content_hash": "sha256:0a689f73d94bb78d1a3e7fdb3cda760e093db1d7536548cb05cf3a9ea9fb4c6c",
       "description": "description: BASSCLEF_SYNC_VERSION=2026-09-06-1496-sessionstart-heal-v1"
     },
     {
@@ -1958,7 +2005,7 @@
       "type": "script",
       "path": "scripts/generate-lite-manifest.sh",
       "tier": "lite",
-      "content_hash": "sha256:950c701995965d543a692cfba919593bb6ae36c2103b5b93a7217d41bb9f0009",
+      "content_hash": "sha256:6342c768c91af054a4dcb6ea3e63228f0c7b4ff0e188867026fe0cdd333e3fe5",
       "description": "Generate lite-manifest.json at repo root."
     },
     {
@@ -1993,6 +2040,14 @@
       "content_hash": "sha256:30dc5eaff11fafc08b0845d8c4ce329a51b6ca0e89136638d335b58af41c7c0f",
       "description": "Render human-readable companion doc from lite-manifest.json."
     },
+    {
+      "slug": "workflow-metrics-query",
+      "type": "script",
+      "path": "scripts/workflow-metrics-query.sh",
+      "tier": "lite",
+      "content_hash": "sha256:9d9ad4a997e2820046802796f81a5d064b14f951cdade6f6c252db64d2afae89",
+      "description": "CLI wrapper for lib/workflow-metrics.sh — Module B4 query helper."
+    },
     {
       "slug": "agent-research-spawn",
       "type": "skill",
@@ -2434,24 +2489,6 @@
       "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."
     },
-    {
-      "slug": "journal-export",
-      "type": "skill",
-      "path": ".claude/skills/journal-export/SKILL.md",
-      "tier": "lite",
-      "content_hash": "sha256:e63ffd119880230749701b9e484538bfe4a766a8e53ab2778c03f0cdb0762bc9",
-      "description": "Generate a structured journal-entry corpus for a brand team or your own archive — chronicle digest, draft index, moment inventory. Supports incremental updates.",
-      "inputs": [
-        "Time range or theme filter"
-      ],
-      "outputs": [
-        "Corpus JSON",
-        "Google Doc export",
-        "Archive-ready file"
-      ],
-      "problem": "Journal drafts pile up locally. Brand teams and archives don't get them systematically.",
-      "value": "Structured journal-entry corpus for a brand team or your own archive. Chronicle digest included."
-    },
     {
       "slug": "jtbd-tasks",
       "type": "skill",
@@ -2535,7 +2572,7 @@
       "type": "skill",
       "path": ".claude/skills/longrun/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:65c43c8b003cfe34787021a6c34c0b9686f4467269aed304cebba0b4cc1e5346",
+      "content_hash": "sha256:e11e395721186c5e5021266723b942ac8f330f17bff4b495adf316d05674ac01",
       "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.",
       "composes_with": [
         "value-prop",
@@ -2620,7 +2657,7 @@
       "type": "skill",
       "path": ".claude/skills/onboard-repo/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:daaa194480170f0b4745ee5c72d267413d8dc249e4ece2711672118553121667",
+      "content_hash": "sha256:ff92c1539bbad449bbdcfc85430963ceeda8cae67a2eded953bc95dff24a3c75",
       "description": "Bootstrap the bassclef framework in a new repo. Installs the sync hook. Scaffolds config, whereami, and CLAUDE.md. Modes: default, --with-deploy-host, --with-secrets, --full, --greenfield-from-intent (cold-adopter magic demo).",
       "inputs": [
         "Optional flags — --with-deploy-host or --with-secrets or --full"
@@ -2749,7 +2786,7 @@
       "type": "skill",
       "path": ".claude/skills/provision-deploy-host/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:62000692c88b5ceb15d3a04ae3f8c45a97728061e1915368af11f67945643ee1",
+      "content_hash": "sha256:0fca55a7f73e23e0eee612597c9718ea58d020ddd61f81c3143f4ab8791a92a7",
       "description": "Run the consumer onboarding chain — read bassclef-platform.yml plus verify secrets, extend GHA scope, run aws amplify create-app with console-pivot fallback, open the consumer config PR, write an audit row. Replaces the 5-step flow.",
       "inputs": [
         "Consumer name and target host"
@@ -2780,32 +2817,6 @@
       "problem": "Trivial bugs get over-ceremonied by full /diagnose. Small edits shouldn't need the whole chain.",
       "value": "Compressed fix workflow for trivial bugs. Operator-in-loop with stated entry criteria."
     },
-    {
-      "slug": "release",
-      "type": "skill",
-      "path": ".claude/skills/release/SKILL.md",
-      "tier": "lite",
-      "content_hash": "sha256:17b931a7a5d3b69f57bc76f995af5c5c7a967df0389719c9fcbfc7f6677d09a9",
-      "description": "Ship framework files from bassclef-upstream to public bassclef, filtered by tier. Dry-runs first, reports tier counts plus andon scan plus sibling smoke evidence. On operator confirm runs the live release and opens a PR. Per ADR-029.",
-      "composes_with": [
-        "verify",
-        "state-a-problem",
-        "value-prop",
-        "kiss"
-      ],
-      "inputs": [
-        "Optional tier filter",
-        "Dry-run or apply flag"
-      ],
-      "outputs": [
-        "Files shipped",
-        "Dry-run diff",
-        "Public PR",
-        "Tag drop"
-      ],
-      "problem": "Framework files ship from upstream to public bassclef through many manual steps. Dry-run catches slip past.",
-      "value": "Ships framework files from bassclef-upstream to public bassclef. Filtered by tier. Dry-runs first."
-    },
     {
       "slug": "release-notes",
       "type": "skill",
@@ -3726,7 +3737,7 @@
       "type": "standard",
       "path": "standards/lite-manifest-schema-changes.md",
       "tier": "lite",
-      "content_hash": "sha256:1269fad0dfe006a4c52094d4efb441101d87cbd3a85b1a1de0e8ff724fa20e44",
+      "content_hash": "sha256:ba7d81b68af60e4df0e46fd7e0bb52ff756eaa13baf42b0dc679db37521b70a5",
       "description": "Chronological ledger of every lite-manifest schema change. Adopters read this before sync to know what shifted."
     },
     {
@@ -3750,7 +3761,7 @@
       "type": "standard",
       "path": "standards/mechanism-fidelity.md",
       "tier": "lite",
-      "content_hash": "sha256:b212287354832a3613bf9bcdae7da6071df64d8c08f227e8d4233666ccea4d55",
+      "content_hash": "sha256:e0b14abf4a0331c96c488d52c6e3067f827b6ef4d506c19c83616184c53c3642",
       "description": "- ADR-035 — names the substrate-as-system foundational tenet that this standard's audit method verifies - architecture/audits/2026-06-24-closeout.md — bet 24c architect-review that missed this class; this standard's audit fills the lens-gap and…"
     },
     {
@@ -4014,7 +4025,7 @@
       "type": "standard",
       "path": "standards/substrate-config-schema.md",
       "tier": "lite",
-      "content_hash": "sha256:94931a2f1f0e08f4381ddbc464ecd1578170f832a41d263a42f67ac0dfafee48",
+      "content_hash": "sha256:dff6bec2527dfa1cb899fd907b4f802bd4ce7a1e4bb9621bdf3cdfcc05601804",
       "description": "substrate.config.md is the single source of truth for external resource references in any bassclef-substrate repo."
     },
     {

package/dist/lite/standards/mechanism-fidelity.md

@@ -67,6 +67,7 @@ The class fires when one or more of these hold:
 | `NOT-WIRED-BY-DESIGN-CI` | Hook lives on disk and is referenced from `.github/workflows/*.yml`; settings.json is not the right home for it | `pr-body-scrub-check.sh`, `pr-body-loop-discipline-check.sh` |
 | `NOT-WIRED-BY-DESIGN-LAUNCHD` | Hook is scheduled by macOS launchd (or cron); header comment names the scheduler; settings.json is not the right home | `auto-save-idle.sh` |
 | `NOT-WIRED-BY-DESIGN-LIB` | File is sourced by other hooks (library role); header comment says "sourced by"; settings.json is not the right home | `trace-helper.sh` |
+| `NOT-WIRED-BY-DESIGN-EXCLUSIONS` | Hook basename is listed in `presence/install/template-hook-exclusions.txt`; wired in bassclef-upstream settings.json but intentionally absent from the adopter-shipped template (bassclef-team-only or upstream-only substrate) | `lite-skill-key-gate-check.sh`, `user-global-hook-ref-guard-check.sh` |
 | `CLEAN` | All chain steps pass | most existing rules (audit will surface count) |
 
 ## The 5-step verification chain

package/dist/lite/standards/substrate-config-schema.md

@@ -83,7 +83,7 @@ uncommented defaults shown.
 # === Artifacts ===
 journal_doc_id: [per-repo draft Google Doc — pushes from /journal + session-end]
 changelog_doc_id: [per-repo weekly changelog Google Doc — pushes from /release-notes]
-brand_corpus_doc_id: [cross-repo brand team corpus — pushes from /journal-export]
+brand_corpus_doc_id: [cross-repo brand team corpus — pushes from an operator export skill]
 
 # === Environments ===
 deploy_targets:
@@ -213,7 +213,7 @@ reference the raw ID directly.
 
 ### Anti-pattern 2: hardcoded IDs in skills
 
-**Before** (in `.claude/skills/journal-export/SKILL.md`):
+**Before** (in a skill body):
 ```bash
 npx tsx scripts/push-to-gdoc.ts \
   --file docs/journal-corpus/corpus.md \

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebassclef/lite",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",

package/dist/lite/.claude/skills/journal-export/SKILL.md

@@ -1,293 +0,0 @@
----
-tier: lite
-name: journal-export
-description: "Generate a structured journal-entry corpus for a brand team or your own archive \u2014 chronicle digest, draft index, moment inventory. Supports incremental updates."
-problem: "Journal drafts pile up locally. Brand teams and archives don't get them systematically."
-value: "Structured journal-entry corpus for a brand team or your own archive. Chronicle digest included."
-inputs: [Time range or theme filter]
-outputs: [Corpus JSON, Google Doc export, Archive-ready file]
-user_invocable: true
-disable_model_invocation: false
-requires:
-  files: [standards/writing-guide.md]
-  network: true
----
-
-# /journal export — Journal-Entry Corpus
-
-Generate a structured content corpus from session chronicles and existing
-drafts. The corpus gives the brand team everything they need to produce
-journal entries without understanding the codebase.
-
-## Usage
-
-```
-/journal export              → full generation (first run or rebuild)
-/journal export incremental  → update with new sessions since last export
-```
-
-## What the corpus contains
-
-### 1. Chronicle digest
-
-Every session summarized in ~150 words:
-- Date and repo
-- Theme tags (governance, reliability, design, constraint, methodology, product)
-- Key moment (the single most compelling thing that happened)
-- Quotable decision or insight (one sentence a brand team member can latch onto)
-- Audience fit (Board/PE, Engineering, or both)
-
-### 2. Draft index
-
-Every existing journal entry with:
-- Date and source repo
-- Topic/title
-- Variant (A: Board or B: Engineering)
-- Angle taken
-- Status (drafted / published / held)
-- Hook strength assessment
-
-### 3. Moment inventory
-
-Pre-mined moments across major themes. Each moment has:
-- Date, repo, session title
-- What happened (2-3 sentences)
-- Why it matters as a journal entry (tension, stakes, surprise, result)
-- Audience fit and hook strength
-- Whether an existing draft already covers this angle
-
-### 4. Writing guide bundle
-
-Packaged for external handoff:
-- `standards/writing-guide.md` content (journal-entry style guide)
-- Audience definitions (PE/board vs. engineering variants)
-- Vocabulary rules (concept names, not implementation details)
-- Post structure (Hook → Setup → Body → Takeaway)
-
-## Procedure
-
-### Step 1: Locate all sources
-
-```
-Chronicles:
-  ~/src/sunj-labs/bassclef/chronicle/
-  ~/src/your-org/your-app/docs/chronicle/
-  ~/src/your-org/your-second-app/docs/chronicle/
-
-Existing drafts:
-  ~/src/sunj-labs/bassclef/docs/operator-private/journals/
-  ~/src/your-org/your-app/docs/operator-private/journals/
-  ~/src/your-org/your-app/docs/operator-private/journals/legacy/   (pre-substrate content)
-
-Writing guide:
-  ~/src/sunj-labs/bassclef/standards/writing-guide.md
-```
-
-### Step 2: Check for previous export
-
-Look for `docs/journal-corpus/` in bassclef. If it exists and the
-mode is `incremental`:
-- Read `docs/journal-corpus/last-export.md` for the last export date
-- Only process chronicles and drafts newer than that date
-- Append to existing corpus sections
-
-If full mode or no previous export: generate everything from scratch.
-
-### Step 3: Read all chronicles
-
-For each chronicle:
-1. Read the full file
-2. Extract: date, repo, title, tags, key decisions, notable moments
-3. Assign theme tags from this list:
-   - **governance**: rules, gates, guardrails, permissions, ADRs, hooks
-   - **reliability**: failures, diagnosis, fixes, what broke, resilience
-   - **design**: luminaries, prototypes, visual review, UX migration, taste
-   - **constraint**: budget, time budget, scope kills, trade-offs, real stakes
-   - **methodology**: SDLC, choreography, skills, agents, substrate, process
-   - **product**: features built, user-facing outcomes, family use, deals
-   - **infrastructure**: deployment, CI/CD, bassclef sync, tooling
-4. Identify the key moment (strongest journal-worthy content)
-5. Rate audience fit and hook strength
-
-### Step 4: Read all existing drafts
-
-For each draft:
-1. Read the file
-2. Extract: date, topic/title, variant, audience, angle
-3. Note status (drafts in legacy/ are "pre-substrate")
-
-### Step 5: Pre-mine major themes
-
-Run theme matching (same logic as `/journal mine`) for these themes:
-- "The autonomous SDLC journey"
-- "Governance that scales"
-- "Building under constraint"
-- "Design taste in AI agents"
-- "What broke"
-- "From zero to production"
-
-Surface top 3-5 moments per theme.
-
-### Step 6: Assemble the corpus
-
-Write to `docs/journal-corpus/`:
-
-```
-docs/journal-corpus/
-  corpus.md              # main document — digest + index + inventory
-  last-export.md         # metadata for incremental updates
-  writing-guide.md       # copy of standards/writing-guide.md for handoff
-```
-
-**corpus.md** structure:
-
-```markdown
-# Content Corpus — <your-org>
-
-Generated: YYYY-MM-DD
-Sessions covered: N (Dec 2025 - [latest])
-Repos: <list-the-repos-you-mine-chronicles-from>
-
-## How to use this document
-
-This corpus contains the raw material for journal-entry content. Each session
-is summarized with theme tags and a key moment. To write a post:
-
-1. Pick a theme or topic you want to write about
-2. Find moments that serve that theme (use the theme index below)
-3. Pick the strongest moment
-4. Draft a standalone post — every post must work on its own,
-   even if it covers a theme you've posted about before
-
-## Chronicle digest
-
-### [Repo name]
-
-| Date | Title | Themes | Key moment | Audience | Hook |
-|------|-------|--------|-----------|----------|------|
-| ... | ... | ... | ... | ... | ... |
-
-[For each session, a ~150 word summary follows the table]
-
-## Draft index
-
-| Date | Repo | Title | Variant | Audience | Angle | Status |
-|------|------|-------|---------|----------|-------|--------|
-| ... | ... | ... | ... | ... | ... | ... |
-
-## Moment inventory by theme
-
-### [Theme name]
-
-| # | Date | Repo | Moment | Why it's strong | Hook |
-|---|------|------|--------|-----------------|------|
-| ... | ... | ... | ... | ... | ... |
-
-[Repeated for each theme]
-
-## Writing guide
-
-[Full writing guide content]
-```
-
-### Step 7: Push to Google Docs
-
-Push the corpus to the brand team corpus doc. Read the doc ID from
-bassclef's `substrate.config.md` field `brand_corpus_doc_id` — never
-hardcode (per `standards/substrate-config-schema.md`):
-
-```bash
-DOC_ID=$(grep "^brand_corpus_doc_id:" substrate.config.md | awk '{print $2}')
-npx tsx ~/src/your-org/your-app/scripts/push-to-gdoc.ts \
-  --file docs/journal-corpus/corpus.md --replace \
-  --doc-id "$DOC_ID"
-```
-
-Use `--replace` to clear the doc first and re-push the full corpus
-(appending accumulates duplicates over time).
-
-The brand team corpus doc is separate from per-repo draft docs. It
-contains session digests, moment inventory, and writing guide — not
-the full post drafts. The per-repo drafts push separately at session-
-end using each repo's `journal_doc_id`.
-
-All doc IDs live in `substrate.config.md` — never hardcoded here,
-never stored in memory. See `standards/substrate-config-schema.md`
-for the bassclef field convention.
-
-### Step 7a: Defer push when capabilities missing
-
-If `brand_corpus_doc_id` is configured but this session cannot push
-(missing `gcloud-auth` / `google-docs-write` — ephemeral-mobile,
-cloud-web, or desktop without the SA key), DO NOT silently skip. Write
-a deferred-action entry:
-
-```bash
-TS=$(date -u +"%Y-%m-%dT%H-%M-%SZ")
-ID="${TS}-journal-export-corpus-push"
-cp templates/deferred-action-template.md \
-   "docs/deferred-actions/${ID}.md"
-# Fill frontmatter:
-#   pending_action: push-brand-corpus-to-gdoc
-#   requires_capability: [gcloud-auth, google-docs-write]
-#   priority: medium
-#   origin_skill: /journal-export
-#   resolves_when: |
-#     Brand corpus doc <brand_corpus_doc_id> reflects docs/journal-corpus/corpus.md
-# Body should cross-ref the corpus file + last-export.md.
-git add "docs/deferred-actions/${ID}.md"
-git commit -m "chore: defer journal-export corpus-push"
-```
-
-See `.claude/rules/deferred-actions.md` and
-`standards/deferred-actions-schema.md`.
-
-### Step 8: Record metadata
-
-Write `docs/journal-corpus/last-export.md`:
-
-```markdown
----
-last_export: YYYY-MM-DD
-sessions_covered: N
-repos: [<list of mined repos>]
-chronicles_processed: N
-drafts_indexed: N
-themes_mined: N
----
-```
-
-## Incremental mode
-
-When called with `incremental`:
-1. Read `last-export.md` for the cutoff date
-2. Only read chronicles newer than the cutoff
-3. Only read drafts newer than the cutoff
-4. Append new sessions to the chronicle digest
-5. Append new drafts to the draft index
-6. Re-run theme mining with new material included
-7. Update `last-export.md` with new date and counts
-
-## Rules
-
-- The corpus is for external consumption — no internal jargon, file paths,
-  or skill names unless they're in the vocabulary guide
-- Every session gets a summary even if it's "low" hook strength —
-  the brand team decides what's worth writing about
-- Theme tags are additive — a session can have multiple themes
-- The writing guide section uses the SENTINEL_bassclef_version verbatim
-- Incremental updates append, never overwrite existing entries
-
-## Scheduled refresh (Level 1 automation)
-
-The brand team corpus can be kept fresh automatically via a scheduled agent.
-See `docs/journal-corpus/REFRESH.md` for:
-
-- Manual refresh procedure (step-by-step bash commands)
-- Automated refresh setup using the `/schedule` skill (weekly, Monday 9am)
-- A map of all three Google Docs and how each one stays current
-- Troubleshooting guide
-
-## Output discipline
-
-Dispatch `/kiss words --rewrite` on your skill output before you return it. See `standards/skill-output-discipline.md` for the contract.