@qazuor/claude-code-config 0.1.0

package/templates/scripts/health-check.sh

@@ -0,0 +1,343 @@
+#!/bin/bash
+# Health Check System for Project
+# Validates system integrity and configuration
+#
+# Exit codes:
+#   0 - All checks passed
+#   1 - Warnings detected (non-critical issues)
+#   2 - Errors detected (critical issues)
+
+set -e  # Exit on error (except for checks)
+
+# Colors for output
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Counters
+ERRORS=0
+WARNINGS=0
+CHECKS=0
+
+# Helper functions
+error() {
+  echo -e "${RED}❌ ERROR: $1${NC}"
+  ERRORS=$((ERRORS + 1))
+}
+
+warning() {
+  echo -e "${YELLOW}⚠️  WARNING: $1${NC}"
+  WARNINGS=$((WARNINGS + 1))
+}
+
+success() {
+  echo -e "${GREEN}✅ $1${NC}"
+}
+
+info() {
+  echo -e "${BLUE}ℹ️  $1${NC}"
+}
+
+check_start() {
+  CHECKS=$((CHECKS + 1))
+  echo -e "\n${BLUE}━━━ Check $CHECKS: $1 ━━━${NC}"
+}
+
+# Change to project root
+cd "$(dirname "$0")/../.."
+
+echo -e "${BLUE}╔══════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║        Project System Health Check v1.0         ║${NC}"
+echo -e "${BLUE}╚══════════════════════════════════════════════════╝${NC}"
+echo ""
+echo "🔍 Running comprehensive system health checks..."
+echo ""
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Check 1: File Counts
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+check_start "File Counts"
+
+agent_count=$(find .claude/agents -name "*.md" -type f ! -name "README.md" 2>/dev/null | wc -l)
+command_count=$(find .claude/commands -name "*.md" -type f ! -name "README.md" 2>/dev/null | wc -l)
+skill_count=$(find .claude/skills -name "*.md" -type f ! -name "README.md" 2>/dev/null | wc -l)
+learning_count=$(find .claude/docs/learnings -name "*.md" -type f ! -name "README.md" 2>/dev/null | wc -l)
+workflow_count=$(find .claude/docs/workflows -name "*.md" -type f ! -name "README.md" 2>/dev/null | wc -l)
+diagram_count=$(find .claude/docs/diagrams -name "*.mmd" -type f 2>/dev/null | wc -l)
+
+echo "📊 System component counts:"
+echo "   Agents: $agent_count (expected: 15)"
+echo "   Commands: $command_count (expected: 23)"
+echo "   Skills: $skill_count (expected: 19)"
+echo "   Learnings: $learning_count (expected: 8)"
+echo "   Workflows: $workflow_count (expected: 10)"
+echo "   Diagrams: $diagram_count (expected: 4)"
+
+# Validate counts
+ALL_COUNTS_MATCH=true
+
+if [ "$agent_count" -ne 15 ]; then
+  error "Agent count mismatch: found $agent_count, expected 15"
+  ALL_COUNTS_MATCH=false
+fi
+
+if [ "$command_count" -ne 23 ]; then
+  error "Command count mismatch: found $command_count, expected 23"
+  ALL_COUNTS_MATCH=false
+fi
+
+if [ "$skill_count" -ne 19 ]; then
+  error "Skill count mismatch: found $skill_count, expected 19"
+  ALL_COUNTS_MATCH=false
+fi
+
+if [ "$learning_count" -ne 8 ]; then
+  error "Learning count mismatch: found $learning_count, expected 8"
+  ALL_COUNTS_MATCH=false
+fi
+
+if [ "$workflow_count" -ne 10 ]; then
+  warning "Workflow count mismatch: found $workflow_count, expected 10"
+  ALL_COUNTS_MATCH=false
+fi
+
+if [ "$diagram_count" -ne 4 ]; then
+  warning "Diagram count mismatch: found $diagram_count, expected 4"
+  ALL_COUNTS_MATCH=false
+fi
+
+if [ "$ALL_COUNTS_MATCH" = true ]; then
+  success "All file counts match expected values"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Check 2: Code Registry
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+check_start "Code Registry"
+
+REGISTRY_FILE=".claude/sessions/planning/.code-registry.json"
+
+if [ ! -f "$REGISTRY_FILE" ]; then
+  warning "Code registry not found at $REGISTRY_FILE"
+  info "Run 'pnpm planning:sync <session-path>' to generate it"
+else
+  # Validate JSON
+  if ! jq empty "$REGISTRY_FILE" 2>/dev/null; then
+    error "Code registry is not valid JSON"
+  else
+    TOTAL_SESSIONS=$(jq '.plannings | length // 0' "$REGISTRY_FILE" 2>/dev/null || echo "0")
+    TOTAL_TASKS=$(jq '[.plannings[]] | add // 0' "$REGISTRY_FILE" 2>/dev/null || echo "0")
+    GENERATED_AT=$(jq -r '.generatedAt // "unknown"' "$REGISTRY_FILE" 2>/dev/null || echo "unknown")
+
+    echo "   Sessions: $TOTAL_SESSIONS"
+    echo "   Tasks: $TOTAL_TASKS"
+    echo "   Last updated: $GENERATED_AT"
+
+    # Check staleness (7 days)
+    if [ "$GENERATED_AT" != "unknown" ]; then
+      CURRENT_TIME=$(date +%s)
+      REGISTRY_TIME=$(date -d "$GENERATED_AT" +%s 2>/dev/null || echo "0")
+      TIME_DIFF=$((CURRENT_TIME - REGISTRY_TIME))
+      DAYS_OLD=$((TIME_DIFF / 86400))
+
+      if [ $DAYS_OLD -gt 7 ]; then
+        warning "Code registry is $DAYS_OLD days old (consider updating)"
+      else
+        success "Code registry is valid and up-to-date"
+      fi
+    fi
+  fi
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Check 3: Git Hooks Configuration
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+check_start "Git Hooks"
+
+HOOKS_CONFIGURED=0
+
+if [ -d ".husky" ]; then
+  echo "📁 Husky directory found"
+
+  # Check for required hooks
+  if [ -f ".husky/pre-commit" ] && [ -x ".husky/pre-commit" ]; then
+    echo "   ✓ pre-commit hook configured"
+    HOOKS_CONFIGURED=$((HOOKS_CONFIGURED + 1))
+  else
+    warning "pre-commit hook missing or not executable"
+  fi
+
+  if [ -f ".husky/commit-msg" ] && [ -x ".husky/commit-msg" ]; then
+    echo "   ✓ commit-msg hook configured"
+    HOOKS_CONFIGURED=$((HOOKS_CONFIGURED + 1))
+  else
+    warning "commit-msg hook missing or not executable"
+  fi
+
+  if [ -f ".husky/post-checkout" ] && [ -x ".husky/post-checkout" ]; then
+    echo "   ✓ post-checkout hook configured"
+    HOOKS_CONFIGURED=$((HOOKS_CONFIGURED + 1))
+  else
+    warning "post-checkout hook missing or not executable"
+  fi
+
+  if [ -f ".huskyrc" ]; then
+    echo "   ✓ .huskyrc configuration found"
+  else
+    warning ".huskyrc configuration file not found"
+  fi
+
+  if [ $HOOKS_CONFIGURED -eq 3 ]; then
+    success "All Git hooks properly configured"
+  else
+    warning "Only $HOOKS_CONFIGURED/3 hooks configured"
+  fi
+else
+  error "Husky not configured (.husky directory missing)"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Check 4: Core Documentation Files
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+check_start "Core Documentation"
+
+REQUIRED_FILES=(
+  "CLAUDE.md"
+  ".claude/docs/INDEX.md"
+  ".claude/docs/quick-start.md"
+  ".claude/docs/glossary.md"
+  ".claude/docs/RECOMMENDED-HOOKS.md"
+  ".claude/agents/README.md"
+  ".claude/commands/README.md"
+  ".claude/skills/README.md"
+  ".claude/docs/workflows/README.md"
+  ".claude/docs/learnings/README.md"
+  ".claude/docs/diagrams/README.md"
+)
+
+MISSING_FILES=0
+
+for file in "${REQUIRED_FILES[@]}"; do
+  if [ ! -f "$file" ]; then
+    error "Required file missing: $file"
+    MISSING_FILES=$((MISSING_FILES + 1))
+  fi
+done
+
+if [ $MISSING_FILES -eq 0 ]; then
+  success "All ${#REQUIRED_FILES[@]} core documentation files exist"
+else
+  error "$MISSING_FILES/${#REQUIRED_FILES[@]} core files missing"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Check 5: Recent Learnings Count
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+check_start "Recent Learnings"
+
+# Count "Recent Learnings" section in CLAUDE.md
+if [ -f "CLAUDE.md" ]; then
+  # Count items under "Recent Learnings" (lines starting with ### after "Recent Learnings" heading)
+  RECENT_COUNT=$(awk '/^## .*Recent Learnings/,/^## / {if (/^###/) count++} END {print count+0}' CLAUDE.md)
+
+  echo "   Recent learnings in CLAUDE.md: $RECENT_COUNT"
+
+  if [ "$RECENT_COUNT" -gt 10 ]; then
+    warning "Too many recent learnings ($RECENT_COUNT > 10) - archive older ones"
+  else
+    success "Recent learnings count within limit ($RECENT_COUNT ≤ 10)"
+  fi
+else
+  error "CLAUDE.md not found"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Check 6: Validation Scripts
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+check_start "Validation Scripts"
+
+# Check if package.json has validation scripts
+if [ -f "package.json" ]; then
+  if grep -q '"format:md"' package.json; then
+    echo "   ✓ format:md script found"
+  else
+    warning "format:md script not found in package.json"
+  fi
+
+  if grep -q '"format:md:claude"' package.json; then
+    echo "   ✓ format:md:claude script found"
+  else
+    warning "format:md:claude script not found in package.json"
+  fi
+
+  if grep -q '"lint:md"' package.json; then
+    echo "   ✓ lint:md script found"
+  else
+    warning "lint:md script not found in package.json"
+  fi
+
+  success "Validation scripts configured"
+else
+  error "package.json not found"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Check 7: Active Planning Sessions
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+check_start "Active Planning Sessions"
+
+CHECKPOINT_FILES=$(find .claude/sessions/planning -name ".checkpoint.json" 2>/dev/null)
+CHECKPOINT_COUNT=$(echo "$CHECKPOINT_FILES" | grep -c . || echo "0")
+
+if [ "$CHECKPOINT_COUNT" -gt 0 ]; then
+  echo "   Found $CHECKPOINT_COUNT active planning sessions:"
+
+  for checkpoint in $CHECKPOINT_FILES; do
+    SESSION_DIR=$(dirname "$checkpoint")
+    SESSION_NAME=$(basename "$SESSION_DIR")
+    CURRENT_TASK=$(jq -r '.currentTask // "unknown"' "$checkpoint" 2>/dev/null)
+    TASKS_COMPLETED=$(jq -r '.tasksCompleted // 0' "$checkpoint" 2>/dev/null)
+    TOTAL_STEPS=$(jq -r '.totalSteps // 0' "$checkpoint" 2>/dev/null)
+
+    if [ "$TOTAL_STEPS" -gt 0 ]; then
+      PROGRESS=$(( (TASKS_COMPLETED * 100) / TOTAL_STEPS ))
+      echo "   📋 $SESSION_NAME: $CURRENT_TASK ($TASKS_COMPLETED/$TOTAL_STEPS - ${PROGRESS}%)"
+    else
+      echo "   📋 $SESSION_NAME: $CURRENT_TASK"
+    fi
+  done
+
+  success "Planning session tracking active"
+else
+  info "No active planning sessions found"
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Summary Report
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+echo ""
+echo -e "${BLUE}╔══════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║              Health Check Summary                ║${NC}"
+echo -e "${BLUE}╚══════════════════════════════════════════════════╝${NC}"
+echo ""
+echo "   Total checks: $CHECKS"
+echo -e "   ${RED}Errors: $ERRORS${NC}"
+echo -e "   ${YELLOW}Warnings: $WARNINGS${NC}"
+echo ""
+
+# Exit with appropriate code
+if [ $ERRORS -gt 0 ]; then
+  echo -e "${RED}❌ Health check FAILED - $ERRORS critical issue(s) detected${NC}"
+  echo ""
+  exit 2
+elif [ $WARNINGS -gt 0 ]; then
+  echo -e "${YELLOW}⚠️  Health check PASSED with warnings - $WARNINGS non-critical issue(s)${NC}"
+  echo ""
+  exit 1
+else
+  echo -e "${GREEN}✅ Health check PASSED - System is healthy!${NC}"
+  echo ""
+  exit 0
+fi

