@dragonflymcp/plugin 1.0.0

package/templates/health/status.yaml.template

@@ -0,0 +1,120 @@
+# Zen Context Health Status
+# This file gives Claude awareness of its own context state
+#
+# Updated by: post-concept-action hook, pre-tool-grounding hook
+# Read by: Claude before operations, /health command
+#
+# Claude should read this to calibrate confidence in its understanding
+
+health_id: "health-current"
+generated_at: "${TIMESTAMP}"
+version: "1.0.0"
+
+# ============================================================================
+# TOKEN BUDGET STATUS
+# ============================================================================
+tokens:
+  estimated_used: 0
+  budget_total: 200000
+  budget_remaining: 200000
+  usage_percent: 0.0
+  zone: "green"  # green (<70%), yellow (70-80%), red (>80%)
+
+# Zone meanings:
+#   green:  Safe to continue normally
+#   yellow: Consider compacting, be more careful
+#   red:    High risk of context loss, verify before acting
+
+# ============================================================================
+# COMPRESSION STATUS
+# ============================================================================
+compression:
+  last_compaction: null
+  compressions_this_session: 0
+  data_potentially_lost: []
+  # Example when compression occurs:
+  # data_potentially_lost:
+  #   - "Detailed error messages from turns 1-15"
+  #   - "Specific file paths discussed early in session"
+  #   - "Rationale for early decisions"
+
+# ============================================================================
+# SESSION CONTINUITY
+# ============================================================================
+session:
+  started_at: "${TIMESTAMP}"
+  interactions: 0
+  concepts_executed: 0
+  checkpoints_created: 0
+  last_action: null
+  # Example:
+  # last_action:
+  #   concept: "implementation"
+  #   action: "generate"
+  #   timestamp: "2025-12-05T10:30:00Z"
+
+# ============================================================================
+# GROUNDING STATUS
+# ============================================================================
+grounding:
+  last_grounding_check: "${TIMESTAMP}"
+  directory_verified: true
+  rules_loaded: true
+  anchors_current: true
+  safety_constraints_active: true
+
+# ============================================================================
+# CONFIDENCE INDICATORS
+# ============================================================================
+confidence:
+  overall: "high"  # high, medium, low
+  factors:
+    context_fresh: true
+    no_compression: true
+    anchors_loaded: true
+    recent_verification: true
+
+# Confidence meanings:
+#   high:   Proceed normally
+#   medium: Verify assumptions before destructive ops
+#   low:    Re-read anchors, verify state before any action
+
+# ============================================================================
+# WARNINGS FOR CLAUDE TO SEE
+# ============================================================================
+warnings: []
+# Example warnings:
+# - type: "compression_occurred"
+#   message: "Context was compressed 2 turns ago. Verify assumptions."
+#   severity: "medium"
+#   recommendation: "Re-read koan/anchors/ before destructive operations"
+#
+# - type: "directory_mismatch"
+#   message: "Working directory may have changed"
+#   severity: "high"
+#   recommendation: "Run 'pwd' to verify current location"
+#
+# - type: "long_session"
+#   message: "Session has 50+ interactions, context may be degraded"
+#   severity: "low"
+#   recommendation: "Consider creating a checkpoint"
+
+# ============================================================================
+# RECOMMENDATIONS
+# ============================================================================
+recommendations: []
+# Example recommendations based on state:
+# - "Continue normally - context is healthy"
+# - "Consider running /checkpoint before next major operation"
+# - "Re-read koan/anchors/rules.anchor.yaml to refresh safety rules"
+
+# ============================================================================
+# RECOVERY INFORMATION
+# ============================================================================
+recovery:
+  last_checkpoint: null
+  checkpoint_available: false
+  # Example when checkpoint exists:
+  # last_checkpoint: "ckpt-003-impl"
+  # checkpoint_available: true
+  # checkpoint_phase: "implementation_complete"

