clavix 4.11.2 → 4.12.0

package/README.md

@@ -1,5 +1,5 @@
 # Clavix
-> **Clavix Intelligence™** for AI coding. Transform rough ideas into production-ready prompts with automatic quality optimization—no framework to learn.
+> Prompt optimization for AI coding. Transform rough ideas into structured, actionable prompts using pattern-based analysis—no framework to learn.
 
 ## Table of contents
 - [Why Clavix?](#why-clavix)
@@ -20,24 +20,26 @@
 **Requirements:** Node.js ≥ 16.0.0 (ESM support required)
 
 ## Why Clavix?
-Better prompts lead to better code. Clavix automatically detects what you're trying to do and applies the right optimization patterns—no framework to learn, no methodology to master. Just describe what you want, and Clavix makes it AI-ready.
+Better prompts lead to better code. Clavix analyzes what you're trying to do and applies structured optimization patterns—no framework to learn, no methodology to master. Just describe what you want, and Clavix structures it for AI consumption.
 
-**What makes Clavix v3.0 unique:**
-- **95%+ Intent Detection Accuracy** - Weighted keyword scoring, phrase-based detection, and negation handling
-- **6 Production-Ready Optimization Patterns** - Automatically applied based on intent and quality assessment
-- **Zero Learning Curve** - Works with your natural language, adapts to your style
-- **Universal Integration** - Supports 20+ AI coding assistants with native slash commands
+**What Clavix provides:**
+- **Pattern-based intent detection** - Weighted keyword scoring across 11 intent categories
+- **20 optimization patterns** - Automatically applied based on intent and quality assessment
+- **Workflow management** - PRD generation, task breakdown, and implementation tracking
+- **Universal integration** - Supports 20+ AI coding assistants with native slash commands
 
 Learn more in [docs/why-clavix.md](docs/why-clavix.md).
 
 ## How It Works
-Clavix uses **Clavix Intelligence™** (v3.0+) to automatically:
-- **Detect intent** - 95%+ accuracy with weighted scoring, phrase detection, and context analysis
-- **Assess quality** - Evaluates across 5 dimensions: Clarity, Efficiency, Structure, Completeness, Actionability
-- **Apply patterns** - 6 optimization patterns automatically selected and prioritized for your specific need
-- **Generate output** - Production-ready prompts optimized for AI coding assistants
+Clavix uses pattern-based analysis to:
+- **Detect intent** - Keyword scoring and phrase detection across 11 intent categories
+- **Assess quality** - Heuristic scoring across 6 dimensions: Clarity, Efficiency, Structure, Completeness, Actionability, Specificity
+- **Apply patterns** - 20 optimization patterns automatically selected based on intent and quality
+- **Generate output** - Structured prompts optimized for AI coding assistants
 
-**The magic happens automatically**—no frameworks to learn, no manual analysis required. Just describe what you want in plain language, and Clavix transforms it into an AI-ready prompt using battle-tested optimization patterns.
+Optimization applies automatically—no frameworks to learn, no manual analysis required. Just describe what you want in plain language, and Clavix structures it into an AI-ready prompt.
+
+See [docs/philosophy.md](docs/philosophy.md) for an honest look at what Clavix is and isn't.
 
 ## Providers
 
@@ -55,11 +57,12 @@ Provider paths and argument placeholders are listed in [docs/integrations.md](do
 
 Most Clavix users work through AI coding assistants:
 
-> **💡 Choosing Your Mode:**
-> - **Fast/Deep** – Modifying or improving existing features
-> - **PRD** – Developing something completely new
+> **💡 Choosing Your Workflow:**
+> - **Improve** – Optimize a single prompt (auto-selects depth)
+> - **PRD** – Plan something new with guided questions
+> - **Start** – Explore ideas conversationally
 >
-> See [Choosing the Right Mode](docs/guides/workflows.md#choosing-the-right-mode) for detailed guidance.
+> See [Choosing the Right Workflow](docs/guides/choosing-workflow.md) for detailed guidance.
 
 ```bash
 # 1. Initialize in your project
@@ -67,23 +70,23 @@ npm install -g clavix
 clavix init
 
 # 2. Use slash commands in your AI agent
-/clavix:fast "Create a login page"
-/clavix:deep "Build an API for user management"
-/clavix:prd  # Full PRD workflow
+/clavix:improve "Create a login page"     # Optimize a prompt
+/clavix:prd                                # Full PRD workflow
+/clavix:start                              # Conversational exploration
 
 # 3. Manage saved prompts
 /clavix:execute  # Execute saved prompts
-/clavix:prompts  # Manage prompt lifecycle
+/clavix:verify   # Verify implementation against checklist
 
 # 4. Implement with task tracking
-clavix plan              # Generate tasks from PRD
-clavix implement         # Start implementation workflow
+/clavix:plan              # Generate tasks from PRD
+/clavix:implement         # Start implementation workflow
 clavix task-complete <taskId>  # Mark tasks done with auto-commit
 ```
 
 **Supported agents**: Claude Code, Cursor, Windsurf, and [17+ more providers](docs/integrations.md)
 
-Learn more: [Complete prompt lifecycle documentation](docs/commands/execute.md)
+Learn more: [Workflow guide](docs/guides/choosing-workflow.md)
 
 ### Direct CLI Usage (Alternative)
 
@@ -91,8 +94,8 @@ You can also use Clavix directly from the terminal:
 
 ```bash
 clavix init
-clavix fast "Create a login page"
-clavix deep "Build an API for user management"
+clavix improve "Create a login page"           # Auto-selects depth
+clavix improve --comprehensive "Complex API"   # Force comprehensive
 clavix prd
 ```
 
@@ -100,7 +103,8 @@ clavix prd
 - Overview & navigation: [docs/README.md](docs/README.md)
 - Command reference: [docs/commands/](docs/commands/README.md)
 - Providers: [docs/integrations.md](docs/integrations.md)
-- Clavix Intelligence: [docs/clavix-intelligence.md](docs/clavix-intelligence.md)
+- How it works: [docs/how-it-works.md](docs/how-it-works.md)
+- Philosophy: [docs/philosophy.md](docs/philosophy.md)
 - Guides: [docs/guides/](docs/guides/workflows.md)
 
 ## Requirements

package/dist/cli/commands/update.js

@@ -216,25 +216,24 @@ export default class Update extends Command {
 This project uses Clavix for prompt improvement and PRD generation.
 
 ### Available Commands
+- \`clavix improve [prompt]\` - Unified prompt optimization with auto-depth selection
+- \`clavix improve --comprehensive [prompt]\` - Force comprehensive analysis
+- \`clavix improve --standard [prompt]\` - Force standard optimization
+- \`clavix analyze [prompt]\` - JSON analysis output for programmatic use
 - \`clavix prd\` - Generate a comprehensive PRD through guided questions
-- \`clavix fast [prompt]\` - Quick prompt improvements with smart triage
-- \`clavix deep [prompt]\` - Comprehensive prompt analysis
 - \`clavix start\` - Start a conversational session for iterative development
 - \`clavix summarize\` - Extract requirements from conversation history
-- \`clavix list\` - List all sessions and outputs
-- \`clavix show [session-id]\` - Show detailed session information
+- \`clavix execute [--latest]\` - Execute saved prompts
+- \`clavix verify [--latest]\` - Verify implementation against checklist
 
 ### Quick Start
 \`\`\`bash
+# Prompt optimization (auto-selects depth)
+clavix improve "Build a user auth system"
+
 # Generate a PRD
 clavix prd
 
-# Quick prompt improvement
-clavix fast "Build a user auth system"
-
-# Deep prompt analysis
-clavix deep "Build a user auth system"
-
 # Start conversational mode
 clavix start
 \`\`\`

package/dist/core/intelligence/pattern-library.js

@@ -5,11 +5,9 @@ import { StructureOrganizer } from './patterns/structure-organizer.js';
 import { CompletenessValidator } from './patterns/completeness-validator.js';
 import { ActionabilityEnhancer } from './patterns/actionability-enhancer.js';
 // v4.0 Comprehensive scope patterns
-import { AlternativePhrasingGenerator } from './patterns/alternative-phrasing-generator.js';
-import { EdgeCaseIdentifier } from './patterns/edge-case-identifier.js';
-import { ValidationChecklistCreator } from './patterns/validation-checklist-creator.js';
-import { AssumptionExplicitizer } from './patterns/assumption-explicitizer.js';
-import { ScopeDefiner } from './patterns/scope-definer.js';
+// v4.12: Removed boilerplate patterns (AlternativePhrasingGenerator, EdgeCaseIdentifier,
+//        ValidationChecklistCreator, AssumptionExplicitizer, ScopeDefiner, ErrorToleranceEnhancer,
+//        PrerequisiteIdentifier) - these generated static output instead of improving prompts
 import { PRDStructureEnforcer } from './patterns/prd-structure-enforcer.js';
 // v4.0 Both scope patterns (standard & comprehensive)
 import { StepDecomposer } from './patterns/step-decomposer.js';
@@ -18,8 +16,6 @@ import { ContextPrecisionBooster } from './patterns/context-precision.js';
 import { AmbiguityDetector } from './patterns/ambiguity-detector.js';
 import { OutputFormatEnforcer } from './patterns/output-format-enforcer.js';
 import { SuccessCriteriaEnforcer } from './patterns/success-criteria-enforcer.js';
-import { ErrorToleranceEnhancer } from './patterns/error-tolerance-enhancer.js';
-import { PrerequisiteIdentifier } from './patterns/prerequisite-identifier.js';
 import { DomainContextEnricher } from './patterns/domain-context-enricher.js';
 // v4.3.2 PRD patterns
 import { RequirementPrioritizer } from './patterns/requirement-prioritizer.js';
@@ -73,29 +69,24 @@ export class PatternLibrary {
     }
     registerDefaultPatterns() {
         // Register core patterns (available in standard & comprehensive scopes)
-        this.register(new ConcisenessFilter()); // HIGH - Remove verbosity
-        this.register(new ObjectiveClarifier()); // HIGH - Add clarity
-        this.register(new TechnicalContextEnricher()); // MEDIUM - Add technical details
-        this.register(new StructureOrganizer()); // HIGH - Reorder logically
-        this.register(new CompletenessValidator()); // MEDIUM - Check missing elements
-        this.register(new ActionabilityEnhancer()); // HIGH - Vague to specific
+        // v4.12: 20 patterns total after removing 7 boilerplate patterns
+        this.register(new ConcisenessFilter()); // P10 - Remove verbosity
+        this.register(new ObjectiveClarifier()); // P9 - Add clarity
+        this.register(new TechnicalContextEnricher()); // P8 - Add technical details
+        this.register(new StructureOrganizer()); // P8 - Reorder logically
+        this.register(new CompletenessValidator()); // P6 - Check missing elements
+        this.register(new ActionabilityEnhancer()); // P7 - Vague to specific
         // v4.0 Comprehensive scope patterns
-        this.register(new AlternativePhrasingGenerator()); // P5 - Generate alternative structures
-        this.register(new EdgeCaseIdentifier()); // P4 - Identify edge cases by domain
-        this.register(new ValidationChecklistCreator()); // P3 - Create validation checklists
-        this.register(new AssumptionExplicitizer()); // P6 - Make implicit assumptions explicit
-        this.register(new ScopeDefiner()); // P5 - Add scope boundaries
+        // v4.12: Removed boilerplate patterns that generated static output
         this.register(new PRDStructureEnforcer()); // P9 - Ensure PRD completeness
         // v4.0 Both scope patterns (standard & comprehensive)
         this.register(new StepDecomposer()); // P7 - Break complex prompts into steps
         this.register(new ContextPrecisionBooster()); // P8 - Add precise context when missing
         // v4.1 New patterns - Agent transparency & quality improvements
         this.register(new AmbiguityDetector()); // P9 - Identify ambiguous terms (both scopes)
-        this.register(new OutputFormatEnforcer()); // P7 - Add output format specs (both scopes)
+        this.register(new OutputFormatEnforcer()); // P7 - Add output format specs (comprehensive only)
         this.register(new SuccessCriteriaEnforcer()); // P6 - Add success criteria (both scopes)
-        this.register(new ErrorToleranceEnhancer()); // P5 - Add error handling (comprehensive only)
-        this.register(new PrerequisiteIdentifier()); // P6 - Identify prerequisites (comprehensive only)
-        this.register(new DomainContextEnricher()); // P5 - Add domain best practices (both scopes)
+        this.register(new DomainContextEnricher()); // P5 - Add domain best practices (comprehensive only)
         // v4.3.2 PRD patterns
         this.register(new RequirementPrioritizer()); // P7 - Separate must-have from nice-to-have
         this.register(new UserPersonaEnricher()); // P6 - Add user context and personas

package/dist/core/intelligence/quality-assessor.d.ts

@@ -30,6 +30,26 @@ export declare class QualityAssessor {
      * Penalizes vague language, rewards concrete indicators
      */
     private assessSpecificity;
+    /**
+     * Calculate weighted overall quality score
+     * v4.12: Added comprehensive weight documentation
+     *
+     * WEIGHT RATIONALE:
+     * Weights are designed based on what matters most for each intent type:
+     *
+     * | Intent | Primary Focus | Secondary Focus | Rationale |
+     * |--------|---------------|-----------------|-----------|
+     * | code-generation | completeness (25%) | clarity, actionability (20% each) | Code needs full specs |
+     * | planning | structure, completeness (25% each) | clarity (20%) | Plans need organization |
+     * | debugging | actionability, completeness (25% each) | specificity (20%) | Need steps to reproduce |
+     * | migration | specificity, completeness (25% each) | clarity (20%) | Version/path precision |
+     * | testing | completeness (25%) | specificity, actionability (20% each) | Edge cases matter |
+     * | security-review | completeness (25%) | specificity, clarity (20% each) | Thorough coverage |
+     * | learning | clarity (30%) | structure, completeness (20% each) | Understanding > action |
+     * | default | completeness (22%) | clarity, structure, actionability (18% each) | Balanced |
+     *
+     * These weights can be overridden via ClavixConfig.intelligence.qualityWeights
+     */
     private calculateOverall;
     private identifyStrengths;
     private identifyImprovements;

package/dist/core/intelligence/quality-assessor.js

@@ -292,8 +292,28 @@ export class QualityAssessor {
         }
         return Math.max(0, Math.min(100, score));
     }
+    /**
+     * Calculate weighted overall quality score
+     * v4.12: Added comprehensive weight documentation
+     *
+     * WEIGHT RATIONALE:
+     * Weights are designed based on what matters most for each intent type:
+     *
+     * | Intent | Primary Focus | Secondary Focus | Rationale |
+     * |--------|---------------|-----------------|-----------|
+     * | code-generation | completeness (25%) | clarity, actionability (20% each) | Code needs full specs |
+     * | planning | structure, completeness (25% each) | clarity (20%) | Plans need organization |
+     * | debugging | actionability, completeness (25% each) | specificity (20%) | Need steps to reproduce |
+     * | migration | specificity, completeness (25% each) | clarity (20%) | Version/path precision |
+     * | testing | completeness (25%) | specificity, actionability (20% each) | Edge cases matter |
+     * | security-review | completeness (25%) | specificity, clarity (20% each) | Thorough coverage |
+     * | learning | clarity (30%) | structure, completeness (20% each) | Understanding > action |
+     * | default | completeness (22%) | clarity, structure, actionability (18% each) | Balanced |
+     *
+     * These weights can be overridden via ClavixConfig.intelligence.qualityWeights
+     */
     calculateOverall(scores, intent) {
-        // v4.0: Intent-specific weights including specificity
+        // v4.0: Intent-specific weights (see rationale in method comment above)
         if (intent.primaryIntent === 'code-generation') {
             // Code generation benefits most from specificity
             return (scores.clarity * 0.2 +

package/dist/core/intelligence/universal-optimizer.d.ts

@@ -2,6 +2,7 @@ import { IntentDetector } from './intent-detector.js';
 import { PatternLibrary } from './pattern-library.js';
 import { QualityAssessor } from './quality-assessor.js';
 import { OptimizationResult, OptimizationMode, OptimizationPhase, DocumentType, EscalationAnalysis, DepthLevel } from './types.js';
+import { EscalationThresholdsConfig } from '../../types/config.js';
 /**
  * v4.11: Extended context options for optimization modes
  */
@@ -16,7 +17,12 @@ export declare class UniversalOptimizer {
     private intentDetector;
     private patternLibrary;
     private qualityAssessor;
-    constructor(intentDetector?: IntentDetector, patternLibrary?: PatternLibrary, qualityAssessor?: QualityAssessor);
+    private thresholds;
+    constructor(intentDetector?: IntentDetector, patternLibrary?: PatternLibrary, qualityAssessor?: QualityAssessor, escalationConfig?: EscalationThresholdsConfig);
+    /**
+     * v4.12: Get current threshold configuration
+     */
+    getThresholds(): Required<EscalationThresholdsConfig>;
     /**
      * v4.11: Optimize a prompt using Clavix Intelligence
      * @param prompt The prompt to optimize
@@ -49,6 +55,7 @@ export declare class UniversalOptimizer {
     /**
      * v4.11: Analyze whether to escalate from standard to comprehensive depth
      * Uses multi-factor scoring for intelligent triage decisions
+     * v4.12: Uses configurable thresholds from EscalationThresholdsConfig
      *
      * IMPORTANT: Quality checks use the ORIGINAL prompt, not the enhanced one,
      * because triage decisions should be based on what the user wrote.

package/dist/core/intelligence/universal-optimizer.js

@@ -1,14 +1,34 @@
 import { IntentDetector } from './intent-detector.js';
 import { PatternLibrary } from './pattern-library.js';
 import { QualityAssessor } from './quality-assessor.js';
+/**
+ * v4.12: Default escalation thresholds
+ * These can be overridden via ClavixConfig.intelligence.escalation
+ */
+const DEFAULT_THRESHOLDS = {
+    comprehensiveAbove: 75,
+    standardFloor: 60,
+    intentConfidenceMin: 50,
+    strongRecommendAbove: 75,
+    suggestAbove: 45,
+};
 export class UniversalOptimizer {
     intentDetector;
     patternLibrary;
     qualityAssessor;
-    constructor(intentDetector, patternLibrary, qualityAssessor) {
+    thresholds;
+    constructor(intentDetector, patternLibrary, qualityAssessor, escalationConfig) {
         this.intentDetector = intentDetector || new IntentDetector();
         this.patternLibrary = patternLibrary || new PatternLibrary();
         this.qualityAssessor = qualityAssessor || new QualityAssessor();
+        // v4.12: Merge user config with defaults
+        this.thresholds = { ...DEFAULT_THRESHOLDS, ...escalationConfig };
+    }
+    /**
+     * v4.12: Get current threshold configuration
+     */
+    getThresholds() {
+        return { ...this.thresholds };
     }
     /**
      * v4.11: Optimize a prompt using Clavix Intelligence
@@ -143,6 +163,7 @@ export class UniversalOptimizer {
     /**
      * v4.11: Analyze whether to escalate from standard to comprehensive depth
      * Uses multi-factor scoring for intelligent triage decisions
+     * v4.12: Uses configurable thresholds from EscalationThresholdsConfig
      *
      * IMPORTANT: Quality checks use the ORIGINAL prompt, not the enhanced one,
      * because triage decisions should be based on what the user wrote.
@@ -150,6 +171,8 @@ export class UniversalOptimizer {
     analyzeEscalation(result) {
         const reasons = [];
         let totalScore = 0;
+        // v4.12: Use configurable thresholds
+        const { standardFloor, suggestAbove, strongRecommendAbove, intentConfidenceMin } = this.thresholds;
         // Assess the ORIGINAL prompt's quality for triage decisions
         // (result.quality is for the enhanced prompt)
         const originalQuality = this.qualityAssessor.assessQuality(result.original, result.intent.primaryIntent);
@@ -164,9 +187,10 @@ export class UniversalOptimizer {
                 description: `${result.intent.primaryIntent} tasks benefit from comprehensive analysis`,
             });
         }
-        // Factor 2: Low confidence (<60% → up to +20 pts)
-        if (result.intent.confidence < 60) {
-            const contribution = Math.round((60 - result.intent.confidence) / 3); // Max 20 pts
+        // Factor 2: Low confidence (< intentConfidenceMin+10 → up to +20 pts)
+        const confidenceThreshold = intentConfidenceMin + 10; // Default: 60
+        if (result.intent.confidence < confidenceThreshold) {
+            const contribution = Math.round((confidenceThreshold - result.intent.confidence) / 3); // Max 20 pts
             totalScore += contribution;
             reasons.push({
                 factor: 'low-confidence',
@@ -174,9 +198,10 @@ export class UniversalOptimizer {
                 description: `Intent detection confidence is low (${result.intent.confidence}%)`,
             });
         }
-        // Factor 3: Overall quality score (<65 → up to +25 pts) - uses ORIGINAL quality
-        if (originalQuality.overall < 65) {
-            const contribution = Math.round((65 - originalQuality.overall) / 2.6); // Max ~25 pts
+        // Factor 3: Overall quality score (< standardFloor+5 → up to +25 pts) - uses ORIGINAL quality
+        const qualityThreshold = standardFloor + 5; // Default: 65
+        if (originalQuality.overall < qualityThreshold) {
+            const contribution = Math.round((qualityThreshold - originalQuality.overall) / 2.6); // Max ~25 pts
             totalScore += contribution;
             reasons.push({
                 factor: 'low-quality',
@@ -184,8 +209,8 @@ export class UniversalOptimizer {
                 description: `Original prompt quality is below threshold (${Math.round(originalQuality.overall)}/100)`,
             });
         }
-        // Factor 4: Low completeness (<60% → +15 pts) - uses ORIGINAL quality
-        if (originalQuality.completeness < 60) {
+        // Factor 4: Low completeness (< standardFloor → +15 pts) - uses ORIGINAL quality
+        if (originalQuality.completeness < standardFloor) {
             const contribution = 15;
             totalScore += contribution;
             reasons.push({
@@ -194,8 +219,8 @@ export class UniversalOptimizer {
                 description: `Missing required details (completeness: ${Math.round(originalQuality.completeness)}%)`,
             });
         }
-        // Factor 5: Low specificity (<60% → +15 pts) - v4.0 new dimension, uses ORIGINAL quality
-        if (originalQuality.specificity < 60) {
+        // Factor 5: Low specificity (< standardFloor → +15 pts) - uses ORIGINAL quality
+        if (originalQuality.specificity < standardFloor) {
             const contribution = 15;
             totalScore += contribution;
             reasons.push({
@@ -215,7 +240,9 @@ export class UniversalOptimizer {
             });
         }
         // Factor 7: Length mismatch (short prompt + incomplete → +15 pts) - uses ORIGINAL quality
-        if (result.original.length < 50 && originalQuality.completeness < 70) {
+        const completenessLenientThreshold = standardFloor + 10; // Default: 70
+        if (result.original.length < 50 &&
+            originalQuality.completeness < completenessLenientThreshold) {
             const contribution = 15;
             totalScore += contribution;
             reasons.push({
@@ -235,13 +262,14 @@ export class UniversalOptimizer {
                 description: `${result.intent.primaryIntent} requires thorough analysis`,
             });
         }
-        // Determine escalation confidence
-        // Thresholds: 45 for escalation, 60 for medium confidence, 75 for high confidence
+        // v4.12: Determine escalation confidence using configurable thresholds
+        // suggestAbove for escalation, (suggestAbove+strongRecommendAbove)/2 for medium, strongRecommendAbove for high
+        const mediumThreshold = Math.round((suggestAbove + strongRecommendAbove) / 2); // Default: 60
         let escalationConfidence;
-        if (totalScore >= 75) {
+        if (totalScore >= strongRecommendAbove) {
             escalationConfidence = 'high';
         }
-        else if (totalScore >= 60) {
+        else if (totalScore >= mediumThreshold) {
             escalationConfidence = 'medium';
         }
         else {
@@ -250,8 +278,8 @@ export class UniversalOptimizer {
         // v4.11: Generate comprehensive mode value proposition
         const comprehensiveValue = this.generateComprehensiveValue(result, reasons);
         return {
-            // Threshold of 45 ensures planning prompts with missing completeness trigger escalation
-            shouldEscalate: totalScore >= 45,
+            // v4.12: Use configurable suggestAbove threshold (default: 45)
+            shouldEscalate: totalScore >= suggestAbove,
             escalationScore: Math.min(totalScore, 100),
             escalationConfidence,
             reasons,

package/dist/templates/agents/agents.md

@@ -9,7 +9,7 @@ This guide is for agents that can only read documentation (no slash-command supp
 **CRITICAL: Know which mode you're in and STOP at the right point.**
 
 **OPTIMIZATION workflows** (NO CODE ALLOWED):
-- Fast/deep optimization - Prompt improvement only
+- Improve mode - Prompt optimization only (auto-selects depth)
 - Your role: Analyze, optimize, show improved prompt, **STOP**
 - ❌ DO NOT implement the prompt's requirements
 - ✅ After showing optimized prompt, tell user: "Run `/clavix:execute --latest` to implement"
@@ -38,11 +38,11 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 |----------|-----------------|---------|
 | **Conversational Mode** | `workflows/start.md` | Natural requirements gathering through discussion |
 | **Extract Requirements** | `workflows/summarize.md` | Analyze conversation → mini-PRD + optimized prompts |
-| **Quick Optimization** | `workflows/fast.md` | Intent detection + quality assessment + smart triage |
-| **Deep Analysis** | `workflows/deep.md` | Comprehensive with alternatives, validation, edge cases |
+| **Prompt Optimization** | `workflows/improve.md` | Intent detection + quality assessment + auto-depth selection |
 | **PRD Generation** | `workflows/prd.md` | Socratic questions → full PRD + quick PRD |
 | **Mode Boundaries** | `core/clavix-mode.md` | Planning vs implementation distinction |
 | **File Operations** | `core/file-operations.md` | File creation patterns |
+| **Verification** | `core/verification.md` | Post-implementation verification |
 
 **Troubleshooting:**
 - `troubleshooting/jumped-to-implementation.md` - If you started coding during planning
@@ -55,11 +55,12 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 
 | Keywords in User Request | Recommended Workflow | File Reference |
 |---------------------------|---------------------|----------------|
-| "improve this prompt", "make it better", "optimize" | Fast mode → Quick optimization | `workflows/fast.md` |
-| "analyze thoroughly", "edge cases", "alternatives" | Deep mode → Comprehensive analysis | `workflows/deep.md` |
+| "improve this prompt", "make it better", "optimize" | Improve mode → Auto-depth optimization | `workflows/improve.md` |
+| "analyze thoroughly", "edge cases", "alternatives" | Improve mode (--comprehensive) | `workflows/improve.md` |
 | "create a PRD", "product requirements" | PRD mode → Socratic questioning | `workflows/prd.md` |
 | "let's discuss", "not sure what I want" | Conversational mode → Start gathering | `workflows/start.md` |
 | "summarize our conversation" | Extract mode → Analyze thread | `workflows/summarize.md` |
+| "verify", "check my implementation" | Verify mode → Implementation verification | `core/verification.md` |
 
 **When detected:** Reference the corresponding `.clavix/instructions/workflows/{workflow}.md` file.
 
@@ -70,11 +71,14 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 | Command | Purpose |
 |---------|---------|
 | `clavix init` | Interactive setup with integration selection |
-| `clavix fast "<prompt>"` | Quick optimization (CLI auto-saves; agent must save manually per template instructions) |
-| `clavix deep "<prompt>"` | Deep analysis (CLI auto-saves; agent must save manually per template instructions) |
+| `clavix improve "<prompt>"` | Unified optimization with auto-depth selection |
+| `clavix improve --comprehensive "<prompt>"` | Force comprehensive analysis |
+| `clavix improve --standard "<prompt>"` | Force standard optimization |
+| `clavix analyze "<prompt>"` | JSON analysis output for programmatic use |
 | `clavix execute [--latest]` | Execute saved prompts (interactive or --latest) |
+| `clavix verify [--latest]` | Verify implementation against checklist |
 | `clavix prompts list` | View saved prompts with status (NEW, EXECUTED, OLD, STALE) |
-| `clavix prompts clear` | Manage cleanup (--executed, --stale, --fast, --deep, --all, --force) |
+| `clavix prompts clear` | Manage cleanup (--executed, --stale, --standard, --comprehensive, --all) |
 | `clavix prd` | Guided PRD generation → `full-prd.md` + `quick-prd.md` |
 | `clavix plan` | Transform PRD → phase-based `tasks.md` |
 | `clavix implement [--commit-strategy=<type>]` | Execute tasks (git strategies: per-task, per-5-tasks, per-phase, none) |
@@ -91,6 +95,8 @@ clavix init
 clavix version
 ```
 
+**Save behavior:** CLI auto-saves prompts to `.clavix/outputs/`. When using slash commands, the agent must save manually per template instructions (no automatic persistence).
+
 ---
 
 ## 🔄 Standard Workflow

package/dist/templates/agents/copilot-instructions.md

@@ -1,6 +1,6 @@
 # Clavix Instructions for GitHub Copilot
 
-These instructions enhance GitHub Copilot's understanding of Clavix Intelligence™ workflows available in this project.
+These instructions enhance GitHub Copilot's understanding of Clavix prompt optimization workflows available in this project.
 
 ---
 

package/dist/templates/instructions/core/verification.md

@@ -57,7 +57,7 @@ Checkpoints are standardized markers that agents output to confirm workflow step
 
 **After multi-step processes:**
 ```markdown
-**CHECKPOINT:** Completed Clavix Intelligence™ optimization - 5 improvements applied
+**CHECKPOINT:** Completed pattern-based optimization - 5 improvements applied
 **CHECKPOINT:** Analyzed conversation - extracted 12 requirements, 3 constraints
 ```
 
@@ -273,7 +273,7 @@ If workflow isn't proceeding as expected, check:
    **CHECKPOINT:** All files verified - exist at expected paths
 
 6. After optimization:
-   **CHECKPOINT:** Applied Clavix Intelligence™ - [N] improvements added
+   **CHECKPOINT:** Applied optimization patterns - [N] improvements added
 
 7. Workflow complete:
    **CHECKPOINT:** Summarization workflow complete - all outputs created

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

@@ -65,7 +65,7 @@ Tell them: **"Run `/clavix:execute --latest` to implement this prompt."**
 ```
 **CLAVIX MODE: Improve**
 Mode: planning
-Purpose: Optimizing user prompt with Clavix Intelligence
+Purpose: Optimizing user prompt with pattern-based analysis
 Depth: [standard|comprehensive] (auto-detected based on quality score)
 Implementation: BLOCKED - I will analyze and improve the prompt, not implement it
 ```

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

@@ -164,7 +164,7 @@ Implementation: BLOCKED - I will ask questions and explore needs, not implement
 
 After the conversational session, `/clavix:summarize` will:
 - Extract requirements from the conversation
-- Apply Clavix Intelligence™ optimization
+- Apply pattern-based optimization
 - Analyze intent and assess quality (Clarity, Efficiency, Structure, Completeness, Actionability)
 - Generate both original extraction and optimized version
 - Display quality scores and improvements

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

@@ -54,7 +54,7 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 | 2. Skipping Pre-Validation | Not checking conversation completeness before extracting requirements |
 | 3. Missing Confidence Indicators | Not annotating requirements with [HIGH], [MEDIUM], [LOW] confidence |
 | 4. Not Creating Output Files | Not creating mini-prd.md, optimized-prompt.md, and quick-prd.md files |
-| 5. No Clavix Intelligence™ Applied | Not applying quality patterns to extracted requirements |
+| 5. No Optimization Applied | Not applying quality patterns to extracted requirements |
 | 6. Capability Hallucination | Claiming features Clavix doesn't have, inventing workflows |
 
 **STOP**: Immediately halt the incorrect action
@@ -229,7 +229,7 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
    Use the Write tool to create `.clavix/outputs/[project-name]/optimized-prompt.md`
 
-   **Content:** Enhanced version with Clavix Intelligence™ improvements (see step 4 below for optimization)
+   **Content:** Enhanced version with pattern-based optimization (see step 4 below for optimization)
 
    **Format:**
    ```markdown
@@ -243,7 +243,7 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
    ---
 
-   ## Clavix Intelligence™ Improvements Applied
+   ## Optimization Improvements Applied
 
    1. **[ADDED]** - [Description of what was added and why]
    2. **[CLARIFIED]** - [What was ambiguous and how it was clarified]
@@ -273,8 +273,8 @@ Implementation: BLOCKED - I will extract requirements, not implement them
    - Something went wrong with file creation
    - Retry the Write tool for the missing file
 
-4. **Clavix Intelligence™ Optimization** (automatic with labeled improvements):
-   - After extracting the prompt, analyze using Clavix Intelligence™
+4. **Pattern-Based Optimization** (automatic with labeled improvements):
+   - After extracting the prompt, analyze using pattern-based optimization
    - Apply optimizations for Clarity, Efficiency, Structure, Completeness, and Actionability
    - **Label all improvements** with quality dimension tags:
      - **[Efficiency]**: "Removed 12 conversational words, reduced from 45 to 28 words"
@@ -286,7 +286,7 @@ Implementation: BLOCKED - I will extract requirements, not implement them
    - Show quality scores (before/after) and labeled improvements
    - These improvements were already applied when creating optimized-prompt.md in step 3.4
 
-   **CHECKPOINT:** Applied Clavix Intelligence™ optimization - [N] improvements added
+   **CHECKPOINT:** Applied pattern-based optimization - [N] improvements added
 
 5. **Highlight Key Insights** discovered during the conversation:
    ```markdown
@@ -324,8 +324,8 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
    **📁 Location:** `.clavix/outputs/[project-name]/`
 
-   **🎯 Clavix Intelligence™:**
-   Applied [N] optimizations:
+   **🎯 Optimizations Applied:**
+   Applied [N] improvements:
    - [Brief summary of improvements]
 
    **🔍 Key Insights:**

package/dist/templates/slash-commands/_components/agent-protocols/state-assertion.md

@@ -38,7 +38,7 @@ Implementation: [BLOCKED|ALLOWED]
 ```
 **CLAVIX MODE: Improve**
 Mode: planning
-Purpose: Optimizing user prompt with Clavix Intelligence
+Purpose: Optimizing user prompt with pattern-based analysis
 Implementation: BLOCKED - I will analyze and improve the prompt, not implement it
 ```
 

package/dist/templates/slash-commands/_components/references/intent-types.md

@@ -1,6 +1,6 @@
 ## Intent Types Reference
 
-Clavix Intelligence™ detects 11 primary intent types. This reference is synchronized with `src/core/intelligence/types.ts`.
+Clavix detects 11 primary intent types using pattern-based analysis. This reference is synchronized with `src/core/intelligence/types.ts`.
 
 ### Intent Categories
 

package/dist/templates/slash-commands/_components/sections/pattern-visibility.md

@@ -29,8 +29,8 @@ Patterns: 7 applied (comprehensive depth)
   StructureOrganizer → Reorganized into 4 sections
   TechnicalContextEnricher → Added React 18, TypeScript context
   CompletenessValidator → Flagged 3 missing requirements
-  EdgeCaseIdentifier → Added 4 edge cases (auth, network, state, browser)
-  ValidationChecklistCreator → Generated 6-item verification checklist
+  DomainContextEnricher → Added best practices for React components
+  SuccessCriteriaEnforcer → Added measurable acceptance criteria
 ```
 
 ### Pattern Impact Indicators
@@ -43,43 +43,32 @@ Patterns: 7 applied (comprehensive depth)
 
 ### Available Patterns Reference
 
-**Standard Patterns (both scopes):**
+**v4.12: Core Patterns (standard + comprehensive, scope='both'):**
 | Pattern | Priority | What It Does |
 |---------|----------|--------------|
-| ConcisenessFilter | 4 | Removes pleasantries, filler words, redundant phrases |
 | ObjectiveClarifier | 9 | Adds clear objective/goal statement if missing |
-| StructureOrganizer | 8 | Reorders into logical flow: context→requirements→constraints→output |
-| ActionabilityEnhancer | 4 | Converts vague language to specific, actionable terms |
-| TechnicalContextEnricher | 5 | Adds missing technical context (frameworks, tools, versions) |
-| CompletenessValidator | 6 | Identifies and flags missing required elements |
-| StepDecomposer | 5 | Breaks complex prompts into sequential steps |
-| ContextPrecisionBooster | 6 | Adds precise context when missing |
 | AmbiguityDetector | 9 | Identifies and flags ambiguous terms |
+| StructureOrganizer | 8 | Reorders into logical flow: context→requirements→constraints→output |
 | OutputFormatEnforcer | 7 | Adds explicit output format specifications |
 | SuccessCriteriaEnforcer | 7 | Adds measurable success criteria |
+| ContextPrecisionBooster | 6 | Adds precise context when missing |
+| CompletenessValidator | 6 | Identifies and flags missing required elements |
+| TechnicalContextEnricher | 5 | Adds missing technical context (frameworks, tools, versions) |
+| StepDecomposer | 5 | Breaks complex prompts into sequential steps |
 | DomainContextEnricher | 5 | Adds domain-specific best practices |
+| ConcisenessFilter | 4 | Removes pleasantries, filler words, redundant phrases |
+| ActionabilityEnhancer | 4 | Converts vague language to specific, actionable terms |
 
-**Comprehensive Depth Exclusive Patterns:**
+**v4.12 PRD Mode Patterns (comprehensive only):**
 | Pattern | Priority | What It Does |
 |---------|----------|--------------|
-| AlternativePhrasingGenerator | 3 | Generates 2-3 alternative prompt structures |
-| EdgeCaseIdentifier | 4 | Identifies domain-specific edge cases |
-| ValidationChecklistCreator | 3 | Creates implementation verification checklist |
-| AssumptionExplicitizer | 6 | Makes implicit assumptions explicit |
-| ScopeDefiner | 5 | Adds explicit scope boundaries |
 | PRDStructureEnforcer | 9 | Ensures PRD completeness (PRD mode only) |
-| ErrorToleranceEnhancer | 5 | Adds error handling requirements |
-| PrerequisiteIdentifier | 6 | Identifies prerequisites and dependencies |
-
-**v4.3.2 PRD Mode Patterns (comprehensive):**
-| Pattern | Priority | What It Does |
-|---------|----------|--------------|
 | RequirementPrioritizer | 7 | Separates must-have from nice-to-have requirements |
-| UserPersonaEnricher | 6 | Adds missing user context and personas |
 | SuccessMetricsEnforcer | 7 | Ensures measurable success criteria exist |
+| UserPersonaEnricher | 6 | Adds missing user context and personas |
 | DependencyIdentifier | 5 | Identifies technical and external dependencies |
 
-**v4.3.2 Conversational Mode Patterns (comprehensive):**
+**v4.12 Conversational Mode Patterns (comprehensive only):**
 | Pattern | Priority | What It Does |
 |---------|----------|--------------|
 | ConversationSummarizer | 8 | Extracts structured requirements from messages |
@@ -107,23 +96,17 @@ Skipped patterns:
 ### Pattern Categories Summary
 
 ```
-Standard (both scopes):
-  ConcisenessFilter, ObjectiveClarifier, StructureOrganizer,
-  ActionabilityEnhancer, TechnicalContextEnricher, CompletenessValidator,
-  StepDecomposer, ContextPrecisionBooster,
-  AmbiguityDetector, OutputFormatEnforcer, SuccessCriteriaEnforcer,
-  DomainContextEnricher
-
-Comprehensive only:
-  AlternativePhrasingGenerator, EdgeCaseIdentifier, ValidationChecklistCreator,
-  AssumptionExplicitizer, ScopeDefiner, PRDStructureEnforcer,
-  ErrorToleranceEnhancer, PrerequisiteIdentifier
-
-v4.3.2 PRD mode (comprehensive):
-  RequirementPrioritizer, UserPersonaEnricher, SuccessMetricsEnforcer,
-  DependencyIdentifier
-
-v4.3.2 Conversational mode (comprehensive):
+v4.12: Core patterns (standard + comprehensive, 12 patterns):
+  ObjectiveClarifier, AmbiguityDetector, StructureOrganizer,
+  OutputFormatEnforcer, SuccessCriteriaEnforcer, ContextPrecisionBooster,
+  CompletenessValidator, TechnicalContextEnricher, StepDecomposer,
+  DomainContextEnricher, ConcisenessFilter, ActionabilityEnhancer
+
+PRD mode (comprehensive only, 5 patterns):
+  PRDStructureEnforcer, RequirementPrioritizer, SuccessMetricsEnforcer,
+  UserPersonaEnricher, DependencyIdentifier
+
+Conversational mode (comprehensive only, 3 patterns):
   ConversationSummarizer, TopicCoherenceAnalyzer, ImplicitRequirementExtractor
 ```
 
@@ -131,9 +114,9 @@ v4.3.2 Conversational mode (comprehensive):
 
 | Depth | Patterns Available | Typical Applied |
 |------|-------------------|-----------------|
-| Standard | 12 patterns | 4-7 patterns |
-| Comprehensive | 27 patterns | 8-14 patterns |
-| PRD mode | 12+ patterns | 8-12 patterns |
-| Conversational | 3+ patterns | 1-3 patterns |
+| Standard | 12 patterns | 4-8 patterns |
+| Comprehensive | 20 patterns | 8-15 patterns |
+| PRD mode | 17 patterns | 8-12 patterns |
+| Conversational | 15 patterns | 6-10 patterns |
 
-**Note:** Comprehensive depth has access to all 27 patterns. Pattern selection varies by intent - some patterns only apply to specific intents (e.g., PRDStructureEnforcer only for prd-generation), so typical applied count is 8-14.
+**Note:** v4.12 has 20 total patterns after removing 7 boilerplate patterns that generated static output. Pattern selection varies by intent - some patterns only apply to specific intents (e.g., PRDStructureEnforcer only for prd-generation). Standard depth gets 12 core patterns; comprehensive adds mode-specific patterns.

package/dist/types/config.d.ts

@@ -14,12 +14,69 @@ export interface ClavixConfig {
  * v4.4 Intelligence Configuration
  * Configure pattern behavior, enable/disable patterns, adjust priorities
  * v4.11: Removed defaultMode (fast/deep replaced by improve with auto-detection)
+ * v4.12: Added escalation thresholds configuration
  */
 export interface IntelligenceConfig {
     /** Pattern-specific settings */
     patterns?: PatternSettingsConfig;
     /** Enable verbose pattern logging */
     verbosePatternLogs?: boolean;
+    /** v4.12: Escalation threshold configuration */
+    escalation?: EscalationThresholdsConfig;
+    /** v4.12: Quality assessment weight overrides */
+    qualityWeights?: QualityWeightsConfig;
+}
+/**
+ * v4.12: Configurable escalation thresholds
+ * These control when comprehensive analysis is recommended vs standard
+ */
+export interface EscalationThresholdsConfig {
+    /**
+     * Quality score threshold for comprehensive mode (default: 75)
+     * Prompts >= this score get comprehensive analysis
+     */
+    comprehensiveAbove?: number;
+    /**
+     * Quality score threshold for standard mode floor (default: 60)
+     * Prompts between standardFloor and comprehensiveAbove get standard optimization
+     */
+    standardFloor?: number;
+    /**
+     * Intent confidence threshold for auto-proceed (default: 50)
+     * Below this, ask user to confirm intent
+     */
+    intentConfidenceMin?: number;
+    /**
+     * Escalation score threshold for strong recommendation (default: 75)
+     * Above this, strongly recommend comprehensive mode
+     */
+    strongRecommendAbove?: number;
+    /**
+     * Escalation score threshold for suggestion (default: 45)
+     * Above this, suggest comprehensive mode as option
+     */
+    suggestAbove?: number;
+}
+/**
+ * v4.12: Quality dimension weight overrides by intent
+ * Allows customizing how quality scores are weighted per intent type
+ */
+export interface QualityWeightsConfig {
+    /** Override weights for specific intents */
+    byIntent?: Record<string, QualityDimensionWeights>;
+    /** Default weights for all intents (overrides built-in defaults) */
+    defaults?: QualityDimensionWeights;
+}
+/**
+ * Weight distribution across quality dimensions (must sum to 100)
+ */
+export interface QualityDimensionWeights {
+    clarity?: number;
+    efficiency?: number;
+    structure?: number;
+    completeness?: number;
+    actionability?: number;
+    specificity?: number;
 }
 /**
  * Pattern-specific settings

package/dist/utils/legacy-command-cleanup.js

@@ -1,9 +1,34 @@
 import * as path from 'path';
 import { FileSystem } from './file-system.js';
+/**
+ * v4.12: Deprecated commands that have been replaced
+ * - fast → improve (unified with auto-depth)
+ * - deep → improve --comprehensive
+ */
+const DEPRECATED_COMMANDS = ['fast', 'deep'];
 export async function collectLegacyCommandFiles(adapter, commandNames) {
     const legacyPaths = new Set();
     const extension = adapter.fileExtension;
     const commandDir = path.resolve(adapter.getCommandPath());
+    // v4.12: Clean up deprecated fast/deep commands
+    for (const deprecatedName of DEPRECATED_COMMANDS) {
+        // Check for various naming patterns across adapters
+        const candidates = [
+            path.resolve(commandDir, `${deprecatedName}${extension}`),
+            path.resolve(commandDir, `clavix-${deprecatedName}${extension}`),
+            path.resolve(commandDir, `clavix:${deprecatedName}${extension}`),
+        ];
+        // For Claude Code with subdirectory structure
+        if (adapter.name === 'claude-code') {
+            const clavixDir = path.resolve(commandDir, 'clavix');
+            candidates.push(path.resolve(clavixDir, `${deprecatedName}${extension}`), path.resolve(clavixDir, `clavix-${deprecatedName}${extension}`));
+        }
+        for (const candidate of candidates) {
+            if (await FileSystem.exists(candidate)) {
+                legacyPaths.add(candidate);
+            }
+        }
+    }
     for (const name of commandNames) {
         const newFilePath = path.resolve(commandDir, adapter.getTargetFilename(name));
         const defaultFilePath = path.resolve(commandDir, `${name}${extension}`);
@@ -15,22 +40,24 @@ export async function collectLegacyCommandFiles(adapter, commandNames) {
             ];
             for (const candidate of oldCandidates) {
                 const resolvedCandidate = path.resolve(candidate);
-                if (resolvedCandidate !== newFilePath && await FileSystem.exists(resolvedCandidate)) {
+                if (resolvedCandidate !== newFilePath && (await FileSystem.exists(resolvedCandidate))) {
                     legacyPaths.add(resolvedCandidate);
                 }
             }
-            if (defaultFilePath !== newFilePath && await FileSystem.exists(defaultFilePath)) {
+            if (defaultFilePath !== newFilePath && (await FileSystem.exists(defaultFilePath))) {
                 legacyPaths.add(defaultFilePath);
             }
             continue;
         }
         if (adapter.name === 'gemini' || adapter.name === 'qwen') {
             const namespaced = commandDir.endsWith(path.join('commands', 'clavix'));
-            if (!namespaced && defaultFilePath !== newFilePath && await FileSystem.exists(defaultFilePath)) {
+            if (!namespaced &&
+                defaultFilePath !== newFilePath &&
+                (await FileSystem.exists(defaultFilePath))) {
                 legacyPaths.add(defaultFilePath);
             }
         }
-        else if (defaultFilePath !== newFilePath && await FileSystem.exists(defaultFilePath)) {
+        else if (defaultFilePath !== newFilePath && (await FileSystem.exists(defaultFilePath))) {
             legacyPaths.add(defaultFilePath);
         }
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clavix",
-  "version": "4.11.2",
-  "description": "Clavix Intelligence™ for AI coding. Automatically optimizes prompts with intent detection, quality assessment, and adaptive patterns—no framework to learn. Works with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
+  "version": "4.12.0",
+  "description": "Prompt optimization for AI coding. Structures prompts with pattern-based intent detection, quality assessment, and workflow management. Works with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -42,7 +42,7 @@
     "ai",
     "prompt",
     "prompt-optimization",
-    "prompt-intelligence",
+    "prompt-structuring",
     "intent-detection",
     "quality-assessment",
     "prd",
@@ -53,7 +53,8 @@
     "developer-tools",
     "prompt-engineering",
     "ai-coding-tools",
-    "requirements"
+    "requirements",
+    "workflow"
   ],
   "author": "ClavixDev",
   "license": "Apache-2.0",