clavix 5.0.0 → 5.1.0

package/dist/cli/commands/init.js

@@ -273,51 +273,43 @@ Welcome to Clavix! This directory contains your local Clavix configuration and d
 .clavix/
 ├── config.json           # Your Clavix configuration
 ├── INSTRUCTIONS.md       # This file
+├── instructions/         # Workflow instruction files for AI agents
 ├── sessions/             # Conversational mode session files
 ├── outputs/
 │   ├── <project-name>/  # Per-project outputs
 │   │   ├── full-prd.md
 │   │   ├── quick-prd.md
-│   │   ├── tasks.md
-│   │   └── .clavix-implement-config.json
-│   ├── prompts/         # Saved prompts for re-execution (v4.11 unified)
+│   │   └── tasks.md
+│   ├── prompts/         # Saved prompts for re-execution
 │   └── archive/         # Archived completed projects
 └── templates/           # Custom template overrides (optional)
 \`\`\`
 
-## CLI Commands Reference
+## Clavix Commands (v5)
 
-### Prompt Improvement (v4.11)
-- \`clavix improve "<prompt>"\` - Smart prompt optimization with auto depth selection
-- \`clavix improve "<prompt>" --comprehensive\` - Force comprehensive depth analysis
-- \`clavix execute [--latest]\` - Execute saved prompts
-- \`clavix prompts list\` - View all saved prompts with status (NEW/EXECUTED/OLD/STALE)
-- \`clavix prompts clear\` - Cleanup prompts (\`--executed\`, \`--stale\`, \`--standard\`, \`--comprehensive\`, \`--all\`)
+### Setup Commands (CLI)
 
-### PRD & Planning
-- \`clavix prd\` - Generate PRD through guided Socratic questions
-- \`clavix plan\` - Transform PRD or session into phase-based \`tasks.md\`
-- \`clavix start\` - Start conversational mode for requirements gathering
-- \`clavix summarize [session-id]\` - Extract mini-PRD and prompts from conversation
+| Command | Purpose |
+|---------|---------|
+| \`clavix init\` | Initialize Clavix in a project |
+| \`clavix update\` | Update templates after package update |
+| \`clavix config\` | Manage configuration |
+| \`clavix version\` | Show version |
 
-### Implementation
-- \`clavix implement [--commit-strategy=<type>]\` - Execute tasks with optional git auto-commits
-- \`clavix task-complete <taskId>\` - Mark task complete with validation, auto-show next task
+### Workflow Commands (Slash Commands)
 
-### Project Management
-- \`clavix list [--sessions|--outputs]\` - List sessions and/or output projects
-- \`clavix show [session-id|--output <project>]\` - Inspect session or project details
-- \`clavix archive [project] [--restore]\` - Archive completed projects or restore them
+All workflows are executed via slash commands that AI agents read and follow:
 
-### Configuration
-- \`clavix init\` - Initialize Clavix (you just ran this!)
-- \`clavix config [get|set|edit|reset]\` - Manage configuration preferences
-- \`clavix update [--docs-only|--commands-only]\` - Refresh managed docs and slash commands
-- \`clavix version\` - Print installed version
-
-## Slash Commands (AI Agents)
-
-If using Claude Code, Cursor, or Windsurf, the following slash commands are available:
+| Slash Command | Purpose |
+|---------------|---------|
+| \`/clavix:improve\` | Optimize prompts (auto-selects depth) |
+| \`/clavix:prd\` | Generate PRD through guided questions |
+| \`/clavix:plan\` | Create task breakdown from PRD |
+| \`/clavix:implement\` | Execute tasks or prompts (auto-detects source) |
+| \`/clavix:start\` | Begin conversational session |
+| \`/clavix:summarize\` | Extract requirements from conversation |
+| \`/clavix:verify\` | Verify implementation |
+| \`/clavix:archive\` | Archive completed projects |
 
 **Note:** Running \`clavix init\` or \`clavix update\` will regenerate all slash commands from templates. Any manual edits to generated commands will be lost. If you need custom commands, create new command files instead of modifying generated ones.
 
@@ -325,143 +317,51 @@ If using Claude Code, Cursor, or Windsurf, the following slash commands are avai
 - Claude Code, Gemini, Qwen: \`/clavix:improve\` (colon format)
 - Cursor, Droid, Windsurf, etc.: \`/clavix-improve\` (hyphen format)
 
-### Prompt Improvement (v4.11)
-- \`improve [prompt]\` - Smart optimization with auto depth selection
-- \`execute\` - Execute saved prompts
-
-### PRD & Planning
-- \`/clavix:prd\` - Generate PRD through guided questions
-- \`/clavix:plan\` - Generate task breakdown from PRD
-- \`/clavix:start\` - Start conversational mode
-- \`/clavix:summarize\` - Summarize conversation
-
-### Implementation
-- \`/clavix:implement\` - Execute task workflow with git integration
-
-### Project Management
-- \`/clavix:archive\` - Archive completed projects
-
-## Workflows
-
-### Prompt Lifecycle (v4.11)
-
-1. **Create improved prompt**:
-   \`\`\`bash
-   clavix improve "your prompt here"
-   # Clavix auto-selects depth based on quality analysis:
-   # - <60% quality: standard depth (basic fixes)
-   # - 60-74%: asks user to choose
-   # - >=75%: comprehensive depth (polish)
-   \`\`\`
-   - CLI auto-saves to \`.clavix/outputs/prompts/\`
-   - Slash commands require manual save per template instructions
-
-2. **Execute saved prompt**:
-   \`\`\`bash
-   clavix execute --latest  # Most recent prompt
-   clavix execute           # Interactive selection
-   \`\`\`
-
-3. **Manage prompts**:
-   \`\`\`bash
-   clavix prompts list              # View all with status
-   clavix prompts clear --executed  # Remove executed prompts
-   clavix prompts clear --stale     # Remove stale (30+ days)
-   \`\`\`
-
-**Prompt Status**:
-- \`NEW\` - Just created, never executed
-- \`EXECUTED\` - Successfully executed at least once
-- \`OLD\` - 7+ days old, not executed
-- \`STALE\` - 30+ days old, not executed
-
-### Implementation Workflow (v1.3+)
-
-1. **Generate PRD**:
-   \`\`\`bash
-   clavix prd
-   # Creates: .clavix/outputs/<project>/full-prd.md + quick-prd.md
-   \`\`\`
-
-2. **Create task breakdown**:
-   \`\`\`bash
-   clavix plan
-   # Creates: .clavix/outputs/<project>/tasks.md
-   \`\`\`
+## Standard Workflow
 
-3. **Execute tasks with git integration**:
-   \`\`\`bash
-   # Manual commits (default):
-   clavix implement
+**Clavix follows this progression:**
 
-   # Or with auto-commit strategy:
-   clavix implement --commit-strategy=per-phase
-   \`\`\`
+\`\`\`
+PRD Creation → Task Planning → Implementation → Archive
+\`\`\`
 
-4. **Mark tasks complete**:
-   \`\`\`bash
-   clavix task-complete <taskId>
-   # Validates completion, optionally commits, shows next task
-   \`\`\`
+**Detailed steps:**
 
-5. **Archive when done**:
-   \`\`\`bash
-   clavix archive my-project
-   \`\`\`
+1. **Planning Phase**
+   - Run: \`/clavix:prd\` or \`/clavix:start\` → \`/clavix:summarize\`
+   - Output: \`.clavix/outputs/{project}/full-prd.md\` + \`quick-prd.md\`
 
-### Git Auto-Commit Strategies (v2.8.1)
+2. **Task Preparation**
+   - Run: \`/clavix:plan\` transforms PRD into curated task list
+   - Output: \`.clavix/outputs/{project}/tasks.md\`
 
-When using \`clavix implement --commit-strategy=<type>\`:
+3. **Implementation Phase**
+   - Run: \`/clavix:implement\`
+   - Agent executes tasks systematically
+   - Agent edits tasks.md directly to mark progress (\`- [ ]\` → \`- [x]\`)
 
-- \`none\` (default) - Manual git workflow, full control
-- \`per-task\` - Commit after each completed task (detailed history)
-- \`per-5-tasks\` - Commit every 5 tasks (balanced)
-- \`per-phase\` - Commit when phase completes (milestone-based)
+4. **Completion**
+   - Run: \`/clavix:archive\`
+   - Archives completed work
 
-**Recommendation**: Use \`none\` for most projects. Only enable auto-commits for large implementations with clear phases.
+**Key principle:** Planning workflows create documents. Implementation workflows write code.
 
-## When to Use Which Mode (v4.11)
+## Prompt Lifecycle
 
-- **Improve mode**: Smart prompt optimization with auto depth selection
-  - Standard depth: Quick cleanup for simpler prompts
-  - Comprehensive depth: Thorough analysis for complex requirements
-- **PRD mode**: Strategic planning with architecture, risks, and business impact
-- **Conversational mode** (\`start\`/\`summarize\`): Natural discussion → extract structured requirements
+1. **Optimize prompt**: \`/clavix:improve\` - Analyzes and improves your prompt
+2. **Review**: Agent lists saved prompts from \`.clavix/outputs/prompts/\`
+3. **Execute**: \`/clavix:implement --latest\` - Implement when ready
+4. **Cleanup**: Agent deletes old prompt files from \`.clavix/outputs/prompts/\`
 
-## Typical Workflows
+## When to Use Which Mode
 
-**Improve a prompt** (v4.11 unified):
-\`\`\`bash
-clavix improve "Add user authentication"
-clavix execute --latest
-\`\`\`
-
-**Create and execute strategy**:
-\`\`\`bash
-clavix prd              # Generate PRD
-clavix plan             # Create tasks.md
-clavix implement        # Execute with manual commits
-\`\`\`
-
-**Capture conversation**:
-\`\`\`bash
-clavix start            # Record conversation
-# ... discuss requirements ...
-clavix summarize        # Extract mini-PRD + prompt
-\`\`\`
-
-**Stay organized**:
-\`\`\`bash
-clavix list             # See all projects
-clavix show --output my-project
-clavix archive my-project
-\`\`\`
+- **Improve mode** (\`/clavix:improve\`): Smart prompt optimization with auto-depth selection
+- **PRD mode** (\`/clavix:prd\`): Strategic planning with architecture and business impact
+- **Conversational mode** (\`/clavix:start\` → \`/clavix:summarize\`): Natural discussion → extract structured requirements
 
 ## Customization
 
-Create custom templates in \`.clavix/templates/\` to override defaults:
-- \`improve.txt\` - Custom improve mode template
-- \`prd-questions.txt\` - Custom PRD questions
+Create custom templates in \`.clavix/templates/\` to override defaults.
 
 Edit configuration:
 \`\`\`bash

package/dist/cli/commands/update.js

@@ -215,28 +215,25 @@ 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 start\` - Start a conversational session for iterative development
-- \`clavix summarize\` - Extract requirements from conversation history
-- \`clavix execute [--latest]\` - Execute saved prompts
-- \`clavix verify [--latest]\` - Verify implementation against checklist
+### Setup Commands (CLI)
+| Command | Purpose |
+|---------|---------|
+| \`clavix init\` | Initialize Clavix in a project |
+| \`clavix update\` | Update templates after package update |
+| \`clavix config\` | Manage configuration |
+| \`clavix version\` | Show version |
 
-### Quick Start
-\`\`\`bash
-# Prompt optimization (auto-selects depth)
-clavix improve "Build a user auth system"
-
-# Generate a PRD
-clavix prd
-
-# Start conversational mode
-clavix start
-\`\`\`
+### Workflow Commands (Slash Commands)
+| Slash Command | Purpose |
+|---------------|---------|
+| \`/clavix:improve\` | Optimize prompts (auto-selects depth) |
+| \`/clavix:prd\` | Generate PRD through guided questions |
+| \`/clavix:plan\` | Create task breakdown from PRD |
+| \`/clavix:implement\` | Execute tasks or prompts (auto-detects source) |
+| \`/clavix:start\` | Begin conversational session |
+| \`/clavix:summarize\` | Extract requirements from conversation |
+| \`/clavix:verify\` | Verify implementation |
+| \`/clavix:archive\` | Archive completed projects |
 
 Learn more: https://github.com/clavixdev/clavix`;
     }

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

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