package/templates/hooks/concept-complete.sh.template

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# Zen Concept Complete Hook
+#
+# Called by agent frontmatter when a concept completes.
+# Records concept-specific completion data via SQLite events.
+#
+# Usage: concept-complete.sh <concept-name>
+#
+# Arguments:
+#   $1 - Concept name (story, architecture, implementation, quality, version, context)
+
+set -e
+
+CONCEPT_NAME="${1:-unknown}"
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+source "$PROJECT_ROOT/.claude/hooks/lib/common.sh"
+
+# Log concept completion to SQLite
+if zen_state_available; then
+  zen_event_log "concept-complete-$(date +%s%N)" "concept_complete_frontmatter" "{\"concept\":\"$CONCEPT_NAME\"}" || true
+fi
+
+# Concept-specific post-processing
+case "$CONCEPT_NAME" in
+  story)
+    # Could trigger story validation or sync evaluation
+    ;;
+  architecture)
+    # Could trigger ADR generation or diagram updates
+    ;;
+  implementation)
+    # Could trigger test generation or linting
+    ;;
+  quality)
+    # Could trigger coverage report generation
+    ;;
+  version)
+    # Could trigger changelog updates
+    ;;
+  context)
+    # Could trigger checkpoint creation
+    ;;
+esac
+
+exit 0

