clavix 5.0.0 → 5.0.1

package/dist/cli/commands/init.js

@@ -273,51 +273,44 @@ 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 with progress tracking |
+| \`/clavix:start\` | Begin conversational session |
+| \`/clavix:summarize\` | Extract requirements from conversation |
+| \`/clavix:execute\` | Run saved prompts |
+| \`/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 +318,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:execute\` - 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,26 @@ 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 with progress tracking |
+| \`/clavix:start\` | Begin conversational session |
+| \`/clavix:summarize\` | Extract requirements from conversation |
+| \`/clavix:execute\` | Run saved prompts |
+| \`/clavix:verify\` | Verify implementation |
+| \`/clavix:archive\` | Archive completed projects |
 
 Learn more: https://github.com/clavixdev/clavix`;
     }

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

@@ -66,36 +66,38 @@ 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 with progress tracking |
+| `/clavix:start` | Begin conversational session |
+| `/clavix:summarize` | Extract requirements from conversation |
+| `/clavix:execute` | Run saved prompts |
+| `/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 +112,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 +169,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

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

@@ -38,8 +38,7 @@ 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 |
 
@@ -54,33 +53,40 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 
 ---
 
-## 📋 CLI Quick Reference
+## 📋 Clavix Commands (v5)
 
+### Setup Commands (CLI)
 | Command | Purpose |
 |---------|---------|
-| `clavix fast "<prompt>"` | Quick optimization (CLI auto-saves; slash commands require manual saving per template instructions) |
-| `clavix deep "<prompt>"` | Deep analysis (CLI auto-saves; slash commands require manual saving per template instructions) |
-| `clavix execute [--latest]` | Execute saved prompts (--latest, --fast, --deep, --id supported) |
-| `clavix prompts list` | View saved prompts with status (NEW, EXECUTED, OLD, STALE) |
-| `clavix prompts clear` | Manage cleanup (--executed, --stale, --fast, --deep, --all, --force) |
-| `clavix prd` | Guided PRD generation |
-| `clavix plan` | Transform PRD → tasks |
-| `clavix implement [--commit-strategy]` | Execute tasks |
-| `clavix start` | Begin conversational session |
-| `clavix summarize [session-id]` | Extract PRD from session |
-| `clavix list` | List sessions/outputs |
-| `clavix archive [project]` | Archive/restore 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:
+
+| 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 with progress tracking |
+| `/clavix:start` | Begin conversational session |
+| `/clavix:summarize` | Extract requirements from conversation |
+| `/clavix:execute` | Run saved prompts |
+| `/clavix:verify` | Verify implementation |
+| `/clavix:archive` | Archive completed projects |
 
 ---
 
-## 🔄 Prompt Lifecycle Management (v2.7+)
+## 🔄 Prompt Lifecycle Workflow
 
-**Prompt Lifecycle Workflow:**
-1. **Optimize**: `clavix fast/deep "<prompt>"` → CLI auto-saves; slash commands require manual saving per template instructions
-2. **Review**: `clavix prompts list` → View all saved prompts with status
-3. **Execute**: `clavix execute --latest` → Implement when ready
-4. **Cleanup**: `clavix prompts clear --executed` → Remove completed prompts
+**Prompt Lifecycle:**
+1. **Optimize**: `/clavix:improve` → Analyzes and improves your prompt
+2. **Review**: Agent reads `.clavix/outputs/prompts/*.md` to list saved prompts
+3. **Execute**: `/clavix:execute` → Implement when ready
+4. **Cleanup**: Agent deletes old prompt files from `.clavix/outputs/prompts/`
 
 ---
 
@@ -94,10 +100,10 @@ PRD Creation → Task Planning → Implementation → Archive
 
 **Detailed steps:**
 
-1. **Planning Phase** - User creates PRD (conversational or direct)
-2. **Task Preparation** - `clavix plan` transforms PRD into tasks.md
-3. **Implementation Phase** - `clavix implement` executes tasks systematically
-4. **Completion** - `clavix archive` archives completed work
+1. **Planning Phase** - `/clavix:prd` or `/clavix:start` → `/clavix:summarize`
+2. **Task Preparation** - `/clavix:plan` transforms PRD into tasks.md
+3. **Implementation Phase** - `/clavix:implement` executes tasks systematically
+4. **Completion** - `/clavix:archive` archives completed work
 
 **Key principle:** Planning workflows create documents. Implementation workflows write code.
 
@@ -113,17 +119,17 @@ When analyzing prompts, consider these 5 dimensions:
 - **Completeness**: All specs provided (persona, format, tone, success criteria)?
 - **Actionability**: Can AI take immediate action?
 
-**Reference:** See `workflows/fast.md` for complete quality assessment patterns
+**Reference:** See `workflows/improve.md` for complete quality assessment patterns
 
 ---
 
 ## 💡 Best Practices for GitHub Copilot
 
-1. **Suggest appropriate workflow** - Fast for simple prompts, deep for complex, PRD for strategic
+1. **Suggest appropriate workflow** - `/clavix:improve` for prompts, `/clavix:prd` for strategic planning
 2. **Reference instruction files** - Point to `.clavix/instructions/workflows/*.md` instead of recreating steps
 3. **Respect mode boundaries** - Planning mode = no code, Implementation mode = write code
 4. **Use quality dimensions** - Apply 5-dimension assessment principles in responses
-5. **Guide users to CLI** - Recommend appropriate `clavix` commands for their needs
+5. **Guide users to slash commands** - Recommend appropriate `/clavix:*` commands for their needs
 
 ---
 
@@ -132,17 +138,17 @@ When analyzing prompts, consider these 5 dimensions:
 ### ❌ Jumping to implementation during planning
 **Wrong:** User discusses feature → Copilot generates code immediately
 
-**Right:** User discusses feature → Suggest `clavix prd` or `clavix start` → Create planning docs first
+**Right:** User discusses feature → Suggest `/clavix:prd` or `/clavix:start` → Create planning docs first
 
 ### ❌ Not suggesting Clavix workflows
 **Wrong:** User asks "How should I phrase this?" → Copilot provides generic advice
 
-**Right:** User asks "How should I phrase this?" → Suggest `clavix fast "<prompt>"` for quality assessment
+**Right:** User asks "How should I phrase this?" → Suggest `/clavix:improve` for quality assessment
 
 ### ❌ Recreating workflow steps inline
 **Wrong:** Copilot explains entire PRD generation process in chat
 
-**Right:** Copilot references `.clavix/instructions/workflows/prd.md` and suggests running `clavix prd`
+**Right:** Copilot references `.clavix/instructions/workflows/prd.md` and suggests running `/clavix:prd`
 
 ---
 
@@ -151,7 +157,7 @@ When analyzing prompts, consider these 5 dimensions:
 When users ask for help with prompts or requirements:
 
 1. **Detect need** - Identify if user needs planning, optimization, or implementation
-2. **Suggest command** - Recommend appropriate `clavix` command
+2. **Suggest slash command** - Recommend appropriate `/clavix:*` command
 3. **Explain benefit** - Describe expected output and value
 4. **Help interpret** - Assist with understanding Clavix-generated outputs
 5. **Apply principles** - Use quality dimensions in your responses
@@ -159,10 +165,10 @@ When users ask for help with prompts or requirements:
 **Example flow:**
 ```
 User: "I want to build a dashboard but I'm not sure how to phrase the requirements"
-Copilot: "I suggest running `clavix start` to begin conversational requirements gathering.
+Copilot: "I suggest running `/clavix:start` to begin conversational requirements gathering.
 This will help us explore your needs naturally, then we can extract structured requirements
-with `clavix summarize`. Alternatively, if you have a rough idea, try:
-clavix fast 'Build a dashboard for...' for quick optimization."
+with `/clavix:summarize`. Alternatively, if you have a rough idea, try:
+`/clavix:improve 'Build a dashboard for...'` for quick optimization."
 ```
 
 ---

package/dist/templates/agents/octo.md

@@ -20,9 +20,10 @@ Clavix workflows optimized for Octofriend's capabilities: model switching, multi
 - ❌ DO NOT implement features during these workflows
 
 **IMPLEMENTATION workflows** (CODE ALLOWED):
-- `/clavix:implement`, `/clavix:execute`, `clavix task-complete`
+- `/clavix:implement`, `/clavix:execute`
 - Your role: Write code, execute tasks, implement features
 - ✅ DO implement code during these workflows
+- Mark task completion by editing tasks.md directly (`- [ ]` → `- [x]`)
 
 See `.clavix/instructions/core/clavix-mode.md` for complete mode documentation.
 
@@ -115,35 +116,40 @@ Autofix handles edge cases gracefully - let it work.
 
 ---
 
-## 📋 CLI Quick Reference
-
-| Command | Purpose | Output |
-|---------|---------|--------|
-| `clavix init` | Setup Clavix in project | `.clavix/config.json` |
-| `clavix prd` | Generate PRD through questions | `full-prd.md` + `quick-prd.md` |
-| `clavix fast "<prompt>"` | Quick prompt improvement (CLI auto-saves prompts; Slash commands require manual saving per template instructions) | Saved to `.clavix/outputs/prompts/fast/` |
-| `clavix deep "<prompt>"` | Comprehensive analysis (CLI auto-saves prompts; Slash commands require manual saving per template instructions) | Saved to `.clavix/outputs/prompts/deep/` |
-| `clavix execute [--latest]` | Execute prompt (interactive or --latest for most recent) | Implementation |
-| `clavix prompts list` | View all saved prompts with status | NEW, EXECUTED, OLD, STALE |
-| `clavix prompts clear` | Manage cleanup (--executed, --stale, --fast, --deep, --all) | Cleanup report |
-| `clavix start` | Conversational requirements | Session captured |
-| `clavix summarize` | Extract from conversation | `mini-prd.md` + prompts |
-| `clavix plan` | Generate tasks from PRD | `tasks.md` |
-| `clavix implement` | Execute tasks | Implementation + commits |
-| `clavix list` | Show sessions/outputs | List view |
-| `clavix update` | Refresh documentation | Updates managed files |
+## 📋 Clavix Commands (v5)
+
+### 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 |
+
+### Workflow Commands (Slash Commands)
+| Slash Command | Purpose |
+|---------------|---------|
+| `/clavix:improve` | Optimize prompts (auto-selects depth) |
+| `/clavix:prd` | Generate PRD through questions |
+| `/clavix:plan` | Create task breakdown from PRD |
+| `/clavix:implement` | Execute tasks with progress tracking |
+| `/clavix:start` | Begin conversational session |
+| `/clavix:summarize` | Extract requirements from conversation |
+| `/clavix:execute` | Run saved prompts |
+| `/clavix:verify` | Verify implementation |
+| `/clavix:archive` | Archive completed projects |
 
 ---
 
 ## 🔄 Prompt Execution Workflow
 
-**When you have a saved prompt to execute prompt:**
+**When you have a saved prompt to execute:**
 
-1. **List available prompts**: `clavix prompts list` - See all saved prompts with status
-2. **execute prompt**: `clavix execute --latest` - implement saved prompt interactively
-3. **implement saved prompt**: Agent executes the optimized prompt and implements the feature
+1. **List available prompts**: List files in `.clavix/outputs/prompts/*.md`
+2. **Execute prompt**: `/clavix:execute` - implement saved prompt
+3. **Implement**: Agent reads the optimized prompt and implements the feature
 
-**Note:** CLI auto-saves prompts from fast/deep commands. Slash commands require manual saving per template instructions.
+**Note:** Slash commands save prompts as `.md` files with frontmatter metadata.
 
 ---
 
@@ -151,26 +157,25 @@ Autofix handles edge cases gracefully - let it work.
 
 **Complete project flow:**
 
-1. **Planning** (`clavix prd`)
+1. **Planning** (`/clavix:prd`)
    - Creates PRD (full + quick versions)
    - Saves to `.clavix/outputs/{project}/`
 
-2. **Task Preparation** (`clavix plan`)
+2. **Task Preparation** (`/clavix:plan`)
    - Transforms PRD → curated tasks.md
    - Phase-based organization
 
-3. **Implementation** (`clavix implement`)
+3. **Implementation** (`/clavix:implement`)
    - Agent executes tasks systematically
-   - Uses `clavix task-complete` for progress
+   - Marks progress by editing tasks.md (`- [ ]` → `- [x]`)
    - Optional git commit strategies
 
-4. **Completion** (`clavix archive`)
+4. **Completion** (`/clavix:archive`)
    - Archives completed project
 
 **Alternative quick paths:**
-- **Quick improvement**: `clavix fast` → `clavix execute` → Done
-- **Deep analysis**: `clavix deep` → `clavix execute` → Done
-- **Conversational**: `clavix start` → `clavix summarize` → `clavix execute` → Done
+- **Quick improvement**: `/clavix:improve` → `/clavix:execute` → Done
+- **Conversational**: `/clavix:start` → `/clavix:summarize` → `/clavix:execute` → Done
 
 ---
 
@@ -189,9 +194,9 @@ Autofix handles edge cases gracefully - let it work.
 ## ⚠️ Common Mistakes
 
 ### ❌ Implementing during planning workflows
-**Wrong:** User runs `clavix prd`, you generate PRD then start building features
+**Wrong:** User runs `/clavix:prd`, you generate PRD then start building features
 
-**Right:** User runs `clavix prd`, you generate PRD, save files, suggest `clavix plan` as next step
+**Right:** User runs `/clavix:prd`, you generate PRD, save files, suggest `/clavix:plan` as next step
 
 ### ❌ Skipping file creation
 **Wrong:** Display optimized prompt, stop there
@@ -201,7 +206,7 @@ Autofix handles edge cases gracefully - let it work.
 ### ❌ Not referencing instruction files
 **Wrong:** Trying to remember workflow details from this file
 
-**Right:** "See `.clavix/instructions/workflows/fast.md` for complete workflow"
+**Right:** "See `.clavix/instructions/workflows/improve.md` for complete workflow"
 
 ### ❌ Using wrong model for task
 **Wrong:** Using fast model for complex architectural planning
@@ -212,9 +217,9 @@ Autofix handles edge cases gracefully - let it work.
 
 ## 🆘 When in Doubt
 
-1. **Check which command was run** - Determines your mode (planning vs implementation)
+1. **Check which slash command was run** - Determines your mode (planning vs implementation)
 2. **Reference instruction files** - They have complete step-by-step guidance
-3. **Ask the user** - "Should I implement this (run `clavix implement`), or continue planning?"
+3. **Ask the user** - "Should I implement this (run `/clavix:implement`), or continue planning?"
 4. **Switch models** - Use thinking models for complex planning tasks
 
 ---

package/dist/templates/agents/warp.md

@@ -33,8 +33,7 @@ See `.clavix/instructions/core/clavix-mode.md` for complete mode documentation.
 For complete step-by-step workflows, see `.clavix/instructions/`:
 - `.clavix/instructions/workflows/start.md` - Conversational mode
 - `.clavix/instructions/workflows/summarize.md` - Extract requirements
-- `.clavix/instructions/workflows/fast.md` - Quick prompt optimization
-- `.clavix/instructions/workflows/deep.md` - Comprehensive analysis
+- `.clavix/instructions/workflows/improve.md` - Prompt optimization (auto-depth)
 - `.clavix/instructions/workflows/prd.md` - PRD generation
 - `.clavix/instructions/troubleshooting/` - Common issues
 
@@ -47,25 +46,26 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 - Or run ad hoc: `npx clavix@latest init`
 - Verify setup: `clavix version`
 
-### Common commands
-- `clavix init` – interactive integration setup (regenerates docs & commands)
-- `clavix fast "<prompt>"` – quick quality assessment (5 dimensions) and improved prompt. CLI auto-saves; slash commands need manual saving per template instructions.
-- `clavix deep "<prompt>"` – comprehensive analysis with alternatives, edge cases, and validation checklists. CLI auto-saves; slash commands need manual saving per template instructions.
-- `clavix execute [--latest]` – execute saved prompts from fast/deep. Interactive selection or `--latest` for most recent.
-- `clavix prompts list` – view all saved prompts with age/status (NEW, EXECUTED, OLD, STALE)
-- `clavix prompts clear [--executed|--stale|--fast|--deep]` – cleanup executed or old prompts
-- `clavix prd` – answer focused questions to create full/quick PRDs
-- `clavix plan` – transform PRDs or sessions into task lists
-- `clavix implement [--commit-strategy=<type>]` – execute tasks (git: per-task, per-5-tasks, per-phase, none [default])
-- `clavix task-complete <taskId>` – mark task completed with validation and optional git commit
-- `clavix start` – capture requirement conversations in Warp
-- `clavix summarize [session-id]` – extract mini PRDs and optimized prompts
-- `clavix list` – list sessions/outputs (`--sessions`, `--outputs`, `--archived`)
-- `clavix show [session-id]` – inspect sessions or use `--output <project>`
-- `clavix archive [project]` – archive projects (or `--restore` to bring them back)
-- `clavix config get|set|edit|reset` – manage `.clavix/config.json`
-- `clavix update` – refresh documentation/commands (`--docs-only`, `--commands-only`)
-- `clavix version` – print installed CLI version
+### CLI Commands (v5)
+| Command | Purpose |
+|---------|---------|
+| `clavix init` | Initialize Clavix in a project |
+| `clavix update` | Update templates after package update |
+| `clavix config` | Manage configuration |
+| `clavix version` | Show version |
+
+### Slash Commands (Workflows)
+| 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 with progress tracking |
+| `/clavix:start` | Begin conversational session |
+| `/clavix:summarize` | Extract requirements from conversation |
+| `/clavix:execute` | Run saved prompts |
+| `/clavix:verify` | Verify implementation |
+| `/clavix:archive` | Archive completed projects |
 
 ### Outputs
 - Project artifacts live under `.clavix/outputs/<project>/`
@@ -86,14 +86,14 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
 ### ⚠️ Common Mistakes
 
 #### ❌ Jumping to implementation during planning
-**Wrong:** User runs `clavix prd`, you generate PRD then start building features
+**Wrong:** User runs `/clavix:prd`, you generate PRD then start building features
 
-**Right:** User runs `clavix prd`, you generate PRD, save files, suggest `clavix plan` as next step
+**Right:** User runs `/clavix:prd`, you generate PRD, save files, suggest `/clavix:plan` as next step
 
 #### ❌ Not referencing instruction files
 **Wrong:** Trying to remember workflow details from this file
 
-**Right:** "See `.clavix/instructions/workflows/fast.md` for complete workflow"
+**Right:** "See `.clavix/instructions/workflows/improve.md` for complete workflow"
 
 ---
 

package/dist/templates/instructions/README.md

@@ -137,12 +137,15 @@ PRD Creation → Task Planning → Implementation → Verification → Archive
 | `/clavix:verify` | Verification | Context-dependent |
 | `/clavix:archive` | Management | ✗ NO |
 
-### Agent-Only Commands (No Slash Command)
+### Agent Operations (v5 Agentic-First)
 
-| CLI Command | Purpose | Invoked By |
-|-------------|---------|------------|
-| `clavix analyze` | Internal prompt analysis | `improve` workflow |
-| `clavix task-complete` | Mark task done | `implement` workflow |
+In v5, agents use native tools (Write, Edit, Bash) instead of CLI commands:
+
+| Operation | How Agent Performs It |
+|-----------|----------------------|
+| Save prompt | Use Write tool to create `.clavix/outputs/prompts/<id>.md` |
+| Mark task done | Use Edit tool to change `- [ ]` to `- [x]` in tasks.md |
+| Archive project | Use Bash tool to move directory to archive/ |
 
 ---
 

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

@@ -84,36 +84,24 @@ Implementation: BLOCKED - I will create tasks, not implement them
 
 **As an AI agent, you have two execution options:**
 
-#### **Option 1: Run CLI Command** (Recommended for most cases)
+#### **Agent Execution Protocol (v5)**
 
 1. **Validate prerequisites**:
    - Check if `.clavix/outputs/` directory exists
    - Look for PRD artifacts: `full-prd.md`, `quick-prd.md`, `mini-prd.md`, or `optimized-prompt.md`
    - **If not found**: Error inline - "No PRD found in `.clavix/outputs/`. Use `/clavix:prd` or `/clavix:summarize` first."
 
-2. **Run the CLI command**:
-   ```bash
-   clavix plan
-   ```
+2. **Read the PRD** from `.clavix/outputs/[project-name]/`
 
-   Or specify a project:
-   ```bash
-   clavix plan --project project-name
-   ```
+3. **Generate task breakdown** following Part B principles
 
-   Or generate from saved session (auto-creates mini-prd.md):
-   ```bash
-   clavix plan --session SESSION_ID
-   ```
+4. **Create `tasks.md`** using your Write tool with format specified in "Task Format Reference" below
+
+5. **Save to**: `.clavix/outputs/[project-name]/tasks.md`
 
-3. **CLI will handle**:
-   - Project selection (if multiple)
-   - Reading PRD content
-   - Generating task breakdown
-   - Creating `tasks.md` file
-   - Formatting with proper task IDs
+6. **Use exact format** (task IDs, checkboxes, structure)
 
-#### **Option 2: Generate Tasks Directly** (If agent has full PRD context)
+#### **Alternative: Generate Tasks Directly** (If agent has full PRD context)
 
 If you have the full PRD content in memory and want to generate tasks directly:
 

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

@@ -352,17 +352,17 @@ I generate different checklists based on what you're building:
 
 ---
 
-## Reference: Verification Commands
+## Reference: Verification Operations
 
-**I run these automatically - you don't need to type them:**
+**I perform these operations using my native tools:**
 
-| What I Run | When |
-|------------|------|
-| `clavix verify --latest` | Check most recent implementation |
-| `clavix verify --id <id>` | Check specific prompt |
-| `clavix verify --retry-failed` | Re-check only failed items |
-| `clavix verify --status` | Show current verification state |
-| `clavix verify --export markdown` | Generate report file |
+| Operation | How I Do It |
+|-----------|-------------|
+| Check most recent implementation | Read `.clavix/outputs/prompts/` directory, find newest file |
+| Check specific prompt | Read the specific `.clavix/outputs/prompts/<id>.md` file |
+| Run automated checks | Execute `npm test`, `npm run build`, `npm run lint` via Bash tool |
+| Update verification status | Edit the prompt file metadata with verification results |
+| Generate report | Create verification report in `.clavix/outputs/` |
 
 ---
 

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

@@ -80,7 +80,7 @@ At key workflow stages, verify your execution matches expected state. These chec
 **CHECKPOINT 2: After Each Task**
 ```
 ✓ Task completed successfully
-✓ clavix task-complete {task-id} called
+✓ tasks.md edited: - [ ] changed to - [x] for completed task
 ✓ Next task displayed automatically
 ```
 

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

@@ -66,14 +66,14 @@ IF escalation_score < 45:
 
 ```
 AFTER implementing task:
-  → RUN: clavix task-complete {task-id}
-  → NEVER manually edit tasks.md checkboxes
+  → EDIT tasks.md: Change - [ ] to - [x] for completed task
+  → Use Edit tool to update the checkbox
 
-IF task-complete succeeds:
+IF edit succeeds:
   → SHOW: Next task automatically
   → CONTINUE with next task
 
-IF task-complete fails:
+IF edit fails:
   → SHOW error to user
   → ASK: "Task completion failed: [error]. How to proceed?"
 ```
@@ -92,7 +92,7 @@ BEFORE starting /clavix:implement:
     → SAY: "All tasks complete. Consider /clavix:archive"
 
   IF not exists:
-    → RUN: clavix implement (to initialize)
+    → CREATE config file and start implementation
 ```
 
 ### Rule 6: File Operations
@@ -158,7 +158,6 @@ IF any verification fails:
 
 AFTER optimization complete:
   → MUST save prompt to .clavix/outputs/prompts/
-  → MUST update index file
   → SHOW: "✓ Prompt saved: [filename]"
 ```
 

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

@@ -19,10 +19,10 @@ Read: .clavix/outputs/{project}/.clavix-implement-config.json
 |-----------|-------|-------------|
 | Config missing, no PRD files | `NO_PROJECT` | Run /clavix:prd |
 | PRD exists, no tasks.md | `PRD_EXISTS` | Run /clavix:plan |
-| tasks.md exists, no config | `TASKS_EXIST` | Run clavix implement |
+| tasks.md exists, no config | `TASKS_EXIST` | Run /clavix:implement |
 | config.stats.remaining > 0 | `IMPLEMENTING` | Continue from currentTask |
 | config.stats.remaining == 0 | `ALL_COMPLETE` | Suggest /clavix:archive |
-| Project in archive/ directory | `ARCHIVED` | Use --restore to reactivate |
+| Project in archive/ directory | `ARCHIVED` | Move back from archive to restore |
 
 **Step 3: State assertion**
 Always output current state when starting a workflow:
@@ -54,22 +54,20 @@ NO_PROJECT:
 
 PRD_EXISTS:
   → /clavix:plan creates TASKS_EXIST
-  → clavix plan command creates TASKS_EXIST
 
 TASKS_EXIST:
-  → clavix implement initializes config → IMPLEMENTING
   → /clavix:implement starts tasks → IMPLEMENTING
 
 IMPLEMENTING:
-  → clavix task-complete reduces remaining
+  → Agent edits tasks.md (- [ ] → - [x]) reduces remaining
   → When remaining == 0 → ALL_COMPLETE
 
 ALL_COMPLETE:
-  → clavix archive moves to archive/ → ARCHIVED
+  → /clavix:archive moves to archive/ → ARCHIVED
   → Adding new tasks → back to IMPLEMENTING
 
 ARCHIVED:
-  → clavix archive --restore → back to previous state
+  → Agent moves project back from archive/ → back to previous state
 ```
 
 ### Prompt Lifecycle States (Separate from PRD)

package/dist/templates/slash-commands/_components/troubleshooting/vibecoder-recovery.md

@@ -21,7 +21,7 @@ When something goes wrong, help users gracefully. Always try to fix it yourself
 #### Prompt Not Found
 **What happened:** User asked about a prompt that doesn't exist
 **You try first:**
-1. Run `clavix prompts list` to see what's available
+1. List files in `.clavix/outputs/prompts/` directory to see what's available
 2. Check if there's a similar prompt ID
 
 **Say:**
@@ -37,7 +37,7 @@ When something goes wrong, help users gracefully. Always try to fix it yourself
 #### Task Not Found
 **What happened:** Tried to complete a task that doesn't exist
 **You try first:**
-1. Run `clavix implement --list` to get current tasks
+1. Read `tasks.md` file to get current tasks
 2. Check for typos in task ID
 
 **Say:**

package/dist/utils/agent-error-messages.js

@@ -17,7 +17,7 @@ export class AgentErrorMessages {
             'Agent recovery options:\n' +
             '  1. Execute /clavix:prd to generate comprehensive PRD\n' +
             '  2. Execute /clavix:summarize if conversation exists\n' +
-            '  3. Use clavix plan --session <id> if saved session available\n\n' +
+            '  3. Check .clavix/sessions/ if saved session available\n\n' +
             'Select option and execute, then retry this command.');
     }
     /**
@@ -27,8 +27,8 @@ export class AgentErrorMessages {
     static noTasksFound(projectName) {
         return (`No tasks.md found for project: ${projectName}\n\n` +
             'Agent recovery options:\n' +
-            `  1. Execute: clavix plan --project ${projectName}\n` +
-            '  2. Or execute /clavix:plan to generate interactively\n\n' +
+            `  1. Execute /clavix:plan to generate task breakdown\n` +
+            '  2. Or read PRD and generate tasks.md manually\n\n' +
             'After task generation completes, retry implementation.');
     }
     /**
@@ -38,10 +38,9 @@ export class AgentErrorMessages {
     static configNotFound() {
         return ('Configuration file not found: .clavix-implement-config.json\n\n' +
             'Agent recovery:\n' +
-            '  1. Run: clavix implement\n' +
-            '  2. Wait for user to select git strategy\n' +
-            '  3. Config will be created automatically\n' +
-            '  4. Then retry task completion\n\n' +
+            '  1. Execute /clavix:implement to initialize implementation\n' +
+            '  2. Config will be created automatically\n' +
+            '  3. Then retry task completion\n\n' +
             'This is expected on first run.');
     }
     /**
@@ -50,14 +49,15 @@ export class AgentErrorMessages {
      */
     static taskNotFound(taskId, availableTasks) {
         const taskList = availableTasks
-            .map(t => {
+            .map((t) => {
             const status = t.completed ? '[x]' : '[ ]';
             return `  ${status} ${t.id} - ${t.description}`;
         })
             .join('\n');
         return (`Task ID not found: ${taskId}\n\n` +
             'Available task IDs:\n' +
-            taskList + '\n\n' +
+            taskList +
+            '\n\n' +
             'Select a valid task ID from the list above and retry.');
     }
     /**
@@ -93,7 +93,8 @@ export class AgentErrorMessages {
     static multiplePrdsFound(projects) {
         const projectList = projects.map((p, i) => `  ${i + 1}. ${p}`).join('\n');
         return ('Multiple PRD projects found:\n\n' +
-            projectList + '\n\n' +
+            projectList +
+            '\n\n' +
             'Agent recovery options:\n' +
             '  1. Specify project explicitly: --project <name>\n' +
             '  2. Or run CLI in interactive mode to let user select\n\n' +
@@ -134,8 +135,8 @@ export class AgentErrorMessages {
             '  • All projects already archived\n' +
             '  • No projects with completed tasks\n\n' +
             'Agent recovery options:\n' +
-            '  1. Run: clavix archive --list to see archived projects\n' +
-            '  2. Check: .clavix/outputs/ for active projects\n' +
+            '  1. List .clavix/outputs/archive/ to see archived projects\n' +
+            '  2. Check .clavix/outputs/ for active projects\n' +
             '  3. Or create new PRD with /clavix:prd');
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "Agentic-first prompt workflows. Markdown templates that teach AI agents how to optimize prompts, create PRDs, and manage implementation. Works with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",