clavix 4.12.0 → 5.0.1

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/ |
 
 ---