package/templates/hooks/lib/common.sh.template

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+# Zen Hook Common Library
+#
+# Shared functions and variables for all Zen hooks.
+# Source this at the top of any hook script:
+#
+#   source "$(dirname "$0")/lib/common.sh"
+#
+# Or from deployed location:
+#   HOOKS_DIR="${HOOKS_DIR:-$(dirname "$0")}"
+#   source "$HOOKS_DIR/lib/common.sh"
+#
+# Provides:
+#   Variables: PROJECT_ROOT, KOAN_DIR, STATE_DB, etc.
+#   Functions: zen_timestamp, zen_git_*, zen_ensure_dir, zen_state_available, zen_event_log, etc.
+
+# =============================================================================
+# Project Paths
+# =============================================================================
+
+PROJECT_ROOT="${PROJECT_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"
+
+KOAN_DIR="$PROJECT_ROOT/koan"
+HEALTH_DIR="$KOAN_DIR/health"
+HOOKS_DIR="$PROJECT_ROOT/.claude/hooks"
+
+# =============================================================================
+# Timestamps
+# =============================================================================
+
+# ISO 8601 UTC timestamp (e.g., 2026-01-15T08:30:00Z)
+zen_timestamp_iso() {
+  date -u +"%Y-%m-%dT%H:%M:%SZ"
+}
+
+# Compact timestamp for IDs (e.g., 20260115-083000)
+zen_timestamp_compact() {
+  date -u +"%Y%m%d-%H%M%S"
+}
+
+# Epoch seconds (for unique IDs)
+zen_timestamp_epoch() {
+  date +%s
+}
+
+# Convenience: set TIMESTAMP to ISO format (most common usage)
+TIMESTAMP="${TIMESTAMP:-$(zen_timestamp_iso)}"
+
+# =============================================================================
+# Git Context
+# =============================================================================
+
+# Current branch name
+zen_git_branch() {
+  git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown"
+}
+
+# Short hash of HEAD
+zen_git_short_hash() {
+  git rev-parse --short HEAD 2>/dev/null || echo "unknown"
+}
+
+# Last commit as "hash subject"
+zen_git_last_commit() {
+  git log -1 --format="%h %s" 2>/dev/null || echo "no commits"
+}
+
+# Count of uncommitted files (staged + unstaged + untracked)
+zen_git_uncommitted_count() {
+  git status --porcelain 2>/dev/null | wc -l | tr -d ' '
+}
+
+# =============================================================================
+# Directory Helpers
+# =============================================================================
+
+# Ensure one or more directories exist.
+# Usage: zen_ensure_dir "/path/to/dir1" "/path/to/dir2"
+zen_ensure_dir() {
+  for dir in "$@"; do
+    mkdir -p "$dir"
+  done
+}
+
+# =============================================================================
+# SQLite State Helpers (state.db — single source of truth)
+# =============================================================================
+
+STATE_DB="$KOAN_DIR/state/state.db"
+
+# Check if sqlite3 is available and state.db exists
+zen_state_available() {
+  command -v sqlite3 &>/dev/null && [ -f "$STATE_DB" ]
+}
+
+# ─── Health ────────────────────────────────────────────────
+
+# Read health from SQLite. Output: "pct|zone"
+zen_health_get() {
+  sqlite3 "$STATE_DB" "SELECT context_usage_percent, zone FROM health ORDER BY rowid DESC LIMIT 1;" 2>/dev/null
+}
+
+# Write health to SQLite (upsert)
+zen_health_update() {
+  local pct="$1" zone="$2"
+  sqlite3 "$STATE_DB" "INSERT OR REPLACE INTO health (id, context_usage_percent, zone, updated_at) VALUES (1, $pct, '$zone', datetime('now'));" 2>/dev/null
+}
+
+# ─── Events ───────────────────────────────────────────────
+
+# Log an event to SQLite
+zen_event_log() {
+  local id="$1" type="$2" data="$3"
+  sqlite3 "$STATE_DB" "INSERT OR IGNORE INTO events (id, type, data, created_at) VALUES ('$id', '$type', '${data//\'/\'\'}', datetime('now'));" 2>/dev/null
+}
+
+# ─── Checkpoints ──────────────────────────────────────────
+
+# Save a checkpoint to SQLite
+zen_checkpoint_save() {
+  local id="$1" name="$2" type="$3" data="$4"
+  sqlite3 "$STATE_DB" "INSERT OR IGNORE INTO checkpoints (id, name, type, data, created_at) VALUES ('$id', '$name', '$type', '${data//\'/\'\'}', datetime('now'));" 2>/dev/null
+}
+
+# Count checkpoints in SQLite
+zen_checkpoint_count() {
+  sqlite3 "$STATE_DB" "SELECT COUNT(*) FROM checkpoints;" 2>/dev/null || echo "0"
+}
+
+# Get latest checkpoint. Output: "id|name|type|created_at"
+zen_checkpoint_latest() {
+  sqlite3 "$STATE_DB" "SELECT id, name, type, created_at FROM checkpoints ORDER BY created_at DESC LIMIT 1;" 2>/dev/null
+}
+
+# Get minutes since last checkpoint (returns 9999 if no checkpoints)
+zen_checkpoint_age_minutes() {
+  sqlite3 "$STATE_DB" "SELECT CAST((julianday('now') - julianday(created_at)) * 1440 AS INTEGER) FROM checkpoints ORDER BY created_at DESC LIMIT 1;" 2>/dev/null || echo "9999"
+}
+
+# Count checkpoints by type
+zen_checkpoint_count_by_type() {
+  local type="$1"
+  sqlite3 "$STATE_DB" "SELECT COUNT(*) FROM checkpoints WHERE type='$type';" 2>/dev/null || echo "0"
+}
+
+# Get description from latest checkpoint JSON data
+zen_checkpoint_latest_description() {
+  sqlite3 "$STATE_DB" "SELECT json_extract(data, '$.description') FROM checkpoints ORDER BY created_at DESC LIMIT 1;" 2>/dev/null || echo ""
+}
+
+# =============================================================================
+# Logging
+# =============================================================================
+
+# Append a timestamped log entry.
+# Usage: zen_log <file> <level> <message>
+zen_log() {
+  local file="$1" level="$2" message="$3"
+  echo "[$(zen_timestamp_iso)] [$level] $message" >> "$file"
+}

