clavix 4.10.0 → 4.11.2

package/dist/cli/commands/prompts/clear.js

@@ -6,19 +6,21 @@ export default class PromptsClear extends Command {
     static description = 'Clear saved prompts with safety checks';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> --fast',
-        '<%= config.bin %> <%= command.id %> --deep',
+        '<%= config.bin %> <%= command.id %> --standard',
+        '<%= config.bin %> <%= command.id %> --comprehensive',
         '<%= config.bin %> <%= command.id %> --executed',
         '<%= config.bin %> <%= command.id %> --stale',
         '<%= config.bin %> <%= command.id %> --all',
     ];
     static flags = {
-        fast: Flags.boolean({
-            description: 'Clear all fast prompts',
+        standard: Flags.boolean({
+            char: 's',
+            description: 'Clear all standard depth prompts',
             default: false,
         }),
-        deep: Flags.boolean({
-            description: 'Clear all deep prompts',
+        comprehensive: Flags.boolean({
+            char: 'c',
+            description: 'Clear all comprehensive depth prompts',
             default: false,
         }),
         executed: Flags.boolean({
@@ -44,11 +46,11 @@ export default class PromptsClear extends Command {
         try {
             // Build filters
             const filters = {};
-            if (flags.fast && !flags.deep) {
-                filters.source = 'fast';
+            if (flags.standard && !flags.comprehensive) {
+                filters.depthUsed = 'standard';
             }
-            else if (flags.deep && !flags.fast) {
-                filters.source = 'deep';
+            else if (flags.comprehensive && !flags.standard) {
+                filters.depthUsed = 'comprehensive';
             }
             if (flags.executed) {
                 filters.executed = true;
@@ -57,7 +59,11 @@ export default class PromptsClear extends Command {
                 filters.stale = true;
             }
             // Interactive mode
-            if (!flags.fast && !flags.deep && !flags.executed && !flags.stale && !flags.all) {
+            if (!flags.standard &&
+                !flags.comprehensive &&
+                !flags.executed &&
+                !flags.stale &&
+                !flags.all) {
                 await this.interactiveClear(promptManager);
                 return;
             }
@@ -69,15 +75,16 @@ export default class PromptsClear extends Command {
             }
             // Display what will be deleted
             console.log(chalk.bold.cyan(`\n📋 Prompts to Delete (${toDelete.length}):\n`));
-            toDelete.forEach(p => {
+            toDelete.forEach((p) => {
                 const status = p.executed ? chalk.green('✓') : chalk.gray('○');
                 const age = p.ageInDays === 0 ? 'today' : `${p.ageInDays}d ago`;
-                console.log(`  ${status} [${p.source}] ${p.id} (${age})`);
+                const depthLabel = p.depthUsed === 'comprehensive' ? 'comp' : 'std';
+                console.log(`  ${status} [${depthLabel}] ${p.id} (${age})`);
                 console.log(`     ${chalk.gray(p.originalPrompt.substring(0, 60))}...`);
             });
             console.log();
             // Safety check for unexecuted prompts
-            const unexecuted = toDelete.filter(p => !p.executed);
+            const unexecuted = toDelete.filter((p) => !p.executed);
             if (unexecuted.length > 0 && !flags.force) {
                 console.log(chalk.yellow(`⚠️  Warning: ${unexecuted.length} unexecuted prompts will be deleted\n`));
                 const { proceed } = await inquirer.prompt([
@@ -115,7 +122,7 @@ export default class PromptsClear extends Command {
             const stats = await promptManager.getStorageStats();
             if (stats.totalPrompts > 0) {
                 console.log(chalk.gray(`Remaining prompts: ${stats.totalPrompts}`));
-                console.log(chalk.gray(`  Fast: ${stats.fastPrompts} | Deep: ${stats.deepPrompts}`));
+                console.log(chalk.gray(`  Standard: ${stats.standardPrompts} | Comprehensive: ${stats.comprehensivePrompts}`));
                 console.log(chalk.gray(`  Executed: ${stats.executedPrompts} | Pending: ${stats.pendingPrompts}\n`));
             }
         }
@@ -134,8 +141,8 @@ export default class PromptsClear extends Command {
             { name: 'Executed prompts only (safe)', value: 'executed' },
             { name: 'Stale prompts (>30 days old)', value: 'stale' },
             { name: 'Old prompts (>7 days old)', value: 'old' },
-            { name: 'Fast prompts only', value: 'fast' },
-            { name: 'Deep prompts only', value: 'deep' },
+            { name: 'Standard depth prompts only', value: 'standard' },
+            { name: 'Comprehensive depth prompts only', value: 'comprehensive' },
             { name: chalk.red('All prompts (dangerous)'), value: 'all' },
             { name: 'Cancel', value: 'cancel' },
         ];
@@ -162,26 +169,25 @@ export default class PromptsClear extends Command {
         else if (selection === 'old') {
             filters.old = true;
         }
-        else if (selection === 'fast') {
-            filters.source = 'fast';
+        else if (selection === 'standard') {
+            filters.depthUsed = 'standard';
         }
-        else if (selection === 'deep') {
-            filters.source = 'deep';
+        else if (selection === 'comprehensive') {
+            filters.depthUsed = 'comprehensive';
         }
         // 'all' means no filters
         // Get matching prompts
-        const toDelete = selection === 'all'
-            ? allPrompts
-            : await manager.listPrompts(filters);
+        const toDelete = selection === 'all' ? allPrompts : await manager.listPrompts(filters);
         if (toDelete.length === 0) {
             console.log(chalk.yellow('\n⚠️  No prompts match the selected criteria\n'));
             return;
         }
         // Show preview
         console.log(chalk.cyan(`\nWill delete ${toDelete.length} prompt(s):\n`));
-        toDelete.slice(0, 5).forEach(p => {
+        toDelete.slice(0, 5).forEach((p) => {
             const status = p.executed ? chalk.green('✓') : chalk.gray('○');
-            console.log(`  ${status} [${p.source}] ${p.id}`);
+            const depthLabel = p.depthUsed === 'comprehensive' ? 'comp' : 'std';
+            console.log(`  ${status} [${depthLabel}] ${p.id}`);
         });
         if (toDelete.length > 5) {
             console.log(chalk.gray(`  ... and ${toDelete.length - 5} more`));

package/dist/cli/commands/prompts/list.js

@@ -3,9 +3,7 @@ import chalk from 'chalk';
 import { PromptManager } from '../../../core/prompt-manager.js';
 export default class PromptsList extends Command {
     static description = 'List all saved prompts with age warnings and storage statistics';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-    ];
+    static examples = ['<%= config.bin %> <%= command.id %>'];
     async run() {
         const promptManager = new PromptManager();
         try {
@@ -15,28 +13,27 @@ export default class PromptsList extends Command {
             if (prompts.length === 0) {
                 console.log(chalk.gray('No prompts saved yet.\n'));
                 console.log(chalk.cyan('Generate an optimized prompt:'));
-                console.log(chalk.cyan('  /clavix:fast "your requirement"'));
-                console.log(chalk.cyan('  /clavix:deep "your requirement"'));
+                console.log(chalk.cyan('  /clavix:improve "your requirement"'));
                 console.log();
                 return;
             }
-            // Display prompts grouped by source
-            const fastPrompts = prompts.filter(p => p.source === 'fast');
-            const deepPrompts = prompts.filter(p => p.source === 'deep');
-            if (fastPrompts.length > 0) {
-                console.log(chalk.bold('Fast Prompts:'));
-                this.displayPrompts(fastPrompts);
+            // Display prompts grouped by depth
+            const standardPrompts = prompts.filter((p) => p.depthUsed === 'standard');
+            const comprehensivePrompts = prompts.filter((p) => p.depthUsed === 'comprehensive');
+            if (standardPrompts.length > 0) {
+                console.log(chalk.bold('Standard Depth Prompts:'));
+                this.displayPrompts(standardPrompts);
                 console.log();
             }
-            if (deepPrompts.length > 0) {
-                console.log(chalk.bold('Deep Prompts:'));
-                this.displayPrompts(deepPrompts);
+            if (comprehensivePrompts.length > 0) {
+                console.log(chalk.bold('Comprehensive Depth Prompts:'));
+                this.displayPrompts(comprehensivePrompts);
                 console.log();
             }
             // Display storage statistics
             console.log(chalk.bold('📊 Storage Statistics:\n'));
             console.log(chalk.gray(`  Total Prompts: ${stats.totalPrompts}`));
-            console.log(chalk.gray(`  Fast: ${stats.fastPrompts} | Deep: ${stats.deepPrompts}`));
+            console.log(chalk.gray(`  Standard: ${stats.standardPrompts} | Comprehensive: ${stats.comprehensivePrompts}`));
             console.log(chalk.gray(`  Executed: ${stats.executedPrompts} | Pending: ${stats.pendingPrompts}`));
             if (stats.oldestPromptAge > 0) {
                 console.log(chalk.gray(`  Oldest: ${stats.oldestPromptAge} days`));
@@ -61,7 +58,7 @@ export default class PromptsList extends Command {
         }
     }
     displayPrompts(prompts) {
-        prompts.forEach(p => {
+        prompts.forEach((p) => {
             const status = p.executed ? chalk.green('✓') : chalk.gray('○');
             const ageInDays = p.ageInDays || 0;
             // Age warning coloring
@@ -82,9 +79,7 @@ export default class PromptsList extends Command {
                 ageStr = chalk.gray(`${ageInDays}d`);
             }
             // Truncate original prompt for display
-            const promptPreview = p.originalPrompt.length > 50
-                ? p.originalPrompt.substring(0, 50) + '...'
-                : p.originalPrompt;
+            const promptPreview = p.originalPrompt.length > 50 ? p.originalPrompt.substring(0, 50) + '...' : p.originalPrompt;
             console.log(`  ${status} ${chalk.dim(p.id)} (${ageStr})${ageWarning}`);
             console.log(`     ${chalk.gray(promptPreview)}`);
         });

package/dist/cli/commands/summarize.js

@@ -80,8 +80,7 @@ export default class Summarize extends Command {
             this.displayAnalysisSummary(analysis);
             // Generate outputs
             console.log(chalk.dim('\nGenerating output files...\n'));
-            const outputDir = flags.output ||
-                path.join('.clavix/outputs', this.sanitizeProjectName(session.projectName));
+            const outputDir = flags.output || path.join('.clavix/outputs', this.sanitizeProjectName(session.projectName));
             await FileSystem.ensureDir(outputDir);
             // Generate mini-PRD
             const miniPrdContent = analyzer.generateMiniPrd(session, analysis);
@@ -97,17 +96,27 @@ export default class Summarize extends Command {
             // Display success
             console.log(chalk.bold.green('\n✓ Analysis complete!\n'));
             console.log(chalk.bold('Generated files:'));
-            console.log(chalk.gray('  • ') + chalk.cyan('mini-prd.md') + chalk.dim(' - Structured requirements document'));
+            console.log(chalk.gray('  • ') +
+                chalk.cyan('mini-prd.md') +
+                chalk.dim(' - Structured requirements document'));
             console.log(chalk.gray('  • ') + chalk.cyan('original-prompt.md') + chalk.dim(' - Raw extracted prompt'));
-            console.log(chalk.gray('  • ') + chalk.cyan('optimized-prompt.md') + chalk.dim(' - Enhanced AI-ready prompt'));
+            console.log(chalk.gray('  • ') +
+                chalk.cyan('optimized-prompt.md') +
+                chalk.dim(' - Enhanced AI-ready prompt'));
             console.log();
             console.log(chalk.bold('Output location:'));
             console.log(chalk.dim(`  ${outputDir}`));
             console.log();
             console.log(chalk.bold('💡 Next steps:'));
-            console.log(chalk.gray('  • Use ') + chalk.cyan('optimized-prompt.md') + chalk.gray(' for best AI results'));
-            console.log(chalk.gray('  • Share ') + chalk.cyan('mini-prd.md') + chalk.gray(' with your team for alignment'));
-            console.log(chalk.gray('  • Run ') + chalk.cyan('clavix implement') + chalk.gray(' to start development'));
+            console.log(chalk.gray('  • Use ') +
+                chalk.cyan('optimized-prompt.md') +
+                chalk.gray(' for best AI results'));
+            console.log(chalk.gray('  • Share ') +
+                chalk.cyan('mini-prd.md') +
+                chalk.gray(' with your team for alignment'));
+            console.log(chalk.gray('  • Run ') +
+                chalk.cyan('clavix implement') +
+                chalk.gray(' to start development'));
             console.log();
         }
         catch (error) {
@@ -129,7 +138,7 @@ export default class Summarize extends Command {
         }
         if (analysis.technicalConstraints.length > 0) {
             console.log(chalk.bold('Technical Constraints:'));
-            analysis.technicalConstraints.slice(0, 3).forEach(constraint => {
+            analysis.technicalConstraints.slice(0, 3).forEach((constraint) => {
                 console.log(chalk.gray(`  • ${constraint}`));
             });
             if (analysis.technicalConstraints.length > 3) {
@@ -139,7 +148,7 @@ export default class Summarize extends Command {
         }
         if (analysis.successCriteria.length > 0) {
             console.log(chalk.bold('Success Criteria:'));
-            analysis.successCriteria.slice(0, 3).forEach(criterion => {
+            analysis.successCriteria.slice(0, 3).forEach((criterion) => {
                 console.log(chalk.gray(`  ✓ ${criterion}`));
             });
             if (analysis.successCriteria.length > 3) {
@@ -151,8 +160,9 @@ export default class Summarize extends Command {
     async applyOptimization(rawPrompt, outputDir) {
         try {
             console.log(chalk.dim('Optimizing extracted prompt...\n'));
+            // v4.11: Use improve mode
             const optimizer = new UniversalOptimizer();
-            const result = await optimizer.optimize(rawPrompt, 'fast');
+            const result = await optimizer.optimize(rawPrompt, 'improve');
             // Display optimization results
             console.log(chalk.bold('✨ Optimization Results:\n'));
             console.log(chalk.cyan(`  Intent: ${result.intent.primaryIntent}`));
@@ -167,21 +177,20 @@ export default class Summarize extends Command {
             const optimizedPath = path.join(outputDir, 'optimized-prompt.md');
             await FileSystem.writeFileAtomic(optimizedPath, result.enhanced);
         }
-        catch (error) {
+        catch {
             console.log(chalk.yellow('⚠️  Could not optimize prompt'));
             console.log(chalk.gray('Using original extracted version...\n'));
             // Fallback: copy original to optimized
-            const originalPath = path.join(outputDir, 'original-prompt.md');
             const optimizedPath = path.join(outputDir, 'optimized-prompt.md');
             await FileSystem.writeFileAtomic(optimizedPath, rawPrompt);
         }
     }
     sanitizeProjectName(name) {
-        return name
+        return (name
             .toLowerCase()
             .replace(/[^a-z0-9-]/g, '-')
             .replace(/-+/g, '-')
-            .replace(/^-|-$/g, '') || 'unnamed-project';
+            .replace(/^-|-$/g, '') || 'unnamed-project');
     }
 }
 //# sourceMappingURL=summarize.js.map

package/dist/cli/commands/verify.d.ts

@@ -4,8 +4,8 @@ export default class Verify extends Command {
     static examples: string[];
     static flags: {
         latest: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        fast: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        deep: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        standard: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        comprehensive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         status: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'retry-failed': import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/cli/commands/verify.js

@@ -7,11 +7,11 @@ import { ChecklistParser } from '../../core/checklist-parser.js';
 import { BasicChecklistGenerator } from '../../core/basic-checklist-generator.js';
 import { IntentDetector } from '../../core/intelligence/intent-detector.js';
 export default class Verify extends Command {
-    static description = 'Verify implementation against checklist from deep/fast mode';
+    static description = 'Verify implementation against checklist from improve mode';
     static examples = [
         '<%= config.bin %> <%= command.id %> --latest',
-        '<%= config.bin %> <%= command.id %> --latest --deep',
-        '<%= config.bin %> <%= command.id %> --id deep-20250117-143022-a3f2',
+        '<%= config.bin %> <%= command.id %> --latest --comprehensive',
+        '<%= config.bin %> <%= command.id %> --id comp-20250117-143022-a3f2',
         '<%= config.bin %> <%= command.id %> --status',
         '<%= config.bin %> <%= command.id %> --retry-failed',
     ];
@@ -20,12 +20,14 @@ export default class Verify extends Command {
             description: 'Verify latest executed prompt',
             default: false,
         }),
-        fast: Flags.boolean({
-            description: 'Filter to fast prompts only (use with --latest)',
+        standard: Flags.boolean({
+            char: 's',
+            description: 'Filter to standard depth prompts only (use with --latest)',
             default: false,
         }),
-        deep: Flags.boolean({
-            description: 'Filter to deep prompts only (use with --latest)',
+        comprehensive: Flags.boolean({
+            char: 'c',
+            description: 'Filter to comprehensive depth prompts only (use with --latest)',
             default: false,
         }),
         id: Flags.string({
@@ -66,8 +68,7 @@ export default class Verify extends Command {
             if (allPrompts.length === 0) {
                 console.log(chalk.yellow('\n⚠️  No prompts found\n'));
                 console.log(chalk.cyan('Generate an optimized prompt first:'));
-                console.log(chalk.cyan('  /clavix:fast "your requirement"'));
-                console.log(chalk.cyan('  /clavix:deep "your requirement"'));
+                console.log(chalk.cyan('  /clavix:improve "your requirement"'));
                 console.log();
                 return;
             }
@@ -85,12 +86,12 @@ export default class Verify extends Command {
             // Auto-select latest with optional filtering
             else if (flags.latest) {
                 let filtered = allPrompts;
-                // Filter by source
-                if (flags.fast && !flags.deep) {
-                    filtered = allPrompts.filter((p) => p.source === 'fast');
+                // Filter by depth
+                if (flags.standard && !flags.comprehensive) {
+                    filtered = allPrompts.filter((p) => p.depthUsed === 'standard');
                 }
-                else if (flags.deep && !flags.fast) {
-                    filtered = allPrompts.filter((p) => p.source === 'deep');
+                else if (flags.comprehensive && !flags.standard) {
+                    filtered = allPrompts.filter((p) => p.depthUsed === 'comprehensive');
                 }
                 // Filter to executed prompts preferably
                 const executedFiltered = filtered.filter((p) => p.executed);
@@ -98,8 +99,8 @@ export default class Verify extends Command {
                     filtered = executedFiltered;
                 }
                 if (filtered.length === 0) {
-                    const source = flags.fast ? 'fast' : flags.deep ? 'deep' : 'any';
-                    console.log(chalk.yellow(`\n⚠️  No ${source} prompts found\n`));
+                    const depth = flags.standard ? 'standard' : flags.comprehensive ? 'comprehensive' : 'any';
+                    console.log(chalk.yellow(`\n⚠️  No ${depth} prompts found\n`));
                     return;
                 }
                 selectedPrompt = filtered[0];
@@ -136,8 +137,9 @@ export default class Verify extends Command {
             const executed = p.executed ? chalk.green('✓') : chalk.gray('○');
             const age = p.ageInDays === 0 ? 'today' : `${p.ageInDays}d ago`;
             const ageColor = (p.ageInDays || 0) > 30 ? chalk.red : (p.ageInDays || 0) > 7 ? chalk.yellow : chalk.gray;
+            const depthLabel = p.depthUsed === 'comprehensive' ? 'comp' : 'std';
             return {
-                name: `${executed} [${p.source}] ${p.originalPrompt.substring(0, 50)}... ${ageColor(`(${age})`)}`,
+                name: `${executed} [${depthLabel}] ${p.originalPrompt.substring(0, 50)}... ${ageColor(`(${age})`)}`,
                 value: p.id,
                 short: p.id,
             };
@@ -188,7 +190,7 @@ export default class Verify extends Command {
     }
     async runVerification(prompt, options) {
         console.log(chalk.bold.cyan(`\n🔍 Verifying: ${prompt.id}\n`));
-        console.log(chalk.gray(`Source: ${prompt.source}`));
+        console.log(chalk.gray(`Depth: ${prompt.depthUsed}`));
         console.log(chalk.gray(`Created: ${new Date(prompt.timestamp).toLocaleDateString()}`));
         console.log();
         // Load prompt content
@@ -199,16 +201,16 @@ export default class Verify extends Command {
         }
         // Parse checklist from prompt
         let checklist = this.checklistParser.parse(promptData.content);
-        // Handle fast mode - generate basic checklist if none exists
-        if (!checklist.hasChecklist && prompt.source === 'fast') {
-            console.log(chalk.yellow('⚠️  No checklist found (fast mode prompt)'));
+        // Handle standard depth - generate basic checklist if none exists
+        if (!checklist.hasChecklist && prompt.depthUsed === 'standard') {
+            console.log(chalk.yellow('⚠️  No checklist found (standard depth prompt)'));
             console.log(chalk.cyan('Generating basic checklist based on intent...\n'));
             // Detect intent from original prompt
             const intent = this.intentDetector.analyze(prompt.originalPrompt);
             checklist = this.basicChecklistGenerator.generateFromPrompt(prompt.originalPrompt, intent.primaryIntent);
             console.log(chalk.gray(`Intent: ${intent.primaryIntent} (${intent.confidence}% confidence)`));
             console.log(chalk.gray(`Generated ${checklist.totalItems} checklist items\n`));
-            console.log(chalk.yellow('💡 For comprehensive checklists, use /clavix:deep\n'));
+            console.log(chalk.yellow('💡 For comprehensive checklists, use /clavix:improve --comprehensive\n'));
         }
         if (!checklist.hasChecklist) {
             console.log(chalk.yellow('No checklist items to verify.'));
@@ -218,8 +220,8 @@ export default class Verify extends Command {
         let report = await this.verificationManager.loadReport(prompt.id);
         if (!report) {
             report = await this.verificationManager.initializeVerification(prompt.id);
-            // Update with parsed checklist if from fast mode
-            if (prompt.source === 'fast') {
+            // Update with parsed checklist if from standard depth
+            if (prompt.depthUsed === 'standard') {
                 report.items = [...checklist.validationItems, ...checklist.edgeCases, ...checklist.risks];
                 report.results = report.items.map((item) => ({
                     itemId: item.id,

package/dist/core/doc-injector.d.ts

@@ -41,11 +41,13 @@ export declare class DocInjector {
     private static validateMarkdown;
     /**
      * Create default AGENTS.md content
+     * v4.11: Updated for unified /clavix:improve command
      */
     static getDefaultAgentsContent(): string;
     /**
      * Create the CLAUDE.md block content (without file wrapper)
      * This is the single source of truth for Claude Code documentation
+     * v4.11: Updated for unified /clavix:improve command
      */
     static getClaudeBlockContent(): string;
     /**

package/dist/core/doc-injector.js

@@ -134,6 +134,7 @@ export class DocInjector {
     }
     /**
      * Create default AGENTS.md content
+     * v4.11: Updated for unified /clavix:improve command
      */
     static getDefaultAgentsContent() {
         return `# AI Agent Instructions
@@ -145,17 +146,18 @@ This file contains instructions for AI agents working with this project.
 
 Clavix is installed in this project. Use the following slash commands:
 
-- \`/clavix:fast [prompt]\` - Quick prompt improvements with smart triage
-- \`/clavix:deep [prompt]\` - Comprehensive prompt analysis
+- \`/clavix:improve [prompt]\` - Optimize prompts with smart depth auto-selection
 - \`/clavix:prd\` - Generate a PRD through guided questions
 - \`/clavix:start\` - Start conversational mode for iterative refinement
 - \`/clavix:summarize\` - Extract optimized prompt from conversation
 
 **When to use:**
-- **Fast mode**: Quick cleanup for simple prompts
-- **Deep mode**: Comprehensive analysis for complex requirements
+- **Standard depth**: Quick cleanup for simple, clear prompts
+- **Comprehensive depth**: Thorough analysis for complex requirements
 - **PRD mode**: Strategic planning with architecture and business impact
 
+Clavix automatically selects the appropriate depth based on your prompt quality.
+
 For more information, run \`clavix --help\` in your terminal.
 <!-- CLAVIX:END -->
 `;
@@ -163,6 +165,7 @@ For more information, run \`clavix --help\` in your terminal.
     /**
      * Create the CLAUDE.md block content (without file wrapper)
      * This is the single source of truth for Claude Code documentation
+     * v4.11: Updated for unified /clavix:improve command
      */
     static getClaudeBlockContent() {
         return `## Clavix Integration
@@ -171,11 +174,8 @@ This project uses Clavix for prompt improvement and PRD generation. The followin
 
 ### Prompt Optimization Commands
 
-#### /clavix:fast [prompt]
-Quick prompt improvements with smart triage. Clavix will analyze your prompt and recommend deep analysis if needed. Perfect for making "shitty prompts good" quickly.
-
-#### /clavix:deep [prompt]
-Comprehensive prompt analysis with alternative phrasings, edge cases, implementation examples, and potential issues. Use for complex requirements or when you want thorough exploration.
+#### /clavix:improve [prompt]
+Optimize prompts with smart depth auto-selection. Clavix analyzes your prompt quality and automatically selects the appropriate depth (standard or comprehensive). Use for all prompt optimization needs.
 
 ### PRD & Planning Commands
 
@@ -199,17 +199,16 @@ Analyze the current conversation and extract key requirements into a structured
 ### Utility Commands
 
 #### /clavix:execute
-Run saved prompts with lifecycle awareness. Execute previously saved fast/deep prompts.
+Run saved prompts with lifecycle awareness. Execute previously optimized prompts.
 
 #### /clavix:prompts
-Manage your saved fast/deep prompts. List, view, and organize your prompt library.
+Manage your saved prompts. List, view, and organize your prompt library.
 
 #### /clavix:archive
 Archive completed projects. Move finished PRDs and outputs to the archive for future reference.
 
 **When to use which mode:**
-- **Fast mode** (\`/clavix:fast\`): Quick cleanup for simple prompts
-- **Deep mode** (\`/clavix:deep\`): Comprehensive analysis for complex requirements
+- **Improve mode** (\`/clavix:improve\`): Smart prompt optimization with auto-depth selection
 - **PRD mode** (\`/clavix:prd\`): Strategic planning with architecture and business impact
 
 **Recommended Workflow:**

package/dist/core/intelligence/intent-detector.d.ts

@@ -39,6 +39,10 @@ export declare class IntentDetector {
     private hasPerformanceTerms;
     private isOpenEnded;
     private needsStructure;
+    /**
+     * v4.11: Suggest optimization mode (always 'improve' for prompt optimization)
+     * For depth level suggestions, use suggestDepthLevel() instead
+     */
     private suggestMode;
     /**
      * v4.0: Enhanced analysis with secondary intents and ambiguity detection

package/dist/core/intelligence/intent-detector.js

@@ -651,24 +651,14 @@ export class IntentDetector {
         const structureScore = [hasObjective, hasRequirements, hasConstraints].filter(Boolean).length;
         return structureScore < 2;
     }
-    suggestMode(intent, characteristics, promptLength, confidence) {
-        // Low confidence suggests deep mode
-        if (confidence < 60) {
-            return 'deep';
-        }
-        // Planning always benefits from deep mode
-        if (intent === 'planning') {
-            return 'deep';
-        }
-        // Open-ended without code context suggests deep mode
-        if (characteristics.isOpenEnded && !characteristics.hasCodeContext) {
-            return 'deep';
-        }
-        // Very short prompts needing structure suggest deep mode
-        if (promptLength < 50 && characteristics.needsStructure) {
-            return 'deep';
-        }
-        return 'fast';
+    /**
+     * v4.11: Suggest optimization mode (always 'improve' for prompt optimization)
+     * For depth level suggestions, use suggestDepthLevel() instead
+     */
+    suggestMode(_intent, _characteristics, _promptLength, _confidence) {
+        // v4.11: All prompt optimization uses 'improve' mode
+        // Depth level (standard/comprehensive) is determined separately
+        return 'improve';
     }
     /**
      * v4.0: Enhanced analysis with secondary intents and ambiguity detection

package/dist/core/intelligence/pattern-library.d.ts

@@ -1,5 +1,5 @@
 import { BasePattern, IPatternLibrary } from './patterns/base-pattern.js';
-import { IntentAnalysis, OptimizationMode, OptimizationPhase } from './types.js';
+import { IntentAnalysis, OptimizationMode, OptimizationPhase, DepthLevel } from './types.js';
 import { IntelligenceConfig } from '../../types/config.js';
 export declare class PatternLibrary implements IPatternLibrary {
     private patterns;
@@ -45,11 +45,12 @@ export declare class PatternLibrary implements IPatternLibrary {
         completeness: number;
         actionability: number;
         overall: number;
-    }, mode: OptimizationMode): BasePattern[];
+    }, mode: OptimizationMode, depthLevel?: DepthLevel): BasePattern[];
     /**
-     * Select applicable patterns for the given context
+     * v4.11: Select applicable patterns for the given context
+     * Now uses DepthLevel ('standard' | 'comprehensive') for pattern filtering
      */
-    selectPatterns(intent: IntentAnalysis, mode: OptimizationMode): BasePattern[];
+    selectPatterns(intent: IntentAnalysis, mode: OptimizationMode, depthLevel?: DepthLevel): BasePattern[];
     /**
      * v4.5: Sort patterns by priority while respecting dependency constraints.
      * Handles runAfter (must run after specified patterns) and excludesWith (mutually exclusive).
@@ -65,10 +66,10 @@ export declare class PatternLibrary implements IPatternLibrary {
      */
     private adjustForDependencies;
     /**
-     * v4.5: Select patterns for specific mode with phase-awareness
-     * Maps PRD and conversational modes to appropriate base modes and patterns
+     * v4.11: Select patterns for specific mode with phase-awareness
+     * Maps PRD and conversational modes to appropriate depth levels for pattern selection
      */
-    selectPatternsForMode(mode: OptimizationMode, intent: IntentAnalysis, phase?: OptimizationPhase): BasePattern[];
+    selectPatternsForMode(mode: OptimizationMode, intent: IntentAnalysis, phase?: OptimizationPhase, depthLevel?: DepthLevel): BasePattern[];
     /**
      * v4.5: Check if pattern is applicable for a given phase.
      * Uses pattern's declared phases property instead of hardcoded mappings.
@@ -79,15 +80,20 @@ export declare class PatternLibrary implements IPatternLibrary {
      */
     private mapOptimizationPhaseToPatternPhase;
     /**
-     * Map extended modes to base modes for pattern compatibility
+     * v4.11: Map mode and phase to depth level for pattern selection
      */
-    private mapToBaseMode;
+    private mapToDepthLevel;
     /**
      * Get all registered patterns
      */
     getAllPatterns(): BasePattern[];
     /**
-     * Get patterns by mode
+     * v4.11: Get patterns by scope (standard or comprehensive)
+     */
+    getPatternsByScope(scope: DepthLevel): BasePattern[];
+    /**
+     * Get patterns by mode (backward compatibility)
+     * @deprecated Use getPatternsByScope() instead
      */
     getPatternsByMode(mode: OptimizationMode): BasePattern[];
     /**