clavix 5.8.0 → 5.8.2

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

@@ -11,7 +11,6 @@ export default class Init extends Command {
     private generateConfig;
     private generateInstructions;
     private generateSlashCommands;
-    private handleLegacyCommands;
     private injectDocumentation;
     private extractClavixBlock;
     private generateQuickstart;

package/dist/cli/commands/init.js

@@ -17,7 +17,6 @@ import { DEFAULT_CONFIG } from '../../types/config.js';
 import { GeminiAdapter } from '../../core/adapters/gemini-adapter.js';
 import { QwenAdapter } from '../../core/adapters/qwen-adapter.js';
 import { loadCommandTemplates } from '../../utils/template-loader.js';
-import { collectLegacyCommandFiles } from '../../utils/legacy-command-cleanup.js';
 import { CLAVIX_BLOCK_START, CLAVIX_BLOCK_END } from '../../constants.js';
 import { validateUserConfig } from '../../utils/schemas.js';
 export default class Init extends Command {
@@ -274,7 +273,6 @@ export default class Init extends Command {
                 }
                 // Generate slash commands
                 const generatedTemplates = await this.generateSlashCommands(adapter);
-                await this.handleLegacyCommands(adapter, generatedTemplates);
                 if (adapter.name === 'gemini' || adapter.name === 'qwen') {
                     const commandPath = adapter.getCommandPath();
                     const isNamespaced = commandPath.endsWith(path.join('commands', 'clavix'));
@@ -379,16 +377,7 @@ export default class Init extends Command {
                 this.log(chalk.gray(`    Removed ${removed} existing command(s)`));
             }
             // Generate slash commands
-            const templates = await this.generateSlashCommands(adapter);
-            // Handle legacy command cleanup (silent in update mode)
-            const commandNames = templates.map((template) => template.name);
-            const legacyFiles = await collectLegacyCommandFiles(adapter, commandNames);
-            if (legacyFiles.length > 0) {
-                for (const file of legacyFiles) {
-                    await FileSystem.remove(file);
-                }
-                this.log(chalk.gray(`    Cleaned ${legacyFiles.length} legacy file(s)`));
-            }
+            await this.generateSlashCommands(adapter);
             // Re-inject documentation blocks (Claude Code only)
             if (integrationName === 'claude-code') {
                 this.log(chalk.gray('  ✓ Updating CLAUDE.md documentation...'));
@@ -543,36 +532,6 @@ To reconfigure integrations, run \`clavix init\` again.
         await adapter.generateCommands(templates);
         return templates;
     }
-    async handleLegacyCommands(adapter, templates) {
-        const commandNames = templates.map((template) => template.name);
-        const legacyFiles = await collectLegacyCommandFiles(adapter, commandNames);
-        if (legacyFiles.length === 0) {
-            return;
-        }
-        const relativePaths = legacyFiles
-            .map((file) => path.relative(process.cwd(), file))
-            .sort((a, b) => a.localeCompare(b));
-        this.log(chalk.gray(`    ⚠ Found ${relativePaths.length} deprecated command file(s):`));
-        for (const file of relativePaths) {
-            this.log(chalk.gray(`      • ${file}`));
-        }
-        const { removeLegacy } = await inquirer.prompt([
-            {
-                type: 'confirm',
-                name: 'removeLegacy',
-                message: `Remove deprecated files for ${adapter.displayName}? Functionality is unchanged; filenames are being standardized.`,
-                default: true,
-            },
-        ]);
-        if (!removeLegacy) {
-            this.log(chalk.gray('    ⊗ Kept legacy files (deprecated naming retained)'));
-            return;
-        }
-        for (const file of legacyFiles) {
-            await FileSystem.remove(file);
-            this.log(chalk.gray(`    ✓ Removed ${path.relative(process.cwd(), file)}`));
-        }
-    }
     async injectDocumentation(adapter) {
         // Inject AGENTS.md
         const agentsContent = DocInjector.getDefaultAgentsContent();

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

@@ -10,7 +10,6 @@ export default class Update extends Command {
     run(): Promise<void>;
     private updateDocumentation;
     private updateCommands;
-    private handleLegacyCommands;
     private getAgentsContent;
     private getClaudeContent;
     private hasUpToDateBlock;

package/dist/cli/commands/update.js

@@ -1,6 +1,5 @@
 import { Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
-import inquirer from 'inquirer';
 import fs from 'fs-extra';
 import * as path from 'path';
 import { DocInjector } from '../../core/doc-injector.js';
@@ -9,7 +8,6 @@ import { AgentsMdGenerator } from '../../core/adapters/agents-md-generator.js';
 import { OctoMdGenerator } from '../../core/adapters/octo-md-generator.js';
 import { WarpMdGenerator } from '../../core/adapters/warp-md-generator.js';
 import { InstructionsGenerator } from '../../core/adapters/instructions-generator.js';
-import { collectLegacyCommandFiles } from '../../utils/legacy-command-cleanup.js';
 import { CLAVIX_BLOCK_START, CLAVIX_BLOCK_END } from '../../constants.js';
 import { validateUserConfig, formatZodErrors } from '../../utils/schemas.js';
 export default class Update extends Command {
@@ -187,7 +185,7 @@ export default class Update extends Command {
         }
         return updated;
     }
-    async updateCommands(adapter, force) {
+    async updateCommands(adapter, _force) {
         this.log(chalk.cyan(`\n🔧 Updating slash commands for ${adapter.displayName}...`));
         // Remove all existing commands first (force regeneration)
         const removed = await adapter.removeAllCommands();
@@ -204,47 +202,7 @@ export default class Update extends Command {
         // Generate fresh commands from templates
         await adapter.generateCommands(templates);
         this.log(chalk.gray(`  ✓ Generated ${templates.length} command(s)`));
-        // Handle legacy commands (cleanup old naming patterns)
-        const commandNames = templates.map((t) => t.name);
-        const legacyRemoved = await this.handleLegacyCommands(adapter, commandNames, force);
-        return removed + templates.length + legacyRemoved;
-    }
-    async handleLegacyCommands(adapter, commandNames, force) {
-        if (commandNames.length === 0) {
-            return 0;
-        }
-        const legacyFiles = await collectLegacyCommandFiles(adapter, commandNames);
-        if (legacyFiles.length === 0) {
-            return 0;
-        }
-        const relativePaths = legacyFiles
-            .map((file) => path.relative(process.cwd(), file))
-            .sort((a, b) => a.localeCompare(b));
-        this.log(chalk.gray(`  ⚠ Found ${relativePaths.length} deprecated command file(s):`));
-        for (const file of relativePaths) {
-            this.log(chalk.gray(`    • ${file}`));
-        }
-        if (!force) {
-            const { removeLegacy } = await inquirer.prompt([
-                {
-                    type: 'confirm',
-                    name: 'removeLegacy',
-                    message: `Remove deprecated files for ${adapter.displayName}? Functionality is unchanged; filenames are being standardized.`,
-                    default: true,
-                },
-            ]);
-            if (!removeLegacy) {
-                this.log(chalk.gray('  ⊗ Kept legacy files (deprecated naming retained)'));
-                return 0;
-            }
-        }
-        let removed = 0;
-        for (const file of legacyFiles) {
-            await fs.remove(file);
-            this.log(chalk.gray(`  ✓ Removed ${path.relative(process.cwd(), file)}`));
-            removed++;
-        }
-        return removed;
+        return removed + templates.length;
     }
     getAgentsContent() {
         return `## Clavix Integration

package/dist/cli/helpers/init/commands.d.ts

@@ -7,17 +7,4 @@ import type { AgentAdapter, CommandTemplate } from '../../../types/agent.js';
  * Returns the generated templates
  */
 export declare function generateSlashCommands(adapter: AgentAdapter): Promise<CommandTemplate[]>;
-/**
- * Collect and optionally remove legacy command files
- * Returns paths of legacy files found
- */
-export declare function collectLegacyFiles(adapter: AgentAdapter, templates: CommandTemplate[]): Promise<string[]>;
-/**
- * Remove legacy command files
- */
-export declare function removeLegacyFiles(files: string[]): Promise<void>;
-/**
- * Get relative paths for legacy files (for display)
- */
-export declare function getLegacyRelativePaths(files: string[]): string[];
 //# sourceMappingURL=commands.d.ts.map

package/dist/cli/helpers/init/commands.js

@@ -1,10 +1,7 @@
 /**
  * Slash command generation for Clavix initialization
  */
-import * as path from 'path';
-import { FileSystem } from '../../../utils/file-system.js';
 import { loadCommandTemplates } from '../../../utils/template-loader.js';
-import { collectLegacyCommandFiles } from '../../../utils/legacy-command-cleanup.js';
 /**
  * Generate slash commands for an adapter
  * Returns the generated templates
@@ -14,26 +11,4 @@ export async function generateSlashCommands(adapter) {
     await adapter.generateCommands(templates);
     return templates;
 }
-/**
- * Collect and optionally remove legacy command files
- * Returns paths of legacy files found
- */
-export async function collectLegacyFiles(adapter, templates) {
-    const commandNames = templates.map((template) => template.name);
-    return collectLegacyCommandFiles(adapter, commandNames);
-}
-/**
- * Remove legacy command files
- */
-export async function removeLegacyFiles(files) {
-    for (const file of files) {
-        await FileSystem.remove(file);
-    }
-}
-/**
- * Get relative paths for legacy files (for display)
- */
-export function getLegacyRelativePaths(files) {
-    return files.map((file) => path.relative(process.cwd(), file)).sort((a, b) => a.localeCompare(b));
-}
 //# sourceMappingURL=commands.js.map

package/dist/cli/helpers/init/integrations.js

@@ -96,8 +96,9 @@ export function getDisplayNames(agentManager, integrations) {
  * Determine the command separator based on selected integrations
  */
 export function determineCommandSeparator(integrations) {
-    const usesColon = integrations.some((i) => COLON_SEPARATOR_INTEGRATIONS.includes(i));
-    const usesHyphen = integrations.some((i) => !COLON_SEPARATOR_INTEGRATIONS.includes(i));
+    const colonList = COLON_SEPARATOR_INTEGRATIONS;
+    const usesColon = integrations.some((i) => colonList.includes(i));
+    const usesHyphen = integrations.some((i) => !colonList.includes(i));
     if (usesColon && !usesHyphen) {
         return { primary: ':' };
     }

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

@@ -274,11 +274,14 @@ Result: Project permanently deleted
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
 
+### Workflow State Detection
+{{INCLUDE:agent-protocols/state-awareness.md}}
+
 ### CLI Reference
 {{INCLUDE:agent-protocols/cli-reference.md}}
 

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

@@ -524,7 +524,7 @@ I'll explain what's wrong and what you might need to do:
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

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

@@ -125,6 +125,8 @@ Clavix provides a unified **improve** mode that intelligently selects the approp
 
 ## Instructions
 
+**Before beginning:** Use the Clarifying Questions Protocol (see Agent Transparency section) when you need critical information from the user (confidence < 95%). For prompt improvement, this means confirming intent, desired depth, or technical constraints when ambiguous.
+
 1. Take the user's prompt: `{{ARGS}}`
 
 2. **Intent Detection** - Analyze what the user is trying to achieve:
@@ -522,7 +524,7 @@ Wait for the user to decide what to do next.
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

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

@@ -79,6 +79,8 @@ Implementation: BLOCKED - I will create the plan, not the code
 
 ## Instructions
 
+**Before beginning:** Use the Clarifying Questions Protocol (see Agent Transparency section) when you need critical information from the user (confidence < 95%). For task planning, this means confirming which PRD to use, technical approach preferences, or task breakdown granularity.
+
 ### Part A: Agent Execution Protocol
 
 **As an AI agent, you must follow this strict sequence:**
@@ -219,7 +221,7 @@ Present the plan and ask:
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

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

@@ -87,6 +87,8 @@ Both documents are automatically validated for quality (Clarity, Structure, Comp
 
 ## Instructions
 
+**Before beginning:** Use the Clarifying Questions Protocol (see Agent Transparency section) when you need critical information from the user (confidence < 95%). For PRD development, this means confirming ambiguous project scope, technical requirements, or feature priorities.
+
 1. Guide the user through these strategic questions, **one at a time** with validation:
 
    **Question 1**: What are we building and why? (Problem + goal in 2-3 sentences)
@@ -344,7 +346,7 @@ The validation ensures generated PRDs are immediately usable for AI consumption
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
@@ -361,6 +363,9 @@ The validation ensures generated PRDs are immediately usable for AI consumption
 ### CLI Reference
 {{INCLUDE:agent-protocols/cli-reference.md}}
 
+### Recovery Patterns
+{{INCLUDE:troubleshooting/vibecoder-recovery.md}}
+
 ---
 
 ## Troubleshooting

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

@@ -415,7 +415,7 @@ I'll update the PRD and add this to the refinement history. Confirm?
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
@@ -429,6 +429,9 @@ I'll update the PRD and add this to the refinement history. Confirm?
 ### Workflow State Detection
 {{INCLUDE:agent-protocols/state-awareness.md}}
 
+### Recovery Patterns
+{{INCLUDE:troubleshooting/vibecoder-recovery.md}}
+
 ---
 
 ## Workflow Navigation

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

@@ -79,6 +79,8 @@ Implementation: BLOCKED - I will ask questions and explore needs, not implement
 
 ## Instructions
 
+**Before beginning:** Use the Clarifying Questions Protocol (see Agent Transparency section) throughout the conversation when you need critical information from the user (confidence < 95%). In conversational mode, this means probing for unclear requirements, technical constraints, or user needs.
+
 1. Begin with a friendly introduction:
    ```
    I'm starting Clavix conversational mode for requirements gathering.
@@ -226,11 +228,17 @@ The goal is natural exploration of requirements, not a rigid questionnaire. Foll
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
 
+### Workflow State Detection
+{{INCLUDE:agent-protocols/state-awareness.md}}
+
+### CLI Reference
+{{INCLUDE:agent-protocols/cli-reference.md}}
+
 ### Conversational Companion
 {{INCLUDE:agent-protocols/supportive-companion.md}}
 

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

@@ -80,6 +80,8 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
 ## Instructions
 
+**Before beginning:** Use the Clarifying Questions Protocol (see Agent Transparency section) when you need critical information from the user (confidence < 95%). For summarization, this means asking for missing context, unclear requirements, or ambiguous technical specifications before extraction.
+
 1. **Pre-Extraction Validation** - Check conversation completeness:
 
    **CHECKPOINT:** Pre-extraction validation started
@@ -401,7 +403,7 @@ The `/clavix:summarize` command extracts requirements from exploratory conversat
 
 ---
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
@@ -415,6 +417,9 @@ The `/clavix:summarize` command extracts requirements from exploratory conversat
 ### Workflow State Detection
 {{INCLUDE:agent-protocols/state-awareness.md}}
 
+### CLI Reference
+{{INCLUDE:agent-protocols/cli-reference.md}}
+
 ### Recovery Patterns
 {{INCLUDE:troubleshooting/vibecoder-recovery.md}}
 

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

@@ -123,7 +123,7 @@ Implementation: BLOCKED - I'll analyze and report, not modify or fix
 
 ----
 
-## Agent Transparency (v5.8.0)
+## Agent Transparency (v5.8.2)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

package/dist/templates/slash-commands/_components/MANIFEST.md

@@ -10,6 +10,7 @@ Core protocols that all AI agents must follow. Shared across most commands.
 | Component | Purpose | Used By |
 |-----------|---------|---------|
 | `AGENT_MANUAL.md` | Universal protocols (transparency, mode identification, communication patterns) | All 9 commands |
+| `clarifying-questions.md` | Systematic protocol for asking clarifying questions (95% confidence threshold) | improve, prd, plan, start, summarize |
 | `cli-reference.md` | CLI command reference including removed commands table | improve, prd, plan, implement, verify, archive |
 | `state-awareness.md` | Workflow state detection (mid-PRD, mid-implementation, etc.) | prd, plan, implement, summarize |
 | `state-assertion.md` | Required mode assertion output (MODE, Purpose, Implementation status) | Available for all commands |
@@ -46,12 +47,12 @@ Recovery patterns for common agent issues.
 
 | Command | Components Used |
 |---------|----------------|
-| `/clavix:improve` | AGENT_MANUAL, cli-reference, improvement-explanations, quality-dimensions, escalation-factors, pattern-impact |
-| `/clavix:prd` | AGENT_MANUAL, prd-examples, quality-dimensions, state-awareness, cli-reference |
-| `/clavix:plan` | AGENT_MANUAL, state-awareness, cli-reference, vibecoder-recovery |
+| `/clavix:improve` | AGENT_MANUAL (includes clarifying-questions), cli-reference, improvement-explanations, quality-dimensions, escalation-factors, pattern-impact |
+| `/clavix:prd` | AGENT_MANUAL (includes clarifying-questions), prd-examples, quality-dimensions, state-awareness, cli-reference |
+| `/clavix:plan` | AGENT_MANUAL (includes clarifying-questions), state-awareness, cli-reference, vibecoder-recovery |
 | `/clavix:implement` | AGENT_MANUAL, state-awareness, task-blocking, cli-reference, vibecoder-recovery |
-| `/clavix:start` | AGENT_MANUAL, supportive-companion, conversation-examples, vibecoder-recovery |
-| `/clavix:summarize` | AGENT_MANUAL, improvement-explanations, quality-dimensions, state-awareness, vibecoder-recovery |
+| `/clavix:start` | AGENT_MANUAL (includes clarifying-questions), supportive-companion, conversation-examples, vibecoder-recovery |
+| `/clavix:summarize` | AGENT_MANUAL (includes clarifying-questions), improvement-explanations, quality-dimensions, state-awareness, vibecoder-recovery |
 | `/clavix:refine` | AGENT_MANUAL, cli-reference, quality-dimensions, state-awareness |
 | `/clavix:verify` | AGENT_MANUAL, cli-reference, vibecoder-recovery |
 | `/clavix:archive` | AGENT_MANUAL, cli-reference, vibecoder-recovery |

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

@@ -268,6 +268,12 @@ Each Clavix command has a specific mode. Stay within your mode:
 
 ---
 
+## Clarifying Questions Protocol
+
+{{INCLUDE:agent-protocols/clarifying-questions.md}}
+
+---
+
 ## Verification Block Template
 
 At the end of workflows that produce output, include verification:

package/dist/templates/slash-commands/_components/agent-protocols/clarifying-questions.md

@@ -0,0 +1,99 @@
+# Clarifying Questions Protocol
+
+When the user's request requires critical information to proceed correctly, use this protocol to gather necessary details systematically.
+
+## When to Ask Clarifying Questions
+
+Ask clarifying questions when:
+- **Critical ambiguity exists** - The request has multiple valid interpretations that lead to substantially different outcomes
+- **Missing essential context** - Information necessary to complete the task successfully is absent
+- **Technical specifications needed** - Specific versions, paths, identifiers, or constraints are required
+- **User choice required** - Multiple valid approaches exist and the user's preference is needed
+
+**Do NOT ask clarifying questions when:**
+- The information is trivial or easily inferred from context
+- You can make a reasonable default assumption and mention it
+- The question would slow down obviously simple tasks
+- You're seeking perfection rather than addressing genuine ambiguity
+
+## Question Format
+
+Use this structured format for maximum clarity and efficiency:
+
+### a. Multiple Choice Questions
+
+When presenting options, use clear labels and make selection easy:
+
+**Question:** [Your question here]
+
+**Options:**
+- **a.** First option - brief explanation
+- **b.** Second option - brief explanation  
+- **c.** Third option - brief explanation
+
+**Please respond with your choice (e.g., 'a' or 'option a').**
+
+### b. Custom Input Questions
+
+When you need specific information not in a predefined list:
+
+**Question:** [Your question here]
+
+**Please provide:** [Clear description of what format/content you need]
+
+**Example:** [Show an example of valid input]
+
+## Confidence Threshold
+
+**Ask clarifying questions when confidence < 95%**
+
+If you're 95%+ confident you understand the user's intent and have the necessary information, proceed without asking. If confidence is below 95%, stop and ask.
+
+## Best Practices
+
+1. **Ask questions sequentially** - Don't overwhelm with multiple questions at once unless they're tightly related
+2. **Explain why you're asking** - Briefly state what the answer will help you determine
+3. **Limit options** - Present 2-4 options maximum for choice questions
+4. **Make defaults clear** - If there's a sensible default, state it and ask for confirmation
+5. **Batch related questions** - If multiple questions are interdependent, present them together
+
+## Examples
+
+### Good: Clear Multiple Choice
+> I need to know where to save the configuration file to proceed correctly.
+>
+> **Options:**
+> - **a.** Project root (recommended for project-specific configs)
+> - **b.** Home directory (for user-wide settings)
+> - **c.** Custom path (you specify)
+>
+> **Please respond with your choice (e.g., 'a').**
+
+### Good: Custom Input with Context
+> To generate the migration script, I need the database schema version.
+>
+> **Please provide:** The current schema version number (e.g., "2.1.0" or "v3.4")
+>
+> If you're unsure, you can check with: `npm run db:version`
+
+### Bad: Unnecessary Question
+> ❌ "Do you want me to use good coding practices?"
+>
+> (This is always implied - just do it)
+
+### Bad: Analysis Paralysis
+> ❌ "Should I use const or let for this variable?"
+>
+> (This is implementation detail - decide yourself based on best practices)
+
+## Recovery Pattern
+
+If you realize you should have asked clarifying questions AFTER starting:
+
+1. **STOP** the current approach
+2. **EXPLAIN** what you discovered that requires clarification  
+3. **ASK** the necessary questions
+4. **RESUME** with the correct approach once answered
+
+**Example:**
+> I apologize - I started implementing the auth flow but realized I need to clarify which authentication method you want to use. Are we implementing: (a) JWT tokens, (b) Session-based auth, or (c) OAuth2?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.8.0",
+  "version": "5.8.2",
   "description": "Agentic-first prompt workflows. Markdown templates that teach AI agents how to optimize prompts, create PRDs, and manage implementation.\n\nSLASH COMMANDS (in your AI assistant):\n  /clavix:improve    Optimize prompts with auto-depth\n  /clavix:prd        Generate PRD through questions\n  /clavix:plan       Create task breakdown from PRD\n  /clavix:implement  Execute tasks with progress tracking\n  /clavix:start      Begin conversational session\n  /clavix:summarize  Extract requirements from conversation\n  /clavix:refine     Refine existing PRD or prompt\n  /clavix:verify     Verify implementation against requirements\n  /clavix:archive    Archive completed projects\n\nWorks with Claude Code, Cursor, Windsurf, and 20 AI coding tools.",
   "type": "module",
   "main": "dist/index.js",

package/dist/utils/legacy-command-cleanup.d.ts

@@ -1,19 +0,0 @@
-/**
- * Legacy Command Cleanup Utility
- *
- * This module handles cleanup of old command naming patterns from previous
- * Clavix versions. It identifies files using deprecated naming conventions
- * and assists in migration to the current standard.
- *
- * Handles cleanup of:
- * - fast.md, deep.md (replaced by improve.md in v4.11+)
- * - Old naming patterns (clavix-{name} vs {name})
- * - Subdirectory migration for Cline and Claude Code
- *
- * This module will be removed when v4->v5 migration support ends.
- *
- * @since v4.12.0
- */
-import { AgentAdapter } from '../types/agent.js';
-export declare function collectLegacyCommandFiles(adapter: AgentAdapter, commandNames: string[]): Promise<string[]>;
-//# sourceMappingURL=legacy-command-cleanup.d.ts.map

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

@@ -1,99 +0,0 @@
-/**
- * Legacy Command Cleanup Utility
- *
- * This module handles cleanup of old command naming patterns from previous
- * Clavix versions. It identifies files using deprecated naming conventions
- * and assists in migration to the current standard.
- *
- * Handles cleanup of:
- * - fast.md, deep.md (replaced by improve.md in v4.11+)
- * - Old naming patterns (clavix-{name} vs {name})
- * - Subdirectory migration for Cline and Claude Code
- *
- * This module will be removed when v4->v5 migration support ends.
- *
- * @since v4.12.0
- */
-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}`);
-        if (adapter.name === 'cline') {
-            const oldDir = path.resolve('.cline', 'workflows');
-            const oldCandidates = [
-                path.join(oldDir, `${name}${extension}`),
-                path.join(oldDir, `clavix-${name}${extension}`),
-            ];
-            for (const candidate of oldCandidates) {
-                const resolvedCandidate = path.resolve(candidate);
-                if (resolvedCandidate !== newFilePath && (await FileSystem.exists(resolvedCandidate))) {
-                    legacyPaths.add(resolvedCandidate);
-                }
-            }
-            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))) {
-                legacyPaths.add(defaultFilePath);
-            }
-        }
-        else if (defaultFilePath !== newFilePath && (await FileSystem.exists(defaultFilePath))) {
-            legacyPaths.add(defaultFilePath);
-        }
-    }
-    if (adapter.name === 'claude-code') {
-        const commandsDir = path.resolve('.claude', 'commands');
-        const colonFiles = await FileSystem.listFiles(commandsDir, /^clavix:.*\.md$/);
-        for (const file of colonFiles) {
-            legacyPaths.add(path.resolve(path.join(commandsDir, file)));
-        }
-        const clavixDir = path.resolve(commandsDir, 'clavix');
-        const hyphenFiles = await FileSystem.listFiles(clavixDir, /^clavix-.*\.md$/);
-        for (const file of hyphenFiles) {
-            legacyPaths.add(path.resolve(path.join(clavixDir, file)));
-        }
-        // Remove task-complete.md (CLI-only command, not a user-facing slash command)
-        const taskCompleteFile = path.resolve(clavixDir, 'task-complete.md');
-        if (await FileSystem.exists(taskCompleteFile)) {
-            legacyPaths.add(taskCompleteFile);
-        }
-    }
-    return Array.from(legacyPaths);
-}
-//# sourceMappingURL=legacy-command-cleanup.js.map