package/templates/hooks/post-commit.sh.template

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# Zen Post-Commit Hook
+#
+# Called after version.commit completes successfully.
+# Logs commit data to SQLite events.
+#
+# Usage: post-commit.sh <story-id> <commit-hash> <flow-id>
+#
+# Arguments:
+#   $1 - Story ID associated with this commit
+#   $2 - Git commit hash
+#   $3 - Flow ID for provenance tracking
+
+set -e
+
+STORY_ID="${1:-unknown}"
+COMMIT_HASH="${2:-unknown}"
+FLOW_ID="${3:-unknown}"
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+source "$PROJECT_ROOT/.claude/hooks/lib/common.sh"
+
+# Get commit message
+COMMIT_MSG=""
+if [ "$COMMIT_HASH" != "unknown" ]; then
+  COMMIT_MSG=$(git log -1 --format="%s" "$COMMIT_HASH" 2>/dev/null || echo "")
+fi
+
+# Log commit to SQLite
+if zen_state_available; then
+  # Escape commit message for JSON (replace quotes and newlines)
+  SAFE_MSG=$(echo "$COMMIT_MSG" | tr '"' "'" | tr '\n' ' ')
+  zen_event_log "commit-$(date +%s)" "git_commit" "{\"story_id\":\"$STORY_ID\",\"commit_hash\":\"$COMMIT_HASH\",\"flow_id\":\"$FLOW_ID\",\"message\":\"$SAFE_MSG\"}" || true
+fi
+
+# Output for hook runner
+echo "post-commit: $STORY_ID -> $COMMIT_HASH"
+exit 0

package/templates/hooks/post-concept-action.template

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Zen Post-Concept-Action Hook
+#
+# This hook runs after any concept completes an action.
+# It logs provenance to SQLite events and can trigger synchronizations.
+#
+# Hook Contract:
+# - Receives action data via environment variables
+# - Creates provenance event in SQLite
+# - Must complete quickly (<100ms)
+#
+# Environment Variables (set by Claude Code):
+# - ZEN_CONCEPT: Which concept performed the action
+# - ZEN_ACTION: Which action was performed
+# - ZEN_ACTION_ID: Unique action identifier
+# - ZEN_STATUS: Action status (completed/blocked/failed)
+# - ZEN_FLOW_ID: Parent flow identifier (if part of workflow)
+# - ZEN_TRIGGERED_BY: Parent action ID (if triggered by sync)
+# - ZEN_SYNC_ID: Synchronization rule ID (if triggered by sync)
+# - ZEN_MODEL: Which model was used (haiku/sonnet)
+# - ZEN_COST_USD: Estimated cost in USD
+
+set -e
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+source "$PROJECT_ROOT/.claude/hooks/lib/common.sh"
+
+# Generate action ID if not provided
+ACTION_ID="${ZEN_ACTION_ID:-act-$(date +%s)}"
+GIT_BRANCH="$(zen_git_branch)"
+GIT_COMMIT="$(zen_git_short_hash)"
+
+# Log provenance event to SQLite
+if zen_state_available; then
+  zen_event_log "$ACTION_ID" "concept_action" "{\"concept\":\"${ZEN_CONCEPT:-unknown}\",\"action\":\"${ZEN_ACTION:-unknown}\",\"status\":\"${ZEN_STATUS:-unknown}\",\"flow_id\":\"${ZEN_FLOW_ID:-null}\",\"triggered_by\":\"${ZEN_TRIGGERED_BY:-null}\",\"sync_id\":\"${ZEN_SYNC_ID:-null}\",\"model\":\"${ZEN_MODEL:-unknown}\",\"cost_usd\":${ZEN_COST_USD:-0.0},\"git_branch\":\"$GIT_BRANCH\",\"git_commit\":\"$GIT_COMMIT\"}" || true
+fi
+
+# Success
+exit 0

package/templates/hooks/post-tool-structure-check.sh.template