package/templates/scripts/sync-registry.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+#
+# Code Registry Sync Script
+#
+# Regenerates .code-registry.json from all TODOs.md files in planning sessions.
+# This ensures the registry stays in sync with the source of truth (TODOs.md).
+#
+# Exit codes:
+#   0 - Registry synced successfully
+#   1 - Sync failed
+#
+
+set -euo pipefail
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}🔄 Syncing code registry from TODOs.md files...${NC}"
+echo ""
+
+# Check if generate-code-registry script exists
+if [ ! -f ".claude/scripts/generate-code-registry.ts" ]; then
+  echo "❌ Error: .claude/scripts/generate-code-registry.ts not found"
+  exit 1
+fi
+
+# Run the registry generator
+if tsx .claude/scripts/generate-code-registry.ts; then
+  echo ""
+  echo -e "${GREEN}✅ Code registry synced successfully!${NC}"
+  echo -e "${YELLOW}💡 Registry file: .claude/sessions/planning/.code-registry.json${NC}"
+  exit 0
+else
+  echo ""
+  echo "❌ Failed to sync code registry"
+  exit 1
+fi

package/templates/scripts/telemetry-report.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env tsx
+/**
+ * Telemetry Report Generator (Simplified)
+ */
+
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const TELEMETRY_PATH = resolve(process.cwd(), '.claude/.telemetry.json');
+
+process.stdout.write('\n📈 Telemetry Report\n');
+process.stdout.write('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n');
+
+if (!existsSync(TELEMETRY_PATH)) {
+  console.log('❌ No telemetry data found.');
+  console.log('\n💡 Telemetry file: .claude/.telemetry.json');
+  console.log('   This file is created automatically as you use the system.\n');
+  process.exit(0);
+}
+
+try {
+  const content = readFileSync(TELEMETRY_PATH, 'utf-8');
+  const data = JSON.parse(content);
+
+  console.log(`Version: ${data.version || 'unknown'}`);
+  console.log(`Tracking since: ${data.createdAt || 'unknown'}`);
+  console.log(`Last updated: ${data.lastUpdated || 'unknown'}\n`);
+
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+  console.log('🔒 Privacy Note: All telemetry data is stored locally');
+  console.log('   and never transmitted. The .telemetry.json file is');
+  console.log('   gitignored and remains on your machine.\n');
+} catch (error) {
+  console.error('Error loading telemetry:', error);
+  process.exit(1);
+}

