@thebassclef/lite 1.1.0 → 1.2.0-alpha.1

package/dist/lite/.claude/hooks/hook-classifier-canary.sh

@@ -0,0 +1,158 @@
+#!/usr/bin/env bash
+# tier: lite
+# install-class: project
+# hook-classifier-canary.sh — advises author when a new hook lands
+# without any recognized wiring (settings.json / .github/workflows /
+# scripts/release-to-bassclef.sh / launchd header / sourced-lib
+# header). Fires at PreToolUse on Edit|Write against paths under
+# .claude/hooks/*.sh.
+#
+# Layer 4 cure for sunj-labs/bassclef-upstream#1163. Same class as
+# the hook-wire-on-author rule; extends discipline to catch mislabels
+# at author time — not release time.
+#
+# Anchors: @luminary saltzer-schroeder (complete mediation at earliest
+# cheap gate), @luminary david-parnas (canary hides classifier
+# vocabulary from author), @luminary michael-feathers (characterization
+# tests pin behavior at author boundary).
+#
+# Reads stdin JSON per Claude Code hook contract:
+#   { "tool_name": "Edit|Write", "tool_input": { "file_path": "..." } }
+#
+# Exit codes:
+#   0 — pass (V1 ADVISORY only writes to stderr; V2 may flip to BLOCK)
+#   2 — reserved for V2 BLOCK escalation
+#
+# Override:
+#   SKIP_HOOK_CLASSIFIER_CANARY=1  bypass; logged via trace-helper
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Override
+if [ "${SKIP_HOOK_CLASSIFIER_CANARY:-}" = "1" ]; then
+  TRACE_HELPER="$SCRIPT_DIR/trace-helper.sh"
+  if [ -f "$TRACE_HELPER" ]; then
+    # shellcheck disable=SC1090
+    source "$TRACE_HELPER" 2>/dev/null || true
+    trace_record "hook-classifier-canary" "skipped via SKIP_HOOK_CLASSIFIER_CANARY=1" 2>/dev/null || true
+  fi
+  exit 0
+fi
+
+# Read stdin JSON. If jq not available, degrade gracefully.
+INPUT=$(cat)
+if [ -z "$INPUT" ]; then
+  exit 0
+fi
+
+if command -v jq >/dev/null 2>&1; then
+  TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null || echo "")
+  FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty' 2>/dev/null || echo "")
+else
+  # Fallback — crude sed parse
+  TOOL_NAME=$(echo "$INPUT" | sed -n 's/.*"tool_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
+  FILE_PATH=$(echo "$INPUT" | sed -n 's/.*"file_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -1)
+fi
+
+# Pass-through — non-Edit/Write tools
+case "$TOOL_NAME" in
+  Edit|Write|MultiEdit) ;;
+  *) exit 0 ;;
+esac
+
+# Pass-through — no file path
+[ -z "$FILE_PATH" ] && exit 0
+
+# Pass-through — path outside .claude/hooks/*.sh
+case "$FILE_PATH" in
+  */.claude/hooks/*.sh) ;;
+  *) exit 0 ;;
+esac
+
+# Pass-through — path is under .claude/hooks/tests/ or fixtures
+case "$FILE_PATH" in
+  */.claude/hooks/tests/*|*/.claude/hooks/*/tests/*) exit 0 ;;
+esac
+
+# Get bare hook name for classifier lookup
+HOOK_NAME=$(basename "$FILE_PATH")
+
+# Pass-through — this file exists on disk already (edit, not new)
+if [ -f "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# Load classifier
+LIB="$REPO_ROOT/lib/mechanism-fidelity.sh"
+if [ ! -f "$LIB" ]; then
+  # Classifier lib missing — cannot advise; pass silently
+  exit 0
+fi
+# shellcheck disable=SC1090
+source "$LIB"
+
+# Ask classifier what pattern it detects for this hook name
+PATTERN=$(classify_hook_install_pattern "$HOOK_NAME" "$REPO_ROOT" 2>/dev/null)
+
+# Recognized patterns → pass
+case "$PATTERN" in
+  ci|launchd|lib|release)
+    exit 0
+    ;;
+esac
+
+# Standard means classifier could not place it AND file does not exist yet.
+# Check settings.json — hook may be wired for PreToolUse there.
+SETTINGS="$REPO_ROOT/.claude/settings.json"
+if [ -f "$SETTINGS" ] && grep -qF "$HOOK_NAME" "$SETTINGS" 2>/dev/null; then
+  exit 0
+fi
+
+# No recognized wiring signal found. Emit ADVISORY.
+cat >&2 <<EOF
+
+============================================
+🚨 hook-classifier-canary — ADVISORY
+============================================
+
+New hook detected:   $HOOK_NAME
+Author path:         $FILE_PATH
+
+The classifier at lib/mechanism-fidelity.sh does not recognize any
+wiring signal for this hook. If this ships as-is, the cold-adopter
+harness Shape d checks will flag it as DEAD-LETTER.
+
+Five remediation paths (pick one before commit):
+
+  1. settings.json wiring — add hook entry to .claude/settings.json
+     under PreToolUse/PostToolUse/SessionStart/Stop event matcher.
+     For hooks that fire on tool calls.
+
+  2. CI workflow — reference the hook name in a .github/workflows/*.yml
+     file. For hooks that fire on push/PR events.
+
+  3. Release script — reference the hook name in
+     scripts/release-to-bassclef.sh. For hooks that gate on /release
+     dispatch. Classifier returns "release".
+
+  4. launchd header — add "# Runs via launchd" (or "scheduled job" /
+     "cron job") to the hook's top-of-file comment block. For
+     scheduled jobs. Classifier returns "launchd".
+
+  5. Sourced-library header — add "# sourced by <caller>" to the
+     hook's top-of-file comment block. For helper libraries loaded
+     via source. Classifier returns "lib".
+
+If genuinely bypassing (rare): SKIP_HOOK_CLASSIFIER_CANARY=1 <command>
+
+Per rule: .claude/rules/hook-wire-on-author.md
+Per Layer 4 of: bassclef-upstream#1163
+============================================
+
+EOF
+
+# V1 — ADVISORY only. V2 may flip to exit 2 (BLOCK).
+exit 0

package/dist/lite/.claude/hooks/kiss-default-check.sh

@@ -0,0 +1,129 @@
+#!/bin/bash
+# tier: lite
+# install-class: project
+# kiss-default-check.sh — pre-push /kiss enforcement check
+# Per bassclef#907 Part 4.
+#
+# Reads a draft body file. Checks for BLOCK-tier bassclef-internal jargon
+# per standards/bassclef-internal-jargon.md. BLOCKs if jargon present and
+# no opt-out signal.
+#
+# Composes with .claude/hooks/pr-body-scrub-check.sh (CI-time enforcement).
+# This hook runs pre-push; the scrub hook runs at CI. Both read the same
+# BLOCK list from the standards source-of-truth.
+#
+# Usage:
+#   bash kiss-default-check.sh <body-file>
+#
+# Optional env:
+#   PR_LABELS=label1,label2,...           — labels on the PR (newline or comma separated)
+#   SKIP_KISS=1                           — operator opt-out for one invocation
+#   KISS_STANDARDS_FILE=<path>            — override standards file location (testing)
+#
+# Exit codes:
+#   0 — pass (no BLOCK terms found, OR opt-out signal present)
+#   1 — block (BLOCK terms found + no opt-out)
+#   2 — usage error
+
+set +e
+
+BODY_FILE="${1:-}"
+if [ -z "$BODY_FILE" ] || [ ! -f "$BODY_FILE" ]; then
+  echo "usage: $0 <body-file>" >&2
+  exit 2
+fi
+
+# Find the repo root + standards file
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+STANDARDS_FILE="${KISS_STANDARDS_FILE:-$REPO_ROOT/standards/bassclef-internal-jargon.md}"
+
+if [ ! -f "$STANDARDS_FILE" ]; then
+  # Try the bassclef-sync'd path (when run from a consumer repo)
+  STANDARDS_FILE="${HOME}/src/sunj-labs/bassclef/standards/bassclef-internal-jargon.md"
+fi
+
+if [ ! -f "$STANDARDS_FILE" ]; then
+  echo "kiss-default-check: standards file not found at $STANDARDS_FILE" >&2
+  echo "  set KISS_STANDARDS_FILE=<path> or skip this check" >&2
+  exit 2
+fi
+
+# Opt-out — env var
+if [ "${SKIP_KISS:-0}" = "1" ]; then
+  echo "kiss-default-check: SKIP_KISS=1 — skipped (logged)" >&2
+  exit 0
+fi
+
+# Opt-out — label
+PR_LABELS="${PR_LABELS:-}"
+LABELS_NORMALIZED=$(echo "$PR_LABELS" | tr ',' '\n' | sed 's/^ *//;s/ *$//' | grep -v '^$' || true)
+if echo "$LABELS_NORMALIZED" | grep -qx "bassclef-internal-prose-ok"; then
+  echo "kiss-default-check: bassclef-internal-prose-ok label — advisory mode" >&2
+  ADVISORY=1
+else
+  ADVISORY=0
+fi
+
+# Extract BLOCK terms from the standards table
+# The standards table has lines like: | term | plain-english | BLOCK |
+# Allows digits in the first column so terms like "12-pattern matcher"
+# (added under bassclef-upstream#101) are picked up.
+BLOCK_TERMS=$(awk -F'|' '
+  /^\| [a-zA-Z0-9-]+ / && /BLOCK *\|$/ {
+    gsub(/^ +| +$/, "", $2)
+    print $2
+  }
+' "$STANDARDS_FILE")
+
+if [ -z "$BLOCK_TERMS" ]; then
+  echo "kiss-default-check: no BLOCK terms found in standards file" >&2
+  exit 0
+fi
+
+# Strip code blocks + inline backtick spans + URLs so they don't trigger false positives
+SCRUBBED=$(awk '
+  BEGIN { in_code = 0 }
+  /^```/ { in_code = !in_code; next }
+  in_code { next }
+  { print }
+' "$BODY_FILE" | sed -E 's/`[^`]*`//g; s|https?://[^ )]+||g')
+
+# Check each BLOCK term
+FINDINGS=""
+FINDING_COUNT=0
+while IFS= read -r term; do
+  [ -z "$term" ] && continue
+  count=$(echo "$SCRUBBED" | grep -ioE "\\b${term}\\b" | wc -l | tr -d ' ')
+  if [ "$count" -gt 0 ]; then
+    FINDINGS="${FINDINGS}- \`${term}\` (${count}x)"$'\n'
+    FINDING_COUNT=$((FINDING_COUNT + count))
+  fi
+done <<< "$BLOCK_TERMS"
+
+if [ "$FINDING_COUNT" -eq 0 ]; then
+  echo "kiss-default-check: pass — no BLOCK terms in draft" >&2
+  exit 0
+fi
+
+# Report findings
+{
+  echo ""
+  echo "kiss-default-check: $FINDING_COUNT BLOCK-tier jargon term(s) found in draft body:"
+  echo ""
+  echo "$FINDINGS"
+  echo "Plain-English alternatives at: $STANDARDS_FILE"
+  echo ""
+  echo "Options:"
+  echo "  1. Run /kiss --grade11 on the draft and re-push"
+  echo "  2. Add label 'bassclef-internal-prose-ok' for advisory-only"
+  echo "  3. Set SKIP_KISS=1 for one-time bypass (logged)"
+  echo ""
+} >&2
+
+if [ "$ADVISORY" = "1" ]; then
+  echo "kiss-default-check: ADVISORY (label) — passing with warnings" >&2
+  exit 0
+fi
+
+exit 1

package/dist/lite/.claude/hooks/multi-tenancy-check.sh

@@ -0,0 +1,83 @@
+#!/bin/bash
+# tier: lite
+# Multi-Tenancy Check — bassclef template.
+# Fires on Edit/Write of source files.
+# Warns when tenant-scoped patterns are missing.
+#
+# App repos should customize:
+#   TENANT_MODELS — pipe-separated list of tenant-scoped model names
+#   TENANT_CONTEXT_FN — function name that resolves tenant context
+#   TENANT_PARAMS_FN — function name for tenant-specific parameters
+#
+# Override by placing your own multi-tenancy-check.sh in .claude/hooks/
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.file_path // ""')
+CONTENT=$(echo "$INPUT" | jq -r '.tool_input.new_string // .tool_input.content // ""')
+
+# Skip non-source files
+if echo "$FILE_PATH" | grep -qE '\.(sh|json|md)$|/\.claude/|/memory/|/docs/|/scripts/|__tests__'; then
+  exit 0
+fi
+
+# === Customizable per project (override these in your app's copy) ===
+TENANT_CONTEXT_FN="${TENANT_CONTEXT_FN:-getTenantContext}"
+TENANT_PARAMS_FN="${TENANT_PARAMS_FN:-getTenantParams}"
+# Default: no models (app must define its own)
+TENANT_MODELS="${TENANT_MODELS:-}"
+
+# Skip if no tenant models defined (not a multi-tenant project)
+if [ -z "$TENANT_MODELS" ]; then
+  exit 0
+fi
+
+WARNINGS=""
+
+# Check 1: Hardcoded numeric thresholds that should use params facade
+if echo "$CONTENT" | grep -qE '[0-9]{3,}\.?[0-9]*\.?[0-9]*' ; then
+  if echo "$CONTENT" | grep -qE '_FLOOR|_CEILING|_THRESHOLD|_LIMIT|_MIN|_MAX'; then
+    if ! echo "$CONTENT" | grep -q "$TENANT_PARAMS_FN"; then
+      WARNINGS="${WARNINGS}
+MULTI-TENANCY: Possible hardcoded threshold detected.
+    Use ${TENANT_PARAMS_FN}() instead of hardcoded values.
+    Financial and geographic thresholds must flow through
+    the tenant params facade for multi-tenant readiness."
+    fi
+  fi
+fi
+
+# Check 2: Prisma queries on tenant-scoped models without context
+if echo "$CONTENT" | grep -qiE "prisma\.(${TENANT_MODELS})\.(findMany|findFirst|create|update|delete)" ; then
+  if ! echo "$CONTENT" | grep -q "$TENANT_CONTEXT_FN"; then
+    WARNINGS="${WARNINGS}
+MULTI-TENANCY: Query on tenant-scoped model without ${TENANT_CONTEXT_FN}().
+    Tenant-scoped models must be filtered by tenant/user context.
+    Use ${TENANT_CONTEXT_FN}() and filter appropriately."
+  fi
+fi
+
+# Check 3: API routes missing tenant context
+if echo "$FILE_PATH" | grep -qE 'src/app/api/.*route\.ts'; then
+  if echo "$CONTENT" | grep -qE 'export async function (GET|POST|PATCH|DELETE|PUT)'; then
+    if ! echo "$CONTENT" | grep -q "$TENANT_CONTEXT_FN"; then
+      WARNINGS="${WARNINGS}
+MULTI-TENANCY: API route handler without ${TENANT_CONTEXT_FN}().
+    All API routes touching tenant-scoped data must resolve
+    tenant context. Even GET routes need this for data isolation."
+    fi
+  fi
+fi
+
+if [ -n "$WARNINGS" ]; then
+  echo "============================================"
+  echo "MULTI-TENANCY GUARDRAIL"
+  echo "============================================"
+  echo "$WARNINGS"
+  echo ""
+  echo "These are WARNs, not BLOCKs. If this is intentional"
+  echo "(e.g., platform-wide data), proceed."
+  echo "If tenant-scoped, add the missing context/facade."
+  echo "============================================"
+fi
+
+exit 0

package/dist/lite/.claude/hooks/oo-ad-entry-point-check.sh

@@ -0,0 +1,216 @@
+#!/bin/bash
+# tier: lite
+# oo-ad-entry-point-check.sh — PreToolUse Edit/Write hook mechanizing .claude/rules/oo-ad-entry-point.md.
+#
+# Fires on Write to a new file matching the rule's globs. Requires:
+#   1. A decomposition marker at state/markers/decompose/<branch>.marker
+#      OR any file under docs/decompositions/
+#   2. A use-case artifact under docs/use-cases/ matching the code class
+#
+# Per bassclef-upstream#1169 + canvas docs/canvases/2026-08-25-ooad-chain-as-substrate-offering.md.
+# Composes with .claude/hooks/adr-discipline-check.sh (sister hook on architectural boundaries).
+# Override: SKIP_OO_AD_ENTRY_POINT=1 (logged via trace-helper).
+
+set -euo pipefail
+
+# ============================================================================
+# Read stdin JSON from Claude Code harness
+# ============================================================================
+PAYLOAD=$(cat 2>/dev/null || echo '{}')
+
+TOOL_NAME=$(echo "$PAYLOAD" | jq -r '.tool_name // empty' 2>/dev/null)
+FILE_PATH=$(echo "$PAYLOAD" | jq -r '.tool_input.file_path // empty' 2>/dev/null)
+
+# ============================================================================
+# Filter: only fire on Write / Edit / MultiEdit
+# ============================================================================
+case "$TOOL_NAME" in
+  Write|Edit|MultiEdit) ;;
+  *) exit 0 ;;
+esac
+
+# Defensive precondition — empty file_path
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# ============================================================================
+# Override check
+# ============================================================================
+if [ "${SKIP_OO_AD_ENTRY_POINT:-0}" = "1" ]; then
+  TRACE_HELPER="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/trace-helper.sh"
+  if [ -f "$TRACE_HELPER" ]; then
+    bash "$TRACE_HELPER" override "oo-ad-entry-point-check" "SKIP_OO_AD_ENTRY_POINT=1 on $FILE_PATH" 2>/dev/null || true
+  fi
+  exit 0
+fi
+
+# ============================================================================
+# Path matcher — classify code class per rule oo-ad-entry-point.md L18-25
+# Bash case globs do NOT expand ** — use per-level cases + src/ recursive fallback.
+# ============================================================================
+CODE_CLASS=""
+case "$FILE_PATH" in
+  */.claude/hooks/*.sh|.claude/hooks/*.sh)
+    CODE_CLASS="substrate-hook"
+    ;;
+  */lib/*.sh|lib/*.sh)
+    CODE_CLASS="substrate-lib"
+    ;;
+  */scripts/*.sh|scripts/*.sh)
+    CODE_CLASS="adopter-script"
+    ;;
+esac
+
+# src/ handled via recursive path check — any depth under src/ with .ts/.tsx/.js/.py extension
+if [ -z "$CODE_CLASS" ]; then
+  case "$FILE_PATH" in
+    src/*|*/src/*)
+      case "$FILE_PATH" in
+        *.ts|*.tsx|*.js|*.py) CODE_CLASS="adopter-app" ;;
+      esac
+      ;;
+  esac
+fi
+
+# Not a matched path → pass through
+if [ -z "$CODE_CLASS" ]; then
+  exit 0
+fi
+
+# ============================================================================
+# Cockburn casual tier — existing file Edit passes through
+# ============================================================================
+# Edit / MultiEdit on existing files needs no new artifacts per rule L24.
+# Only new files (Write, OR Edit of missing file) require ceremony.
+REPO_ROOT="${HOOK_TEST_REPO_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+
+# Resolve absolute path — file_path may be relative
+if [ "${FILE_PATH:0:1}" = "/" ]; then
+  ABS_PATH="$FILE_PATH"
+else
+  ABS_PATH="$REPO_ROOT/$FILE_PATH"
+fi
+
+if [ -f "$ABS_PATH" ]; then
+  exit 0
+fi
+
+# ============================================================================
+# Decomposition check
+# ============================================================================
+BRANCH="${HOOK_TEST_BRANCH:-}"
+if [ -z "$BRANCH" ]; then
+  BRANCH=$(cd "$REPO_ROOT" && git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
+fi
+
+MARKER_PATH="$REPO_ROOT/state/markers/decompose/${BRANCH}.marker"
+DECOMP_DIR="$REPO_ROOT/docs/decompositions"
+
+DECOMP_OK=0
+if [ -f "$MARKER_PATH" ]; then
+  DECOMP_OK=1
+elif [ -d "$DECOMP_DIR" ] && find "$DECOMP_DIR" -maxdepth 1 -name '*.md' -type f 2>/dev/null | grep -q .; then
+  DECOMP_OK=1
+fi
+
+# ============================================================================
+# Use case check per code class
+# ============================================================================
+UC_DIR="$REPO_ROOT/docs/use-cases"
+UC_OK=0
+
+if [ -d "$UC_DIR" ]; then
+  case "$CODE_CLASS" in
+    adopter-app)
+      # UC-*.md that does NOT start with UC-hook-, UC-lib-, or UC-script-
+      if find "$UC_DIR" -maxdepth 1 -name 'UC-*.md' -type f \
+           -not -name 'UC-hook-*' -not -name 'UC-lib-*' -not -name 'UC-script-*' \
+           2>/dev/null | grep -q .; then
+        UC_OK=1
+      fi
+      ;;
+    substrate-hook)
+      if find "$UC_DIR" -maxdepth 1 -name 'UC-hook-*.md' -type f 2>/dev/null | grep -q .; then
+        UC_OK=1
+      fi
+      ;;
+    substrate-lib)
+      if find "$UC_DIR" -maxdepth 1 -name 'UC-lib-*.md' -type f 2>/dev/null | grep -q .; then
+        UC_OK=1
+      fi
+      ;;
+    adopter-script)
+      if find "$UC_DIR" -maxdepth 1 -name 'UC-script-*.md' -type f 2>/dev/null | grep -q .; then
+        UC_OK=1
+      fi
+      ;;
+  esac
+fi
+
+# ============================================================================
+# Pass or block
+# ============================================================================
+if [ "$DECOMP_OK" -eq 1 ] && [ "$UC_OK" -eq 1 ]; then
+  exit 0
+fi
+
+# ============================================================================
+# Block message
+# ============================================================================
+case "$CODE_CLASS" in
+  adopter-app)
+    CEREMONY="Fully-dressed use case + /decompose + /spec"
+    UC_PATTERN="docs/use-cases/UC-<slug>.md"
+    ;;
+  substrate-hook)
+    CEREMONY="Brief use case + /decompose"
+    UC_PATTERN="docs/use-cases/UC-hook-<slug>.md"
+    ;;
+  substrate-lib)
+    CEREMONY="Brief use case + /decompose"
+    UC_PATTERN="docs/use-cases/UC-lib-<slug>.md"
+    ;;
+  adopter-script)
+    CEREMONY="Brief use case + Tier 0 tests"
+    UC_PATTERN="docs/use-cases/UC-script-<slug>.md"
+    ;;
+esac
+
+cat >&2 <<EOF
+🛑 oo-ad-entry-point-check — BLOCK (bassclef-upstream#1169)
+
+You are creating a new file in the ${CODE_CLASS} class.
+
+Path: ${FILE_PATH}
+Branch: ${BRANCH}
+
+The rule .claude/rules/oo-ad-entry-point.md requires design artifacts
+before this file lands. Ceremony for this class:
+  ${CEREMONY}
+
+Missing artifacts:
+$([ "$DECOMP_OK" -eq 0 ] && echo "  - Decomposition: marker at ${MARKER_PATH} OR any file under docs/decompositions/")
+$([ "$UC_OK" -eq 0 ] && echo "  - Use case: ${UC_PATTERN}")
+
+Three resolution paths:
+
+1. Run /decompose to produce the decomposition, then write a use case.
+   Touch the marker after:
+     mkdir -p $(dirname "$MARKER_PATH")
+     touch $MARKER_PATH
+
+2. Write the artifacts by hand per the rule table (L18-25) and touch
+   the marker.
+
+3. Override for genuine trivial work:
+     SKIP_OO_AD_ENTRY_POINT=1 <command>
+
+Then retry the original write.
+
+Per .claude/rules/oo-ad-entry-point.md
+Composes with .claude/hooks/adr-discipline-check.sh
+Cockburn ceremony tiering — Writing Effective Use Cases (2000)
+EOF
+
+exit 2