@@ -0,0 +1,138 @@
+#!/usr/bin/env bash
+# Zen Project Structure Validation Hook
+#
+# Runs after Write/Edit tool use to detect files in wrong locations.
+# Warns but does not block (to avoid breaking workflows).
+#
+# Protected directories:
+#   - koan/     → ONLY state files (.yaml, .db) allowed
+#   - .claude/  → ONLY Zen config files allowed
+#   - .zen/     → NEVER modify (submodule)
+
+set -e
+
+# Get tool input from stdin (JSON)
+INPUT=$(cat)
+
+# Extract file path from tool input
+# Handles both Write and Edit tools
+FILE_PATH=$(echo "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -n 1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
+
+# If no file path found, exit silently
+[ -z "$FILE_PATH" ] && exit 0
+
+# Get project root
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+
+# Make path relative for checking
+REL_PATH="${FILE_PATH#$PROJECT_ROOT/}"
+
+# Function to output warning
+warn() {
+    echo ""
+    echo "⚠️  PROJECT STRUCTURE WARNING"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "$1"
+    echo ""
+    echo "See: .claude/skills/project-structure.md"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+}
+
+# Check 1: .zen/ directory (NEVER modify)
+if [[ "$REL_PATH" == .zen/* ]]; then
+    warn "Modifying .zen/ submodule is not allowed.
+
+File: $REL_PATH
+
+The .zen/ directory is a git submodule and should never be modified.
+To customize Zen, edit files in .claude/ instead."
+    exit 0
+fi
+
+# Check 2: koan/ directory (ONLY state files)
+if [[ "$REL_PATH" == koan/* ]]; then
+    # Allow .yaml, .db, .md, .log files
+    if [[ "$REL_PATH" != *.yaml && "$REL_PATH" != *.db && "$REL_PATH" != *.md && "$REL_PATH" != *.log ]]; then
+        EXTENSION="${REL_PATH##*.}"
+        warn "Unexpected file detected in koan/ directory.
+
+File: $REL_PATH
+Extension: .$EXTENSION
+
+The koan/ directory should ONLY contain:
+  - .db files (SQLite state)
+  - .yaml files (configuration/anchors)
+  - README.md (documentation)
+
+Source code should be placed in:
+  - src/     (source files)
+  - tests/   (test files)
+  - lib/     (libraries)
+
+Please move this file to the appropriate project directory."
+        exit 0
+    fi
+fi
+
+# Check 3: .claude/ directory (ONLY Zen config)
+if [[ "$REL_PATH" == .claude/* ]]; then
+    # Allow known Zen file types
+    case "$REL_PATH" in
+        *.md|*.yaml|*.json|*.sh)
+            # These are valid Zen config files
+            ;;
+        *)
+            EXTENSION="${REL_PATH##*.}"
+            # Check for source code extensions
+            case "$EXTENSION" in
+                ts|js|tsx|jsx|py|go|rs|java|cpp|c|h|rb|php|swift|kt)
+                    warn "Source code detected in .claude/ directory.
+
+File: $REL_PATH
+Extension: .$EXTENSION
+
+The .claude/ directory should ONLY contain Zen configuration:
+  - concepts/*.md
+  - agents/*.md
+  - skills/*.md
+  - commands/*.md
+  - synchronizations/*.yaml
+  - schemas/*.json
+  - hooks/*.sh
+
+Source code should be placed in:
+  - src/     (source files)
+  - tests/   (test files)
+  - lib/     (libraries)
+
+Please move this file to the appropriate project directory."
+                    ;;
+            esac
+            ;;
+    esac
+fi
+
+# Check 4: Source code extensions in root koan subdirectories
+# This catches things like koan/implementations/auth.ts
+if [[ "$REL_PATH" == koan/*/* ]]; then
+    EXTENSION="${REL_PATH##*.}"
+    case "$EXTENSION" in
+        ts|js|tsx|jsx|py|go|rs|java|cpp|c|h|rb|php|swift|kt|css|scss|html|vue|svelte)
+            warn "Source code detected in koan/ subdirectory.
+
+File: $REL_PATH
+Extension: .$EXTENSION
+
+The koan/ directory and its subdirectories should ONLY contain state files (.db, .yaml).
+
+Example of correct structure:
+  koan/implementations/impl-001.yaml  (metadata about implementation)
+  src/auth.ts                         (actual source code)
+
+Please move the source code to the project's src/ directory."
+            ;;
+    esac
+fi
+
+exit 0

