@agentic15.com/agentic15-claude-zen 4.0.3 → 4.0.4

package/src/cli/UpgradeCommand.js

@@ -1,192 +1,191 @@
-/**
- * Copyright 2024-2025 agentic15.com
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { existsSync, mkdirSync, copyFileSync, readdirSync, statSync, readFileSync, writeFileSync, unlinkSync, rmdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-/**
- * UpgradeCommand - Updates framework files in existing projects
- *
- * Upgrades .claude/ framework files while preserving:
- * - User code (Agent/src, Agent/tests)
- * - Active plans (.claude/plans, .claude/ACTIVE-PLAN)
- * - Local settings (.claude/settings.local.json)
- */
-export class UpgradeCommand {
-  static execute() {
-    console.log('\n' + '═'.repeat(70));
-    console.log('🔄 Agentic15 Claude Zen - Framework Upgrade');
-    console.log('═'.repeat(70) + '\n');
-
-    // Verify we're in a project directory
-    if (!existsSync('.claude')) {
-      console.log('❌ Not in an Agentic15 project directory');
-      console.log('   Run this command from your project root (where .claude/ exists)\n');
-      process.exit(1);
-    }
-
-    // Get current and package versions
-    const currentVersion = this.getCurrentVersion();
-    const packageVersion = this.getPackageVersion();
-
-    console.log(`📦 Current framework version: ${currentVersion || 'unknown'}`);
-    console.log(`📦 Package version: ${packageVersion}\n`);
-
-    // Backup current .claude directory
-    console.log('📂 Creating backup...');
-    this.createBackup();
-
-    try {
-      // Update framework files
-      console.log('🔄 Updating framework files...\n');
-      this.updateFrameworkFiles();
-
-      // Update version file
-      this.updateVersionFile(packageVersion);
-
-      console.log('\n✅ Upgrade completed successfully!\n');
-      console.log('📋 What was updated:');
-      console.log('   - .claude/hooks/ (git hooks)');
-      console.log('   - .claude/settings.json (framework settings)');
-      console.log('   - .claude/PLAN-SCHEMA.json (plan structure)');
-      console.log('   - .claude/PROJECT-PLAN-TEMPLATE.json (plan template)');
-      console.log('   - .claude/POST-INSTALL.md (documentation)\n');
-      console.log('📋 What was preserved:');
-      console.log('   - .claude/plans/ (your project plans)');
-      console.log('   - .claude/ACTIVE-PLAN (current plan)');
-      console.log('   - .claude/settings.local.json (local settings)');
-      console.log('   - Agent/ (your source code)');
-      console.log('   - scripts/ (your scripts)');
-      console.log('   - test-site/ (your test site)');
-      console.log('   - package.json (your project config)');
-      console.log('   - README.md (your documentation)\n');
-      console.log('💾 Backup location: .claude.backup/\n');
-      console.log('═'.repeat(70) + '\n');
-    } catch (error) {
-      console.log('\n❌ Upgrade failed:', error.message);
-      console.log('   Your original files are backed up in .claude.backup/');
-      console.log('   To restore: rm -rf .claude && mv .claude.backup .claude\n');
-      process.exit(1);
-    }
-  }
-
-  static getCurrentVersion() {
-    const versionFile = join('.claude', '.framework-version');
-    if (existsSync(versionFile)) {
-      return readFileSync(versionFile, 'utf-8').trim();
-    }
-    return null;
-  }
-
-  static getPackageVersion() {
-    const packageJsonPath = join(__dirname, '..', '..', 'package.json');
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    return packageJson.version;
-  }
-
-  static createBackup() {
-    const backupDir = '.claude.backup';
-
-    // Remove old backup if exists
-    if (existsSync(backupDir)) {
-      this.removeDirectory(backupDir);
-    }
-
-    // Copy entire .claude directory
-    this.copyDirectory('.claude', backupDir);
-    console.log('   ✓ Backup created at .claude.backup/\n');
-  }
-
-  static updateFrameworkFiles() {
-    const templatesDir = join(__dirname, '..', '..', 'templates', '.claude');
-
-    // Files to update (framework files only)
-    const filesToUpdate = [
-      'hooks/complete-task.js',
-      'hooks/enforce-plan-template.js',
-      'hooks/post-merge.js',
-      'hooks/session-start-context.js',
-      'hooks/start-task.js',
-      'hooks/validate-git-workflow.js',
-      'PLAN-SCHEMA.json',
-      'PROJECT-PLAN-TEMPLATE.json',
-      'POST-INSTALL.md',
-      'settings.json'
-    ];
-
-    // Ensure hooks directory exists
-    const hooksDir = join('.claude', 'hooks');
-    if (!existsSync(hooksDir)) {
-      mkdirSync(hooksDir, { recursive: true });
-    }
-
-    // Copy framework files
-    filesToUpdate.forEach(file => {
-      const sourcePath = join(templatesDir, file);
-      const destPath = join('.claude', file);
-
-      if (existsSync(sourcePath)) {
-        copyFileSync(sourcePath, destPath);
-        console.log(`   ✓ Updated ${file}`);
-      }
-    });
-  }
-
-  static updateVersionFile(version) {
-    const versionFile = join('.claude', '.framework-version');
-    writeFileSync(versionFile, version);
-  }
-
-  static copyDirectory(src, dest) {
-    if (!existsSync(dest)) {
-      mkdirSync(dest, { recursive: true });
-    }
-
-    const entries = readdirSync(src, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const srcPath = join(src, entry.name);
-      const destPath = join(dest, entry.name);
-
-      if (entry.isDirectory()) {
-        this.copyDirectory(srcPath, destPath);
-      } else {
-        copyFileSync(srcPath, destPath);
-      }
-    }
-  }
-
-  static removeDirectory(dir) {
-    if (existsSync(dir)) {
-      const entries = readdirSync(dir, { withFileTypes: true });
-
-      for (const entry of entries) {
-        const fullPath = join(dir, entry.name);
-        if (entry.isDirectory()) {
-          this.removeDirectory(fullPath);
-        } else {
-          unlinkSync(fullPath);
-        }
-      }
-
-      rmdirSync(dir);
-    }
-  }
-}
+/**
+ * Copyright 2024-2025 agentic15.com
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { existsSync, mkdirSync, copyFileSync, readdirSync, statSync, readFileSync, writeFileSync, unlinkSync, rmdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * UpgradeCommand - Updates framework files in existing projects
+ *
+ * Upgrades .claude/ framework files while preserving:
+ * - User code (Agent/src, Agent/tests)
+ * - Active plans (.claude/plans, .claude/ACTIVE-PLAN)
+ * - Local settings (.claude/settings.local.json)
+ */
+export class UpgradeCommand {
+  static execute() {
+    console.log('\n' + '═'.repeat(70));
+    console.log('🔄 Agentic15 Claude Zen - Framework Upgrade');
+    console.log('═'.repeat(70) + '\n');
+
+    // Verify we're in a project directory
+    if (!existsSync('.claude')) {
+      console.log('❌ Not in an Agentic15 project directory');
+      console.log('   Run this command from your project root (where .claude/ exists)\n');
+      process.exit(1);
+    }
+
+    // Get current and package versions
+    const currentVersion = this.getCurrentVersion();
+    const packageVersion = this.getPackageVersion();
+
+    console.log(`📦 Current framework version: ${currentVersion || 'unknown'}`);
+    console.log(`📦 Package version: ${packageVersion}\n`);
+
+    // Backup current .claude directory
+    console.log('📂 Creating backup...');
+    this.createBackup();
+
+    try {
+      // Update framework files
+      console.log('🔄 Updating framework files...\n');
+      this.updateFrameworkFiles();
+
+      // Update version file
+      this.updateVersionFile(packageVersion);
+
+      console.log('\n✅ Upgrade completed successfully!\n');
+      console.log('📋 What was updated:');
+      console.log('   - .claude/hooks/ (git hooks)');
+      console.log('   - .claude/settings.json (framework settings)');
+      console.log('   - .claude/PLAN-SCHEMA.json (plan structure)');
+      console.log('   - .claude/PROJECT-PLAN-TEMPLATE.json (plan template)');
+      console.log('   - .claude/POST-INSTALL.md (documentation)\n');
+      console.log('📋 What was preserved:');
+      console.log('   - .claude/plans/ (your project plans)');
+      console.log('   - .claude/ACTIVE-PLAN (current plan)');
+      console.log('   - .claude/settings.local.json (local settings)');
+      console.log('   - Agent/ (your source code)');
+      console.log('   - scripts/ (your scripts)');
+      console.log('   - test-site/ (your test site)');
+      console.log('   - package.json (your project config)');
+      console.log('   - README.md (your documentation)\n');
+      console.log('💾 Backup location: .claude.backup/\n');
+      console.log('═'.repeat(70) + '\n');
+    } catch (error) {
+      console.log('\n❌ Upgrade failed:', error.message);
+      console.log('   Your original files are backed up in .claude.backup/');
+      console.log('   To restore: rm -rf .claude && mv .claude.backup .claude\n');
+      process.exit(1);
+    }
+  }
+
+  static getCurrentVersion() {
+    const versionFile = join('.claude', '.framework-version');
+    if (existsSync(versionFile)) {
+      return readFileSync(versionFile, 'utf-8').trim();
+    }
+    return null;
+  }
+
+  static getPackageVersion() {
+    const packageJsonPath = join(__dirname, '..', '..', 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version;
+  }
+
+  static createBackup() {
+    const backupDir = '.claude.backup';
+
+    // Remove old backup if exists
+    if (existsSync(backupDir)) {
+      this.removeDirectory(backupDir);
+    }
+
+    // Copy entire .claude directory
+    this.copyDirectory('.claude', backupDir);
+    console.log('   ✓ Backup created at .claude.backup/\n');
+  }
+
+  static updateFrameworkFiles() {
+    const templatesDir = join(__dirname, '..', '..', 'templates', '.claude');
+
+    // Files to update (framework files only)
+    const filesToUpdate = [
+      'hooks/complete-task.js',
+      'hooks/enforce-plan-template.js',
+      'hooks/require-active-task.js',
+      'hooks/session-start-context.js',
+      'hooks/start-task.js',
+      'PLAN-SCHEMA.json',
+      'PROJECT-PLAN-TEMPLATE.json',
+      'POST-INSTALL.md',
+      'settings.json'
+    ];
+
+    // Ensure hooks directory exists
+    const hooksDir = join('.claude', 'hooks');
+    if (!existsSync(hooksDir)) {
+      mkdirSync(hooksDir, { recursive: true });
+    }
+
+    // Copy framework files
+    filesToUpdate.forEach(file => {
+      const sourcePath = join(templatesDir, file);
+      const destPath = join('.claude', file);
+
+      if (existsSync(sourcePath)) {
+        copyFileSync(sourcePath, destPath);
+        console.log(`   ✓ Updated ${file}`);
+      }
+    });
+  }
+
+  static updateVersionFile(version) {
+    const versionFile = join('.claude', '.framework-version');
+    writeFileSync(versionFile, version);
+  }
+
+  static copyDirectory(src, dest) {
+    if (!existsSync(dest)) {
+      mkdirSync(dest, { recursive: true });
+    }
+
+    const entries = readdirSync(src, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const srcPath = join(src, entry.name);
+      const destPath = join(dest, entry.name);
+
+      if (entry.isDirectory()) {
+        this.copyDirectory(srcPath, destPath);
+      } else {
+        copyFileSync(srcPath, destPath);
+      }
+    }
+  }
+
+  static removeDirectory(dir) {
+    if (existsSync(dir)) {
+      const entries = readdirSync(dir, { withFileTypes: true });
+
+      for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+          this.removeDirectory(fullPath);
+        } else {
+          unlinkSync(fullPath);
+        }
+      }
+
+      rmdirSync(dir);
+    }
+  }
+}