package/templates/scripts/validate-docs.sh

@@ -0,0 +1,224 @@
+#!/usr/bin/env bash
+#
+# Documentation Validation Script
+#
+# Validates:
+# - Agent/command/skill counts match documentation
+# - No broken internal links
+# - File structure consistency
+#
+# Exit codes:
+#   0 - All validations passed
+#   1 - Validation failed
+#
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Counters
+ERRORS=0
+WARNINGS=0
+
+# Base directories
+CLAUDE_DIR=".claude"
+AGENTS_DIR="${CLAUDE_DIR}/agents"
+COMMANDS_DIR="${CLAUDE_DIR}/commands"
+SKILLS_DIR="${CLAUDE_DIR}/skills"
+DOCS_DIR="${CLAUDE_DIR}/docs"
+
+echo "🔍 Validating documentation structure..."
+echo ""
+
+# ============================================================================
+# 1. Count agents, commands, and skills
+# ============================================================================
+
+echo "📊 Counting components..."
+
+# Count agents (excluding README.md and index files)
+AGENT_COUNT=$(find "${AGENTS_DIR}" -type f -name "*.md" ! -name "README.md" ! -name "index.md" | wc -l)
+echo "  Agents: ${AGENT_COUNT}"
+
+# Count commands (excluding README.md and index files)
+COMMAND_COUNT=$(find "${COMMANDS_DIR}" -type f -name "*.md" ! -name "README.md" ! -name "index.md" | wc -l)
+echo "  Commands: ${COMMAND_COUNT}"
+
+# Count skills (excluding README.md and index files)
+SKILL_COUNT=$(find "${SKILLS_DIR}" -type f -name "*.md" ! -name "README.md" ! -name "index.md" | wc -l)
+echo "  Skills: ${SKILL_COUNT}"
+
+echo ""
+
+# ============================================================================
+# 2. Validate agent README matches actual count
+# ============================================================================
+
+echo "🤖 Validating agents..."
+
+if [ -f "${AGENTS_DIR}/README.md" ]; then
+  # Extract count from README Statistics section (looking for "**Total Agents**: 13")
+  README_AGENT_COUNT=$(grep -oP '\*\*Total Agents\*\*: \K\d+' "${AGENTS_DIR}/README.md" || echo "0")
+
+  if [ "${AGENT_COUNT}" -ne "${README_AGENT_COUNT}" ]; then
+    echo -e "  ${RED}✗${NC} Agent count mismatch!"
+    echo "    README says: ${README_AGENT_COUNT}"
+    echo "    Actual count: ${AGENT_COUNT}"
+    ((ERRORS++))
+  else
+    echo -e "  ${GREEN}✓${NC} Agent count matches (${AGENT_COUNT})"
+  fi
+else
+  echo -e "  ${YELLOW}⚠${NC} agents/README.md not found"
+  ((WARNINGS++))
+fi
+
+# ============================================================================
+# 3. Validate command README matches actual count
+# ============================================================================
+
+echo "⚙️  Validating commands..."
+
+if [ -f "${COMMANDS_DIR}/README.md" ]; then
+  # Extract count from README (looking for "## Total: 18 Commands")
+  README_COMMAND_COUNT=$(grep -oP '## Total: \K\d+(?= Commands)' "${COMMANDS_DIR}/README.md" || echo "0")
+
+  if [ "${COMMAND_COUNT}" -ne "${README_COMMAND_COUNT}" ]; then
+    echo -e "  ${RED}✗${NC} Command count mismatch!"
+    echo "    README says: ${README_COMMAND_COUNT}"
+    echo "    Actual count: ${COMMAND_COUNT}"
+    ((ERRORS++))
+  else
+    echo -e "  ${GREEN}✓${NC} Command count matches (${COMMAND_COUNT})"
+  fi
+else
+  echo -e "  ${YELLOW}⚠${NC} commands/README.md not found"
+  ((WARNINGS++))
+fi
+
+# ============================================================================
+# 4. Validate skill README matches actual count
+# ============================================================================
+
+echo "🎯 Validating skills..."
+
+if [ -f "${SKILLS_DIR}/README.md" ]; then
+  # Extract count from README (looking for "## Total: 16 Skills")
+  README_SKILL_COUNT=$(grep -oP '## Total: \K\d+(?= Skills)' "${SKILLS_DIR}/README.md" || echo "0")
+
+  if [ "${SKILL_COUNT}" -ne "${README_SKILL_COUNT}" ]; then
+    echo -e "  ${RED}✗${NC} Skill count mismatch!"
+    echo "    README says: ${README_SKILL_COUNT}"
+    echo "    Actual count: ${SKILL_COUNT}"
+    ((ERRORS++))
+  else
+    echo -e "  ${GREEN}✓${NC} Skill count matches (${SKILL_COUNT})"
+  fi
+else
+  echo -e "  ${YELLOW}⚠${NC} skills/README.md not found"
+  ((WARNINGS++))
+fi
+
+# ============================================================================
+# 5. Check for broken internal links
+# ============================================================================
+
+echo ""
+echo "🔗 Checking for broken internal links..."
+
+# Find all markdown files in .claude
+BROKEN_LINKS=0
+
+while IFS= read -r file; do
+  # Extract markdown links: [text](path)
+  while IFS= read -r link; do
+    # Skip external links (http://, https://, mailto:)
+    if [[ "$link" =~ ^(http://|https://|mailto:) ]]; then
+      continue
+    fi
+
+    # Skip anchors within same file
+    if [[ "$link" =~ ^# ]]; then
+      continue
+    fi
+
+    # Get directory of current file
+    file_dir=$(dirname "$file")
+
+    # Resolve relative path
+    if [[ "$link" =~ ^/ ]]; then
+      # Absolute path from repo root
+      target_file="${link#/}"
+    else
+      # Relative path
+      target_file="${file_dir}/${link}"
+    fi
+
+    # Remove anchor if present
+    target_file="${target_file%%#*}"
+
+    # Check if file exists
+    if [ ! -f "$target_file" ] && [ ! -d "$target_file" ]; then
+      echo -e "  ${RED}✗${NC} Broken link in ${file}"
+      echo "    → ${link}"
+      ((BROKEN_LINKS++))
+      ((ERRORS++))
+    fi
+  done < <(grep -oP '\]\(\K[^)]+' "$file" 2>/dev/null || true)
+done < <(find "${CLAUDE_DIR}" -type f -name "*.md")
+
+if [ "${BROKEN_LINKS}" -eq 0 ]; then
+  echo -e "  ${GREEN}✓${NC} No broken links found"
+fi
+
+# ============================================================================
+# 6. Validate directory structure
+# ============================================================================
+
+echo ""
+echo "📁 Validating directory structure..."
+
+REQUIRED_DIRS=(
+  "${AGENTS_DIR}"
+  "${COMMANDS_DIR}"
+  "${SKILLS_DIR}"
+  "${DOCS_DIR}"
+  "${CLAUDE_DIR}/schemas"
+  "${CLAUDE_DIR}/scripts"
+  "${CLAUDE_DIR}/sessions/planning"
+)
+
+for dir in "${REQUIRED_DIRS[@]}"; do
+  if [ ! -d "$dir" ]; then
+    echo -e "  ${RED}✗${NC} Missing directory: ${dir}"
+    ((ERRORS++))
+  fi
+done
+
+echo -e "  ${GREEN}✓${NC} All required directories exist"
+
+# ============================================================================
+# Summary
+# ============================================================================
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+if [ "${ERRORS}" -eq 0 ]; then
+  echo -e "${GREEN}✅ All validations passed!${NC}"
+  if [ "${WARNINGS}" -gt 0 ]; then
+    echo -e "${YELLOW}⚠️  ${WARNINGS} warning(s)${NC}"
+  fi
+  exit 0
+else
+  echo -e "${RED}❌ Validation failed with ${ERRORS} error(s)${NC}"
+  if [ "${WARNINGS}" -gt 0 ]; then
+    echo -e "${YELLOW}⚠️  ${WARNINGS} warning(s)${NC}"
+  fi
+  exit 1
+fi