package/templates/hooks/post-tool-use.sh.template

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# Zen PostToolUse Hook
+#
+# This hook runs after tool execution completes.
+# It tracks provenance for concept actions (Task tool) via SQLite events.
+#
+# Environment variables available:
+# - CLAUDE_TOOL_NAME: Name of the tool that was executed
+# - CLAUDE_TOOL_INPUT: JSON input to the tool
+# - CLAUDE_TOOL_OUTPUT: JSON output from the tool (may be truncated)
+
+set -e
+
+# Only track Task tool calls (concept actions)
+if [ "$CLAUDE_TOOL_NAME" != "Task" ]; then
+  exit 0
+fi
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+source "$PROJECT_ROOT/.claude/hooks/lib/common.sh"
+
+# Extract subagent type from input (simplified parsing)
+SUBAGENT_TYPE=""
+if [ -n "$CLAUDE_TOOL_INPUT" ]; then
+  SUBAGENT_TYPE=$(echo "$CLAUDE_TOOL_INPUT" | grep -o '"subagent_type"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*: *"//' | tr -d '"' || echo "")
+fi
+
+# Only track concept actions
+case "$SUBAGENT_TYPE" in
+  story-concept|architecture-concept|implementation-concept|quality-concept|version-concept|context-concept)
+    ;;
+  *)
+    # Not a concept action, skip
+    exit 0
+    ;;
+esac
+
+# Determine concept name from subagent type
+CONCEPT_NAME=$(echo "$SUBAGENT_TYPE" | sed 's/-concept//')
+GIT_BRANCH="$(zen_git_branch)"
+GIT_COMMIT="$(zen_git_short_hash)"
+
+# Log task invocation to SQLite
+if zen_state_available; then
+  zen_event_log "task-$(date +%s%N)" "task_invocation" "{\"concept\":\"$CONCEPT_NAME\",\"subagent_type\":\"$SUBAGENT_TYPE\",\"git_branch\":\"$GIT_BRANCH\",\"git_commit\":\"$GIT_COMMIT\"}" || true
+fi
+
+# Output confirmation (visible in transcript)
+echo "Provenance recorded: $CONCEPT_NAME"
+
+exit 0

package/templates/hooks/pre-compact.sh.template

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# Zen PreCompact Hook
+#
+# This hook runs before Claude Code compresses the conversation history.
+# It saves a checkpoint to preserve critical context.
+#
+# Environment variables available:
+# - CLAUDE_CONTEXT_TOKENS: Current token count before compaction
+
+set -e
+
+PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+source "$PROJECT_ROOT/.claude/hooks/lib/common.sh"
+
+CHECKPOINT_ID="pre-compact-$(date +%s)"
+GIT_BRANCH="$(zen_git_branch)"
+GIT_COMMIT="$(zen_git_short_hash)"
+
+# Build checkpoint data
+JSON_DATA="{\"automatic\":true,\"description\":\"Auto-saved before context compaction\",\"context_tokens\":\"${CLAUDE_CONTEXT_TOKENS:-unknown}\",\"git_state\":{\"branch\":\"${GIT_BRANCH}\",\"commit\":\"${GIT_COMMIT}\"},\"session_start\":\"${ZEN_SESSION_START:-unknown}\"}"
+
+# Write to SQLite
+if zen_state_available; then
+    zen_checkpoint_save "$CHECKPOINT_ID" "$CHECKPOINT_ID" "pre_compact" "$JSON_DATA"
+fi
+
+# Output confirmation
+echo "Pre-compaction checkpoint saved: $CHECKPOINT_ID"
+echo "Context tokens: ${CLAUDE_CONTEXT_TOKENS:-unknown}"
+
+# Inject project rules from anchors so they survive compaction
+RULES_ANCHOR="$PROJECT_ROOT/koan/anchors/rules.anchor.yaml"
+if [ -f "$RULES_ANCHOR" ]; then
+  echo ""
+  echo "=== PROJECT RULES (from koan/anchors/rules.anchor.yaml) ==="
+  grep -A1 'text:' "$RULES_ANCHOR" | grep 'text:' | sed 's/.*text: "/- /' | sed 's/"$//' || true
+  echo "=== Read koan/anchors/rules.anchor.yaml after compaction for full context ==="
+fi
+
+# Output critical reminders for post-compaction
+echo ""
+echo "╔══════════════════════════════════════════════════════════════════╗"
+echo "║  AFTER COMPACTION:                                              ║"
+echo "║  1. Read \$PROJECT_ROOT/CLAUDE.md                                ║"
+echo "║  2. Run /restore to rebuild context from last checkpoint        ║"
+echo "╚══════════════════════════════════════════════════════════════════╝"
+
+exit 0