package/templates/.claude/hooks/session-start-context.js

@@ -1,128 +1,131 @@
-#!/usr/bin/env node
-
-/**
- * Session Start Context Display Hook
- *
- * CRITICAL: Shows Claude the current context at session start
- * - Active plan name and location
- * - Active task ID and description
- * - Project structure
- * - Workflow reminder
- *
- * This hook FORCES Claude to acknowledge the agentic15-claude-zen workflow
- */
-
-const fs = require('fs');
-const path = require('path');
-
-function log(message, color = 'reset') {
-  const colors = {
-    reset: '\x1b[0m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    blue: '\x1b[34m',
-    cyan: '\x1b[36m',
-    red: '\x1b[31m',
-    bold: '\x1b[1m'
-  };
-  console.log(`${colors[color]}${message}${colors.reset}`);
-}
-
-// Check if active plan exists
-const activePlanFile = '.claude/ACTIVE-PLAN';
-let activePlan = null;
-let planDir = null;
-let tracker = null;
-let activeTask = null;
-
-if (fs.existsSync(activePlanFile)) {
-  activePlan = fs.readFileSync(activePlanFile, 'utf8').trim();
-  planDir = path.join('.claude/plans', activePlan);
-
-  const trackerPath = path.join(planDir, 'TASK-TRACKER.json');
-  if (fs.existsSync(trackerPath)) {
-    tracker = JSON.parse(fs.readFileSync(trackerPath, 'utf8'));
-  }
-}
-
-console.log('\n' + '═'.repeat(70));
-log('🎯 GL-LIFE-CLAUDE-ZEN WORKFLOW - SESSION START', 'bold');
-console.log('═'.repeat(70) + '\n');
-
-// Display active context
-if (activePlan && tracker) {
-  log('✅ ACTIVE PROJECT CONTEXT:', 'green');
-  log(`   Project: ${tracker.projectName}`, 'cyan');
-  log(`   Plan: ${activePlan}`, 'cyan');
-  log(`   Location: .claude/plans/${activePlan}/`, 'cyan');
-
-  if (tracker.activeTask) {
-    const taskFile = path.join(planDir, 'tasks', `${tracker.activeTask}.json`);
-    if (fs.existsSync(taskFile)) {
-      const task = JSON.parse(fs.readFileSync(taskFile, 'utf8'));
-      log(`\n   Active Task: ${tracker.activeTask}`, 'yellow');
-      log(`   Title: ${task.title}`, 'yellow');
-      log(`   Status: ${task.status}`, 'yellow');
-      log(`   Description: ${task.description}`, 'yellow');
-    }
-  } else {
-    log('\n   ⚠️  No active task - start one:', 'yellow');
-    log('   npx agentic15 task next', 'yellow');
-  }
-
-  // Show progress
-  const stats = tracker.statistics;
-  log(`\n   Progress: ${stats.completed}/${stats.totalTasks} tasks complete`, 'cyan');
-  log(`   In Progress: ${stats.inProgress}`, 'cyan');
-  log(`   Pending: ${stats.pending}`, 'cyan');
-
-} else {
-  log('❌ NO ACTIVE PROJECT PLAN', 'red');
-  log('\n   You MUST work within the agentic15-claude-zen framework.', 'yellow');
-  log('   Initialize the plan and start execution:', 'yellow');
-  log('   npx agentic15 plan', 'yellow');
-  log('   npx agentic15 task next\n', 'yellow');
-}
-
-console.log('─'.repeat(70));
-log('📖 MANDATORY WORKFLOW RULES:', 'bold');
-console.log('─'.repeat(70));
-log('   1. NO work without active plan + task', 'cyan');
-log('   2. Work ONLY on main branch (no feature branches)', 'cyan');
-log('   3. Edit ONLY ./Agent/** and ./scripts/** directories', 'cyan');
-log('   4. Follow 9-step task completion checklist', 'cyan');
-log('   5. Follow TDD: write tests first, then code', 'cyan');
-log('   6. Commit with task ID: [TASK-XXX] Description', 'cyan');
-log('   7. Push regularly: git push origin main', 'cyan');
-
-console.log('\n' + '─'.repeat(70));
-log('📂 DIRECTORY STRUCTURE:', 'bold');
-console.log('─'.repeat(70));
-log('   ./Agent/                    # Your workspace (EDIT HERE)', 'green');
-log('   ./scripts/                  # Your scripts (EDIT HERE)', 'green');
-log('   ./.claude/                  # Framework files (READ ONLY)', 'yellow');
-log('   ./node_modules/.agentic15-claude-zen/  # Bundled scripts & hooks', 'yellow');
-
-console.log('\n' + '─'.repeat(70));
-log('📋 AVAILABLE COMMANDS:', 'bold');
-console.log('─'.repeat(70));
-log('   npx agentic15 plan              # Generate and lock plan', 'cyan');
-log('   npx agentic15 task next         # Start next task', 'cyan');
-log('   npx agentic15 status            # View progress', 'cyan');
-log('   npx agentic15 commit            # Test, commit, push, PR', 'cyan');
-log('   npx agentic15 visual-test <url> # Capture UI screenshots', 'cyan');
-
-console.log('\n' + '─'.repeat(70));
-log('⚠️  ENFORCEMENT ACTIVE:', 'bold');
-console.log('─'.repeat(70));
-log('   • Hooks BLOCK operations that violate rules', 'red');
-log('   • Permission system DENIES dangerous commands', 'red');
-log('   • All work requires active task (enforced)', 'red');
-log('   • Tests must pass before commit (enforced)', 'red');
-log('   • Direct main branch workflow (enforced)', 'red');
-
-console.log('\n' + '═'.repeat(70));
-log('📖 Read .claude/ONBOARDING.md for complete workflow details', 'bold');
-console.log('═'.repeat(70) + '\n');
-
-process.exit(0);
+#!/usr/bin/env node
+
+/**
+ * Session Start Context Display Hook
+ *
+ * CRITICAL: Shows Claude the current context at session start
+ * - Active plan name and location
+ * - Active task ID and description
+ * - Project structure
+ * - Workflow reminder
+ *
+ * This hook FORCES Claude to acknowledge the agentic15-claude-zen workflow
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function log(message, color = 'reset') {
+  const colors = {
+    reset: '\x1b[0m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    red: '\x1b[31m',
+    bold: '\x1b[1m'
+  };
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+// Check if active plan exists
+const activePlanFile = '.claude/ACTIVE-PLAN';
+let activePlan = null;
+let planDir = null;
+let tracker = null;
+let activeTask = null;
+
+if (fs.existsSync(activePlanFile)) {
+  activePlan = fs.readFileSync(activePlanFile, 'utf8').trim();
+  planDir = path.join('.claude/plans', activePlan);
+
+  const trackerPath = path.join(planDir, 'TASK-TRACKER.json');
+  if (fs.existsSync(trackerPath)) {
+    tracker = JSON.parse(fs.readFileSync(trackerPath, 'utf8'));
+  }
+}
+
+console.log('\n' + '═'.repeat(70));
+log('🎯 AGENTIC15-CLAUDE-ZEN WORKFLOW - SESSION START', 'bold');
+console.log('═'.repeat(70) + '\n');
+
+// Display active context
+if (activePlan && tracker) {
+  log('✅ ACTIVE PROJECT CONTEXT:', 'green');
+  log(`   Project: ${tracker.projectName}`, 'cyan');
+  log(`   Plan: ${activePlan}`, 'cyan');
+  log(`   Location: .claude/plans/${activePlan}/`, 'cyan');
+
+  // Find task with in_progress status
+  const inProgressTask = tracker.taskFiles.find(t => t.status === 'in_progress');
+
+  if (inProgressTask) {
+    const taskFile = path.join(planDir, 'tasks', `${inProgressTask.id}.json`);
+    if (fs.existsSync(taskFile)) {
+      const task = JSON.parse(fs.readFileSync(taskFile, 'utf8'));
+      log(`\n   🔄 TASK IN PROGRESS: ${inProgressTask.id}`, 'yellow');
+      log(`   Title: ${task.title}`, 'yellow');
+      log(`   Description: ${task.description}`, 'yellow');
+      log(`\n   ⚠️  COMPLETE THIS TASK FIRST: npx agentic15 commit`, 'red');
+    }
+  } else {
+    log('\n   ✓ No task in progress - start next:', 'yellow');
+    log('   npx agentic15 task next', 'yellow');
+  }
+
+  // Show progress
+  const stats = tracker.statistics;
+  log(`\n   Progress: ${stats.completed}/${stats.totalTasks} tasks complete`, 'cyan');
+  log(`   In Progress: ${stats.inProgress}`, 'cyan');
+  log(`   Pending: ${stats.pending}`, 'cyan');
+
+} else {
+  log('❌ NO ACTIVE PROJECT PLAN', 'red');
+  log('\n   You MUST work within the agentic15-claude-zen framework.', 'yellow');
+  log('   Initialize the plan and start execution:', 'yellow');
+  log('   npx agentic15 plan', 'yellow');
+  log('   npx agentic15 task next\n', 'yellow');
+}
+
+console.log('─'.repeat(70));
+log('📖 MANDATORY WORKFLOW RULES - NO EXCEPTIONS:', 'bold');
+console.log('─'.repeat(70));
+log('   1. NO work without active plan + task', 'cyan');
+log('   2. ONE task at a time - complete before starting next', 'cyan');
+log('   3. Edit ONLY ./Agent/** and ./scripts/** directories', 'cyan');
+log('   4. Commit workflow: stage → commit → push → PR', 'cyan');
+log('   5. Use feature branches (feature/task-xxx)', 'cyan');
+log('   6. Testing is optional - structure, not enforcement', 'cyan');
+
+console.log('\n' + '─'.repeat(70));
+log('📂 DIRECTORY STRUCTURE:', 'bold');
+console.log('─'.repeat(70));
+log('   ./Agent/                    # Your workspace (EDIT HERE)', 'green');
+log('   ./scripts/                  # Your scripts (EDIT HERE)', 'green');
+log('   ./.claude/                  # Framework files (READ ONLY)', 'yellow');
+
+console.log('\n' + '─'.repeat(70));
+log('📋 AVAILABLE COMMANDS:', 'bold');
+console.log('─'.repeat(70));
+log('   npx agentic15 plan              # Generate and lock plan', 'cyan');
+log('   npx agentic15 task start TASK-XXX  # Start specific task', 'cyan');
+log('   npx agentic15 task next         # Start next pending task', 'cyan');
+log('   npx agentic15 task status       # View progress', 'cyan');
+log('   npx agentic15 commit            # Commit, push, create PR', 'cyan');
+log('   npx agentic15 visual-test <url> # Capture UI screenshots', 'cyan');
+log('   npx agentic15 upgrade           # Update framework files', 'cyan');
+
+console.log('\n' + '─'.repeat(70));
+log('⚠️  CRITICAL: NEVER OFFER TO SKIP WORKFLOW STEPS', 'bold');
+console.log('─'.repeat(70));
+log('   • If task is in_progress, complete it first (agentic15 commit)', 'red');
+log('   • NEVER ask "continue with next task or commit first?"', 'red');
+log('   • NEVER offer options that violate one-task-at-a-time rule', 'red');
+log('   • Framework enforces workflow - follow it, do not bypass it', 'red');
+log('   • Settings should lead to ONE conclusion, not options', 'red');
+
+console.log('\n' + '═'.repeat(70));
+log('📖 Read .claude/POST-INSTALL.md for complete workflow details', 'bold');
+console.log('═'.repeat(70) + '\n');
+
+process.exit(0);