package/dist/core/doc-injector.js

@@ -134,7 +134,7 @@ export class DocInjector {
     }
     /**
      * Create default AGENTS.md content
-     * v4.11: Updated for unified /clavix:improve command
+     * v5.1: Updated for consolidated implement command
      */
     static getDefaultAgentsContent() {
         return `# AI Agent Instructions
@@ -165,19 +165,19 @@ For more information, run \`clavix --help\` in your terminal.
     /**
      * Create the CLAUDE.md block content (without file wrapper)
      * This is the single source of truth for Claude Code documentation
-     * v4.11: Updated for unified /clavix:improve command
+     * v5.1: Consolidated execute into implement, removed prompts command
      */
     static getClaudeBlockContent() {
         return `## Clavix Integration
 
 This project uses Clavix for prompt improvement and PRD generation. The following slash commands are available:
 
-### Prompt Optimization Commands
+### Prompt Optimization
 
 #### /clavix:improve [prompt]
 Optimize prompts with smart depth auto-selection. Clavix analyzes your prompt quality and automatically selects the appropriate depth (standard or comprehensive). Use for all prompt optimization needs.
 
-### PRD & Planning Commands
+### PRD & Planning
 
 #### /clavix:prd
 Launch the PRD generation workflow. Clavix will guide you through strategic questions and generate both a comprehensive PRD and a quick-reference version optimized for AI consumption.
@@ -186,9 +186,11 @@ Launch the PRD generation workflow. Clavix will guide you through strategic ques
 Generate an optimized implementation task breakdown from your PRD. Creates a phased task plan with dependencies and priorities.
 
 #### /clavix:implement
-Execute tasks from your task plan with AI assistance. Supports automatic git commits and progress tracking.
+Execute tasks or prompts with AI assistance. Auto-detects source: tasks.md (from PRD workflow) or prompts/ (from improve workflow). Supports automatic git commits and progress tracking.
 
-### Session Management Commands
+Use \`--latest\` to execute most recent prompt, \`--tasks\` to force task mode.
+
+### Session Management
 
 #### /clavix:start
 Enter conversational mode for iterative prompt development. Discuss your requirements naturally, and later use \`/clavix:summarize\` to extract an optimized prompt.
@@ -198,11 +200,8 @@ Analyze the current conversation and extract key requirements into a structured
 
 ### Utility Commands
 
-#### /clavix:execute
-Run saved prompts with lifecycle awareness. Execute previously optimized prompts.
-
-#### /clavix:prompts
-Manage your saved prompts. List, view, and organize your prompt library.
+#### /clavix:verify
+Verify implementation against checklist. Run automated checks and generate pass/fail reports.
 
 #### /clavix:archive
 Archive completed projects. Move finished PRDs and outputs to the archive for future reference.
@@ -215,7 +214,8 @@ Archive completed projects. Move finished PRDs and outputs to the archive for fu
 1. Start with \`/clavix:prd\` or \`/clavix:start\` for complex features
 2. Generate tasks with \`/clavix:plan\`
 3. Implement with \`/clavix:implement\`
-4. Archive when complete with \`/clavix:archive\`
+4. Verify with \`/clavix:verify\`
+5. Archive when complete with \`/clavix:archive\`
 
 **Pro tip**: Start complex features with \`/clavix:prd\` or \`/clavix:start\` to ensure clear requirements before implementation.`;
     }

