clavix 4.1.2 → 4.3.1

package/dist/cli/commands/deep.js

@@ -87,64 +87,13 @@ export default class Deep extends Command {
             console.log();
         }
         // ===== Enhanced Prompt =====
+        // Note: Pattern-generated content (Alternative Approaches, Edge Cases, Validation Checklist)
+        // is already embedded in result.enhanced by deep mode patterns
         console.log(chalk.bold.cyan('✨ Enhanced Prompt:\n'));
         console.log(chalk.dim('─'.repeat(80)));
         console.log(result.enhanced);
         console.log(chalk.dim('─'.repeat(80)));
         console.log();
-        // ===== DEEP MODE EXCLUSIVE FEATURES =====
-        // Alternative Approaches (TODO: when AlternativePhrasingGenerator pattern is implemented)
-        console.log(chalk.bold.cyan('🎨 Alternative Approaches:\n'));
-        console.log(chalk.cyan('  1. Functional Decomposition: Break the task into smaller, testable functions'));
-        console.log(chalk.cyan('  2. Test-Driven Approach: Write tests first, then implement to satisfy them'));
-        console.log(chalk.cyan('  3. Example-Driven: Start with concrete input/output examples'));
-        console.log(chalk.gray('  Note: Full alternative generation coming soon with deep mode patterns\n'));
-        // Alternative Structures (TODO: when StructureVariationGenerator pattern is implemented)
-        console.log(chalk.bold.cyan('📋 Alternative Structures:\n'));
-        console.log(chalk.cyan('  Step-by-step:'));
-        console.log(chalk.gray('    • Break complex task into sequential steps'));
-        console.log(chalk.gray('    • Each step has clear input/output'));
-        console.log(chalk.cyan('  Template-based:'));
-        console.log(chalk.gray('    • Provide code/document template to fill'));
-        console.log(chalk.gray('    • Reduces ambiguity with concrete structure'));
-        console.log(chalk.cyan('  Example-driven:'));
-        console.log(chalk.gray('    • Show concrete examples of desired output'));
-        console.log(chalk.gray('    • AI learns from patterns in examples\n'));
-        // Validation Checklist (TODO: when ValidationChecklistCreator pattern is implemented)
-        console.log(chalk.bold.yellow('✅ Validation Checklist:\n'));
-        console.log(chalk.yellow('  Before considering this task complete, verify:'));
-        console.log(chalk.yellow('    ☐ Requirements match the objective stated above'));
-        console.log(chalk.yellow('    ☐ All edge cases are handled (empty, null, invalid inputs)'));
-        console.log(chalk.yellow('    ☐ Error handling is appropriate for the context'));
-        console.log(chalk.yellow('    ☐ Output format matches specifications'));
-        console.log(chalk.yellow('    ☐ Performance is acceptable for expected input sizes'));
-        if (result.intent.primaryIntent === 'code-generation') {
-            console.log(chalk.yellow('    ☐ Code is testable and maintainable'));
-            console.log(chalk.yellow('    ☐ Security considerations addressed (injection, XSS, etc.)'));
-        }
-        console.log();
-        // Edge Cases (TODO: when EdgeCaseIdentifier pattern is implemented)
-        console.log(chalk.bold.yellow('⚠️  Edge Cases to Consider:\n'));
-        if (result.intent.primaryIntent === 'code-generation') {
-            console.log(chalk.yellow('  • Empty or null inputs'));
-            console.log(chalk.yellow('  • Very large inputs (performance implications)'));
-            console.log(chalk.yellow('  • Invalid or malformed data'));
-            console.log(chalk.yellow('  • Concurrent access (if applicable)'));
-            console.log(chalk.yellow('  • Network failures or timeouts (if I/O involved)'));
-        }
-        else if (result.intent.primaryIntent === 'planning') {
-            console.log(chalk.yellow('  • Scope creep during implementation'));
-            console.log(chalk.yellow('  • Technical constraints not identified upfront'));
-            console.log(chalk.yellow('  • Timeline assumptions that may not hold'));
-            console.log(chalk.yellow('  • Dependencies on external systems'));
-        }
-        else {
-            console.log(chalk.yellow('  • Unexpected user behavior'));
-            console.log(chalk.yellow('  • Error conditions and recovery'));
-            console.log(chalk.yellow('  • Resource limitations'));
-            console.log(chalk.yellow('  • Compatibility across environments'));
-        }
-        console.log();
         // Patterns Applied
         if (result.appliedPatterns.length > 0) {
             console.log(chalk.bold.blue('🧩 Patterns Applied:\n'));
@@ -168,7 +117,7 @@ export default class Deep extends Command {
             console.log(chalk.blue(`  ${recommendation}\n`));
         }
         console.log(chalk.gray(`⚡ Processed in ${result.processingTimeMs}ms\n`));
-        console.log(chalk.gray('💡 Tip: Use the enhanced prompt with the validation checklist and edge cases in mind\n'));
+        console.log(chalk.gray('💡 Tip: The enhanced prompt above includes alternative approaches, edge cases, and validation checklist\n'));
     }
     displayAnalysisOnly(result) {
         console.log(chalk.bold.cyan('🎯 Intent Analysis:\n'));
@@ -198,9 +147,6 @@ export default class Deep extends Command {
     async savePrompt(result) {
         try {
             const manager = new PromptManager();
-            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
-            const hash = this.generateShortHash(result.original);
-            const filename = `deep-${timestamp}-${hash}`;
             // Format enhanced prompt as content
             const content = result.enhanced;
             await manager.savePrompt(content, 'deep', result.original);
@@ -215,7 +161,7 @@ export default class Deep extends Command {
         let hash = 0;
         for (let i = 0; i < text.length; i++) {
             const char = text.charCodeAt(i);
-            hash = ((hash << 5) - hash) + char;
+            hash = (hash << 5) - hash + char;
             hash = hash & hash;
         }
         return Math.abs(hash).toString(16).slice(0, 4);

package/dist/cli/commands/init.js

@@ -17,9 +17,7 @@ import { loadCommandTemplates } from '../../utils/template-loader.js';
 import { collectLegacyCommandFiles } from '../../utils/legacy-command-cleanup.js';
 export default class Init extends Command {
     static description = 'Initialize Clavix in the current project';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-    ];
+    static examples = ['<%= config.bin %> <%= command.id %>'];
     async run() {
         console.log(chalk.bold.cyan('\n🚀 Clavix Initialization\n'));
         try {
@@ -47,7 +45,7 @@ export default class Init extends Command {
                     const config = JSON.parse(configContent);
                     existingIntegrations = config.integrations || config.providers || [];
                 }
-                catch (error) {
+                catch {
                     // Ignore parse errors, will use empty array
                 }
             }
@@ -161,9 +159,10 @@ export default class Init extends Command {
                         },
                     ]);
                     if (!useNamespace) {
-                        adapter = adapter.name === 'gemini'
-                            ? new GeminiAdapter({ useNamespace: false })
-                            : new QwenAdapter({ useNamespace: false });
+                        adapter =
+                            adapter.name === 'gemini'
+                                ? new GeminiAdapter({ useNamespace: false })
+                                : new QwenAdapter({ useNamespace: false });
                         console.log(chalk.gray(`    → Using ${adapter.getCommandPath()} (no namespacing)`));
                     }
                 }
@@ -235,19 +234,17 @@ export default class Init extends Command {
         catch (error) {
             const { getErrorMessage, toError } = await import('../../utils/error-utils.js');
             console.error(chalk.red('\n✗ Initialization failed:'), getErrorMessage(error));
-            if (error && typeof error === 'object' && 'hint' in error && typeof error.hint === 'string') {
+            if (error &&
+                typeof error === 'object' &&
+                'hint' in error &&
+                typeof error.hint === 'string') {
                 console.error(chalk.yellow('  Hint:'), error.hint);
             }
             throw toError(error);
         }
     }
     async createDirectoryStructure() {
-        const dirs = [
-            '.clavix',
-            '.clavix/sessions',
-            '.clavix/outputs',
-            '.clavix/templates',
-        ];
+        const dirs = ['.clavix', '.clavix/sessions', '.clavix/outputs', '.clavix/templates'];
         for (const dir of dirs) {
             await FileSystem.ensureDir(dir);
         }
@@ -289,8 +286,8 @@ Welcome to Clavix! This directory contains your local Clavix configuration and d
 ## CLI Commands Reference
 
 ### Prompt Improvement
-- \`clavix fast "<prompt>"\` - Quick CLEAR (C/L/E) improvements with smart triage
-- \`clavix deep "<prompt>"\` - Comprehensive CLEAR (C/L/E/A/R) analysis with alternatives
+- \`clavix fast "<prompt>"\` - Quick Clavix Intelligence improvements with smart triage
+- \`clavix deep "<prompt>"\` - Comprehensive Clavix Intelligence analysis with alternatives
 - \`clavix execute [--latest]\` - Execute saved prompts from fast/deep optimization
 - \`clavix prompts list\` - View all saved prompts with status (NEW/EXECUTED/OLD/STALE)
 - \`clavix prompts clear\` - Cleanup prompts (\`--executed\`, \`--stale\`, \`--fast\`, \`--deep\`, \`--all\`)

package/dist/cli/commands/plan.js

@@ -80,7 +80,7 @@ export default class Plan extends Command {
             const resolvedProjectName = projectName ?? path.basename(prdPath);
             // Check if tasks.md already exists
             const tasksPath = path.join(prdPath, 'tasks.md');
-            if (await fs.pathExists(tasksPath) && !flags.overwrite) {
+            if ((await fs.pathExists(tasksPath)) && !flags.overwrite) {
                 console.log(chalk.yellow('Warning: tasks.md already exists.'));
                 console.log(chalk.gray(`Location: ${tasksPath}`));
                 console.log(chalk.gray('Use --overwrite to regenerate tasks.md.\n'));
@@ -151,7 +151,7 @@ export default class Plan extends Command {
             console.log(chalk.gray('  2. Edit if needed (add/remove/modify tasks)'));
             console.log(chalk.gray('  3. Run'), chalk.cyan('clavix implement'), chalk.gray('to start implementation'));
             console.log();
-            console.log(chalk.dim('Tip: Tasks follow CLEAR framework principles for optimal AI execution\n'));
+            console.log(chalk.dim('Tip: Tasks are optimized with Clavix Intelligence for optimal AI execution\n'));
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'An unexpected error occurred';

package/dist/core/task-manager.d.ts

@@ -3,7 +3,7 @@
  *
  * This class handles:
  * - Analyzing PRD documents
- * - Generating CLEAR-optimized task breakdowns
+ * - Generating optimized task breakdowns
  * - Reading/writing tasks.md with checkbox format
  * - Tracking task completion state
  * - Managing session resume capability
@@ -51,7 +51,6 @@ export interface TaskGenerationResult {
  * Generates and manages implementation tasks from PRD documents
  */
 export declare class TaskManager {
-    private readonly optimizer;
     constructor();
     /**
      * Generate tasks.md from PRD

package/dist/core/task-manager.js

@@ -3,14 +3,13 @@
  *
  * This class handles:
  * - Analyzing PRD documents
- * - Generating CLEAR-optimized task breakdowns
+ * - Generating optimized task breakdowns
  * - Reading/writing tasks.md with checkbox format
  * - Tracking task completion state
  * - Managing session resume capability
  */
 import fs from 'fs-extra';
 import * as path from 'path';
-import { PromptOptimizer } from './prompt-optimizer.js';
 import { FileSystem } from '../utils/file-system.js';
 const SOURCE_FILE_MAP = {
     full: ['full-prd.md', 'PRD.md', 'prd.md', 'Full-PRD.md', 'FULL_PRD.md', 'FULL-PRD.md'],
@@ -18,7 +17,12 @@ const SOURCE_FILE_MAP = {
     mini: ['mini-prd.md'],
     prompt: ['optimized-prompt.md'],
 };
-const SOURCE_ORDER_AUTO = ['full', 'quick', 'mini', 'prompt'];
+const SOURCE_ORDER_AUTO = [
+    'full',
+    'quick',
+    'mini',
+    'prompt',
+];
 const ALL_KNOWN_PRD_FILES = Array.from(new Set(Object.values(SOURCE_FILE_MAP).flat()));
 /**
  * TaskManager class
@@ -26,9 +30,8 @@ const ALL_KNOWN_PRD_FILES = Array.from(new Set(Object.values(SOURCE_FILE_MAP).fl
  * Generates and manages implementation tasks from PRD documents
  */
 export class TaskManager {
-    optimizer;
     constructor() {
-        this.optimizer = new PromptOptimizer();
+        // TaskManager uses Clavix Intelligence for optimization
     }
     /**
      * Generate tasks.md from PRD
@@ -184,7 +187,7 @@ export class TaskManager {
             'Configuration & Setup': [],
             'Core Implementation': [],
             'Testing & Validation': [],
-            'Documentation': [],
+            Documentation: [],
             'Integration & Release': [],
         };
         features.forEach((feature) => {
@@ -235,7 +238,9 @@ export class TaskManager {
             if (topLevelMatch) {
                 const value = topLevelMatch[1].trim();
                 // Skip items that look like code examples, file paths, or implementation details
-                if (value && !this.looksLikeCodeOrPath(value) && !this.looksLikeImplementationDetail(value)) {
+                if (value &&
+                    !this.looksLikeCodeOrPath(value) &&
+                    !this.looksLikeImplementationDetail(value)) {
                     items.push(value.replace(/\s+/g, ' ').replace(/\.$/, ''));
                 }
             }
@@ -311,17 +316,11 @@ export class TaskManager {
         }
         // Conversion/migration tasks - Convert + test
         if (isConversion) {
-            return [
-                this.convertBehaviorToTask(feature),
-                `Test ${formattedFeature} works correctly`,
-            ];
+            return [this.convertBehaviorToTask(feature), `Test ${formattedFeature} works correctly`];
         }
         // Default for complex features - Implementation + testing only
         // (No more "integrate into end-to-end" boilerplate)
-        return [
-            this.convertBehaviorToTask(feature),
-            `Add tests covering ${formattedFeature}`,
-        ];
+        return [this.convertBehaviorToTask(feature), `Add tests covering ${formattedFeature}`];
     }
     formatInlineText(text) {
         if (!text) {
@@ -446,9 +445,7 @@ export class TaskManager {
                 const featureName = featureHeaders[i][2].trim();
                 // Extract content between this header and the next one
                 const startIndex = featureHeaders[i].index;
-                const endIndex = i < featureHeaders.length - 1
-                    ? featureHeaders[i + 1].index
-                    : featuresContent.length;
+                const endIndex = i < featureHeaders.length - 1 ? featureHeaders[i + 1].index : featuresContent.length;
                 const featureContent = featuresContent.substring(startIndex, endIndex);
                 // Extract behavior points using hierarchical parsing
                 const behaviorMatch = featureContent.match(/\*\*Behavior\*\*:([\s\S]*?)(?=\*\*|####|$)/);
@@ -740,9 +737,7 @@ export class TaskManager {
         const content = await fs.readFile(tasksPath, 'utf-8');
         // Find the task line and replace [ ] with [x]
         // We need to find the exact task by description
-        const targetTask = phases
-            .flatMap((p) => p.tasks)
-            .find((t) => t.id === taskId);
+        const targetTask = phases.flatMap((p) => p.tasks).find((t) => t.id === taskId);
         if (!targetTask) {
             throw new Error(`Task not found: ${taskId}`);
         }
@@ -769,7 +764,7 @@ export class TaskManager {
      */
     validateTaskExists(phases, taskId) {
         for (const phase of phases) {
-            const task = phase.tasks.find(t => t.id === taskId);
+            const task = phase.tasks.find((t) => t.id === taskId);
             if (task) {
                 return task;
             }
@@ -828,7 +823,7 @@ export class TaskManager {
             const task = this.validateTaskExists(phases, taskId);
             if (!task) {
                 // Task not found - provide helpful error
-                const allTaskIds = phases.flatMap(p => p.tasks.map(t => t.id));
+                const allTaskIds = phases.flatMap((p) => p.tasks.map((t) => t.id));
                 return {
                     success: false,
                     error: `Task ID "${taskId}" not found. Available task IDs:\n${allTaskIds.join('\n')}`,
@@ -876,7 +871,7 @@ export class TaskManager {
                 }
             }
             // Clean up backup on success
-            if (backupPath && await fs.pathExists(backupPath)) {
+            if (backupPath && (await fs.pathExists(backupPath))) {
                 await fs.remove(backupPath);
             }
             return {
@@ -886,7 +881,7 @@ export class TaskManager {
         }
         catch (error) {
             // Restore from backup if available
-            if (backupPath && await fs.pathExists(backupPath)) {
+            if (backupPath && (await fs.pathExists(backupPath))) {
                 try {
                     await fs.copyFile(backupPath, tasksPath);
                     warnings.push('Restored tasks.md from backup due to error');
@@ -919,7 +914,7 @@ export class TaskManager {
      */
     async findPrdDirectory(projectName) {
         const baseDir = '.clavix/outputs';
-        if (!await fs.pathExists(baseDir)) {
+        if (!(await fs.pathExists(baseDir))) {
             throw new Error('No .clavix/outputs directory found. Have you generated a PRD yet?');
         }
         // If project name specified, look for it

package/dist/templates/slash-commands/_canonical/deep.md

@@ -33,17 +33,35 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 
 ## Self-Correction Protocol
 
-**DETECT**: If you find yourself:
-- Writing function/class definitions for the user's feature
-- Creating component implementations
-- Generating API endpoint code
+**DETECT**: If you find yourself doing any of these 6 mistake types:
 
-**STOP**: Immediately halt code generation
+| Type | What It Looks Like |
+|------|--------------------|
+| 1. Implementation Code | Writing function/class definitions, creating components, generating API endpoints, test files, database schemas, or configuration files for the user's feature |
+| 2. Skipping Quality Assessment | Not scoring all 6 dimensions, providing analysis without showing dimension breakdown |
+| 3. Missing Alternatives | Not generating 2-3 alternative approaches in deep mode |
+| 4. Missing Validation Checklist | Not creating verification checklist for implementation |
+| 5. Missing Edge Cases | Not identifying potential edge cases and failure modes |
+| 6. Capability Hallucination | Claiming features Clavix doesn't have, inventing pattern names |
+
+**STOP**: Immediately halt the incorrect action
 
 **CORRECT**: Output:
-"I apologize - I was implementing instead of analyzing. Let me return to deep prompt analysis."
+"I apologize - I was [describe mistake]. Let me return to deep prompt analysis."
+
+**RESUME**: Return to the deep prompt analysis workflow with all required outputs.
+
+---
 
-**RESUME**: Return to the deep prompt analysis workflow.
+## State Assertion (Required)
+
+**Before starting analysis, output:**
+```
+**CLAVIX MODE: Deep Analysis**
+Mode: planning
+Purpose: Comprehensive prompt analysis with alternatives, edge cases, and validation
+Implementation: BLOCKED - I will analyze the prompt thoroughly, not implement it
+```
 
 ---
 
@@ -53,7 +71,7 @@ Deep mode provides **Clavix Intelligence™** with comprehensive analysis that g
 
 **Deep Mode Features:**
 - **Intent Detection**: Identifies what you're trying to achieve
-- **Quality Assessment**: 5-dimension deep analysis (Clarity, Efficiency, Structure, Completeness, Actionability)
+- **Quality Assessment**: 6-dimension deep analysis (Clarity, Efficiency, Structure, Completeness, Actionability, Specificity)
 - **Advanced Optimization**: Applies all available patterns
 - **Alternative Approaches**: Multiple ways to phrase and structure your prompt
 - **Edge Case Analysis**: Identifies potential issues and failure modes
@@ -71,6 +89,10 @@ Deep mode provides **Clavix Intelligence™** with comprehensive analysis that g
    - **debugging**: Finding and fixing issues
    - **documentation**: Creating docs or explanations
    - **prd-generation**: Creating requirements documents
+   - **testing**: Writing tests, improving test coverage
+   - **migration**: Version upgrades, porting code between frameworks
+   - **security-review**: Security audits, vulnerability checks
+   - **learning**: Conceptual understanding, tutorials, explanations
 
 3. **Strategic Scope Detection** (before detailed analysis):
 
@@ -88,13 +110,14 @@ Deep mode provides **Clavix Intelligence™** with comprehensive analysis that g
 
    **If user chooses to continue**, proceed with deep analysis but remind them at the end that `/clavix:prd` is available for strategic planning.
 
-4. **Comprehensive Quality Assessment** - Evaluate across 5 dimensions:
+4. **Comprehensive Quality Assessment** - Evaluate across 6 dimensions:
 
    - **Clarity**: Is the objective clear and unambiguous?
    - **Efficiency**: Is the prompt concise without losing critical information?
    - **Structure**: Is information organized logically?
    - **Completeness**: Are all necessary details provided?
    - **Actionability**: Can AI take immediate action on this prompt?
+   - **Specificity**: How concrete and precise is the prompt? (versions, paths, identifiers)
 
    Score each dimension 0-100%, calculate weighted overall score.
 
@@ -102,24 +125,18 @@ Deep mode provides **Clavix Intelligence™** with comprehensive analysis that g
 
    a. **Intent Analysis** (type, confidence, characteristics)
 
-   b. **Quality Assessment** (5 dimensions with detailed feedback)
+   b. **Quality Assessment** (6 dimensions with detailed feedback)
 
    c. **Optimized Prompt** (applying all patterns)
 
    d. **Improvements Applied** (labeled with quality dimensions)
 
-   e. **Alternative Approaches**:
-      - 2-3 different ways to phrase the request
-      - Alternative structures (user story, job story, structured sections)
-      - When each approach is most appropriate
-      - Temperature/model recommendations
+   e. **Alternative Approaches** (generated by AlternativePhrasingGenerator pattern):
+      - 2-3 different ways to approach the request
+      - Each approach with title, description, and "best for" context
+      - Intent-specific alternatives (e.g., Functional Decomposition for code, Top-Down Design for planning)
 
-   f. **Alternative Structures**:
-      - **Step-by-step**: Break into sequential steps
-      - **Template-based**: Provide code/document template to fill
-      - **Example-driven**: Show concrete examples of desired output
-
-   g. **Validation Checklist**:
+   f. **Validation Checklist** (generated by ValidationChecklistCreator pattern):
       - Steps to verify accuracy
       - Requirements match checks
       - Edge case handling verification
@@ -127,7 +144,7 @@ Deep mode provides **Clavix Intelligence™** with comprehensive analysis that g
       - Output format validation
       - Performance considerations
 
-   h. **Edge Cases to Consider**:
+   g. **Edge Cases to Consider** (generated by EdgeCaseIdentifier pattern):
       - Intent-specific edge cases
       - Error conditions and recovery
       - Unexpected inputs or behavior
@@ -146,12 +163,11 @@ Deep mode provides **Clavix Intelligence™** with comprehensive analysis that g
 
 **Include:**
 - **Intent Detection**: Automatic classification with confidence
-- **Quality Assessment**: All 5 dimensions with detailed analysis
+- **Quality Assessment**: All 6 dimensions with detailed analysis
 - **Advanced Optimization**: All applicable patterns
-- **Alternative Approaches**: Multiple phrasings and perspectives
-- **Alternative Structures**: Different organization approaches
-- **Validation Checklist**: Steps to verify completion
-- **Edge Case Analysis**: Potential issues and failure modes
+- **Alternative Approaches**: Multiple approaches (generated by AlternativePhrasingGenerator pattern)
+- **Validation Checklist**: Steps to verify completion (generated by ValidationChecklistCreator pattern)
+- **Edge Case Analysis**: Potential issues and failure modes (generated by EdgeCaseIdentifier pattern)
 - **Risk Assessment**: "What could go wrong" analysis
 
 **Do NOT include (these belong in `/clavix:prd`):**
@@ -180,6 +196,9 @@ Deep mode has access to all patterns including deep-exclusive patterns:
 - **ValidationChecklistCreator**: Creates implementation verification checklist
 - **AssumptionExplicitizer**: Makes implicit assumptions explicit
 - **ScopeDefiner**: Adds explicit scope boundaries
+- **PRDStructureEnforcer**: Ensures PRD completeness (PRD mode only)
+- **ErrorToleranceEnhancer**: Adds error handling requirements
+- **PrerequisiteIdentifier**: Identifies prerequisites and dependencies
 
 ---
 
@@ -264,66 +283,40 @@ Success Criteria:
 [Completeness] Added tech stack (React/TypeScript), API endpoint, accessibility standards, testing requirements
 [Actionability] Converted vague request into specific, measurable implementation requirements
 
-### Alternative Approaches:
+### Alternative Approaches
 
-1. **Functional Decomposition**: "Build a React login component that: (1) validates email/password inputs, (2) calls JWT auth API, (3) handles errors gracefully, (4) manages session persistence"
+**1. Functional Decomposition**
+   Break down into discrete functions with clear interfaces
    → Best for: Step-by-step implementation, clarity on sequence
 
-2. **User-Centric**: "As a user, I need to log into my account securely using email/password, with clear feedback if credentials are invalid"
-   → Best for: Emphasizing user experience and value
-
-3. **Example-Driven**: "Create a login page similar to [reference], with email/password fields, validation, and integration with our JWT API"
-   → Best for: When you have a reference implementation
-
-### Alternative Structures:
+**2. Test-Driven Approach**
+   Define expected behavior through tests first
+   → Best for: When requirements are clear and testable
 
-**Step-by-step approach:**
-1. Create form with email/password inputs and validation
-2. Implement API integration with JWT endpoint
-3. Add error handling and user feedback
-4. Implement "remember me" and "forgot password" features
-5. Add accessibility and responsive design
-6. Write tests and documentation
+**3. Example-Driven**
+   Provide concrete input/output examples
+   → Best for: When you have reference implementations
 
-**Template-based approach:**
-Provide a component template with:
-- Form structure with input fields
-- Validation logic placeholders
-- API call hooks
-- Error state management
-- Accessibility attributes
-
-**Example-driven approach:**
-Show concrete examples of:
-- Login form HTML structure
-- Validation error messages
-- Success/failure API responses
-- Loading and error states
-
-### Validation Checklist:
+### Validation Checklist
 
 Before considering this task complete, verify:
-☐ Email and password fields validate input correctly
-☐ Invalid credentials show appropriate, user-friendly error messages
-☐ Successful login redirects to correct page or updates auth state
-☐ "Remember me" persists session across browser sessions
-☐ "Forgot password" link navigates to password reset flow
-☐ Form is keyboard accessible (tab navigation, enter to submit)
-☐ Screen readers announce errors and state changes
-☐ Loading state prevents duplicate submissions
-☐ Component renders correctly on mobile and desktop
-☐ Unit tests cover success, failure, and edge cases (>80% coverage)
-
-### Edge Cases to Consider:
-
-• **Empty or invalid inputs**: How to handle blank email, malformed email, empty password?
-• **API failures**: What happens if auth API is down or times out?
-• **Slow network**: How to indicate loading state and prevent double-submission?
-• **Expired sessions**: How to handle JWT expiration during login attempt?
-• **Account locked**: What if user account is temporarily locked after failed attempts?
-• **Password reset in progress**: How to handle user who requested reset but tries to login?
-• **Browser autofill**: Does component work correctly with password managers?
-• **Concurrent logins**: What happens if user logs in on multiple devices?
+
+☐ Code compiles/runs without errors
+☐ All requirements from prompt are implemented
+☐ Edge cases are handled gracefully
+☐ UI renders correctly on different screen sizes
+☐ Keyboard navigation works correctly
+☐ Code follows project conventions/style guide
+☐ No console errors or warnings
+☐ Documentation updated if needed
+
+### Edge Cases to Consider
+
+• **Boundary conditions**: What happens at min/max values, empty collections, or single items?
+• **Empty or null inputs**: How should the system handle missing or undefined values?
+• **Invalid input types**: What happens if input is wrong type (string vs number)?
+• **Network failures**: How to handle timeouts, connection errors, and retries?
+• **Session expiration**: What happens when user session expires mid-operation?
 
 ### What Could Go Wrong:
 

package/dist/templates/slash-commands/_canonical/fast.md

@@ -32,17 +32,35 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 
 ## Self-Correction Protocol
 
-**DETECT**: If you find yourself:
-- Writing function/class definitions for the user's feature
-- Creating component implementations
-- Generating API endpoint code
+**DETECT**: If you find yourself doing any of these 6 mistake types:
 
-**STOP**: Immediately halt code generation
+| Type | What It Looks Like |
+|------|--------------------|
+| 1. Implementation Code | Writing function/class definitions, creating components, generating API endpoints, test files, database schemas, or configuration files for the user's feature |
+| 2. Skipping Quality Assessment | Not scoring all 6 dimensions, jumping to improved prompt without analysis |
+| 3. Wrong Mode Selection | Not suggesting `/clavix:deep` when quality <65% or escalation factors present |
+| 4. Incomplete Pattern Application | Not showing which patterns were applied, skipping patterns without explanation |
+| 5. Missing Triage | Not evaluating if deep mode is needed, ignoring secondary indicators |
+| 6. Capability Hallucination | Claiming features Clavix doesn't have, inventing pattern names |
+
+**STOP**: Immediately halt the incorrect action
 
 **CORRECT**: Output:
-"I apologize - I was implementing instead of optimizing the prompt. Let me return to prompt optimization."
+"I apologize - I was [describe mistake]. Let me return to prompt optimization."
+
+**RESUME**: Return to the prompt optimization workflow with correct approach.
+
+---
 
-**RESUME**: Return to the prompt optimization workflow.
+## State Assertion (Required)
+
+**Before starting analysis, output:**
+```
+**CLAVIX MODE: Fast Optimization**
+Mode: planning
+Purpose: Optimizing user prompt with Clavix Intelligence™
+Implementation: BLOCKED - I will analyze and improve the prompt, not implement it
+```
 
 ---
 
@@ -52,7 +70,7 @@ Clavix provides **Clavix Intelligence™** that automatically detects intent and
 
 **Fast Mode Features:**
 - **Intent Detection**: Automatically identifies what you're trying to achieve
-- **Quality Assessment**: 5-dimension analysis (Clarity, Efficiency, Structure, Completeness, Actionability)
+- **Quality Assessment**: 6-dimension analysis (Clarity, Efficiency, Structure, Completeness, Actionability, Specificity)
 - **Smart Optimization**: Applies proven patterns based on your intent
 - **Intelligent Triage**: Recommends deep mode when comprehensive analysis would help
 
@@ -69,14 +87,19 @@ Clavix provides **Clavix Intelligence™** that automatically detects intent and
    - **debugging**: Finding and fixing issues
    - **documentation**: Creating docs or explanations
    - **prd-generation**: Creating requirements documents
+   - **testing**: Writing tests, improving test coverage
+   - **migration**: Version upgrades, porting code between frameworks
+   - **security-review**: Security audits, vulnerability checks
+   - **learning**: Conceptual understanding, tutorials, explanations
 
-3. **Quality Assessment** - Evaluate across 5 dimensions:
+3. **Quality Assessment** - Evaluate across 6 dimensions:
 
    - **Clarity**: Is the objective clear and unambiguous?
    - **Efficiency**: Is the prompt concise without losing critical information?
    - **Structure**: Is information organized logically?
    - **Completeness**: Are all necessary details provided?
    - **Actionability**: Can AI take immediate action on this prompt?
+   - **Specificity**: How concrete and precise is the prompt? (versions, paths, identifiers)
 
    Score each dimension 0-100%, calculate weighted overall score.