package/dist/index 2.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { run, handle, settings } from '@oclif/core';
+// Disable debug mode (stack traces) unless explicitly requested via DEBUG env var
+if (!process.env.DEBUG) {
+    settings.debug = false;
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    run().catch(handle);
+}
+// Export for testing
+export { run };
+//# sourceMappingURL=index.js.map

package/dist/index.d 2.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from '@oclif/core';
+export { run };
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/agents/agents.md

@@ -4,7 +4,7 @@ This guide is for agents that can only read documentation (no slash-command supp
 
 ---
 
-## ⛔ CLAVIX MODE ENFORCEMENT (v4.7)
+## ⛔ CLAVIX MODE ENFORCEMENT
 
 **CRITICAL: Know which mode you're in and STOP at the right point.**
 
@@ -12,7 +12,7 @@ This guide is for agents that can only read documentation (no slash-command supp
 - 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"
+- ✅ After showing optimized prompt, tell user: "Run `/clavix:implement --latest` to implement"
 
 **PLANNING workflows** (NO CODE ALLOWED):
 - Conversational mode, requirement extraction, PRD generation
@@ -66,36 +66,37 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 
 ---
 
-## 📋 CLI Quick Reference
+## 📋 Clavix Commands (v5)
 
+### Setup Commands (CLI)
 | Command | Purpose |
 |---------|---------|
-| `clavix init` | Interactive setup with integration selection |
-| `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, --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) |
-| `clavix start` | Begin conversational session |
-| `clavix summarize [session-id]` | Extract PRD from session |
-| `clavix list` | List sessions and outputs |
-| `clavix archive [project]` | Archive/restore completed projects |
-| `clavix update` | Refresh documentation |
+| `clavix init` | Initialize Clavix in a project |
+| `clavix update` | Update templates after package update |
+| `clavix config` | Manage configuration |
+| `clavix version` | Show version |
+
+### Workflow Commands (Slash Commands)
+All workflows are executed via slash commands that AI agents read and follow:
+
+| Slash Command | Purpose |
+|---------------|---------|
+| `/clavix:improve` | Optimize prompts (auto-selects depth) |
+| `/clavix:prd` | Generate PRD through guided questions |
+| `/clavix:plan` | Create task breakdown from PRD |
+| `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
+| `/clavix:start` | Begin conversational session |
+| `/clavix:summarize` | Extract requirements from conversation |
+| `/clavix:verify` | Verify implementation |
+| `/clavix:archive` | Archive completed projects |
 
 **Quick start:**
 ```bash
 npm install -g clavix
 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).
+**How it works:** Slash commands are markdown templates. When invoked, the agent reads the template and follows its instructions using native tools (Read, Write, Edit, Bash).
 
 ---
 
@@ -110,23 +111,23 @@ PRD Creation → Task Planning → Implementation → Archive
 **Detailed steps:**
 
 1. **Planning Phase**
-   - Run: User uses conversational mode or direct PRD generation
+   - Run: `/clavix:prd` or `/clavix:start` → `/clavix:summarize`
    - Output: `.clavix/outputs/{project}/full-prd.md` + `quick-prd.md`
    - Mode: PLANNING
 
 2. **Task Preparation**
-   - Run: `clavix plan` transforms PRD into curated task list
+   - Run: `/clavix:plan` transforms PRD into curated task list
    - Output: `.clavix/outputs/{project}/tasks.md`
    - Mode: PLANNING (Pre-Implementation)
 
 3. **Implementation Phase**
-   - Run: `clavix implement [--commit-strategy=<type>]`
+   - Run: `/clavix:implement`
    - Agent executes tasks systematically
    - Mode: IMPLEMENTATION
-   - Uses `clavix task-complete <taskId>` to mark progress
+   - Agent edits tasks.md directly to mark progress (`- [ ]` → `- [x]`)
 
 4. **Completion**
-   - Run: `clavix archive [project]`
+   - Run: `/clavix:archive`
    - Archives completed work
    - Mode: Management
 
@@ -167,7 +168,7 @@ PRD Creation → Task Planning → Implementation → Archive
 ### ❌ Recreating workflow instructions inline
 **Wrong:** Copy entire fast mode workflow into response
 
-**Right:** Reference `.clavix/instructions/workflows/fast.md` and follow its steps
+**Right:** Reference `.clavix/instructions/workflows/improve.md` and follow its steps
 
 ### ❌ Not using instruction files
 **Wrong:** Make up workflow steps or guess at process