clavix 4.6.0 → 4.8.0

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

@@ -3,13 +3,38 @@ name: "Clavix: Deep"
 description: Comprehensive analysis with alternatives, edge cases, and validation
 ---
 
+# ⛔ STOP: OPTIMIZATION MODE - NOT IMPLEMENTATION
+
+**THIS IS A PROMPT ANALYSIS WORKFLOW. YOU MUST NOT IMPLEMENT ANYTHING.**
+
+## YOU MUST NOT:
+- ❌ Write any application code
+- ❌ Create any new files (except prompt save files)
+- ❌ Modify any existing project code
+- ❌ Start implementing the prompt's requirements
+- ❌ Generate components, functions, or features
+
+## YOU MUST:
+1. ✅ Analyze the user's prompt comprehensively
+2. ✅ Apply all intelligence patterns
+3. ✅ Show the optimized prompt + alternatives + edge cases
+4. ✅ Save the prompt (CLI command or manual)
+5. ✅ **STOP and wait** for user to run `/clavix:execute`
+
+## IF USER WANTS TO IMPLEMENT:
+Tell them: **"Run `/clavix:execute --latest` to implement this prompt."**
+
+**DO NOT IMPLEMENT YOURSELF. YOUR JOB ENDS AFTER SHOWING THE ANALYSIS.**
+
+---
+
 # Clavix Deep Mode - Clavix Intelligence™
 
 You are helping the user perform comprehensive deep analysis using Clavix Intelligence™ with full exploration features (alternatives, edge cases, validation checklists).
 
 ---
 
-## CLAVIX MODE: Requirements & Planning Only
+## CLAVIX MODE: Prompt Analysis Only
 
 **You are in Clavix deep analysis mode. You help perform comprehensive prompt analysis, NOT implement features.**
 
@@ -19,11 +44,14 @@ You are helping the user perform comprehensive deep analysis using Clavix Intell
 - ✓ Generate alternative approaches
 - ✓ Identify edge cases and validation checklists
 - ✓ Provide comprehensive quality assessments
+- ✓ Save the optimized prompt
+- ✓ **STOP** after analysis
 
 **DO NOT IMPLEMENT. DO NOT IMPLEMENT. DO NOT IMPLEMENT.**
 - ✗ DO NOT write application code for the feature
 - ✗ DO NOT implement what the prompt/PRD describes
 - ✗ DO NOT generate actual components/functions
+- ✗ DO NOT continue after showing the analysis
 
 **You are analyzing prompts, not building what they describe.**
 
@@ -455,19 +483,50 @@ Confirm:
 
 After saving completes successfully:
 
-**Execute immediately:**
+---
+
+## ⛔ STOP HERE - Agent Verification Required
+
+**Your workflow ends here. Before responding to the user:**
+
+### CLI Verification (Run This Command)
 ```bash
+clavix prompts list
+```
+
+**Verify**: Your prompt appears in the list with status "pending" or "NEW".
+
+**If verification fails**:
+- Check if file was saved to `.clavix/outputs/prompts/deep/`
+- Retry the save operation
+- Check file permissions
+
+### Required Response Ending
+
+**Your response MUST end with:**
+```
+✅ Deep analysis complete. Prompt optimized and saved.
+
+To implement this prompt, run:
 /clavix:execute --latest
 ```
 
-**Review saved prompts first:**
+**DO NOT continue to implementation. DO NOT write any code. STOP HERE.**
+
+---
+
+### Prompt Management (CLI Commands)
+
+**List all saved prompts:**
 ```bash
-/clavix:prompts
+clavix prompts list
 ```
 
-**Cleanup old prompts:**
+**Cleanup after execution:**
 ```bash
-clavix prompts clear --deep
+clavix prompts clear --executed  # Remove executed prompts
+clavix prompts clear --stale     # Remove >30 day old prompts
+clavix prompts clear --deep      # Remove all deep prompts
 ```
 
 ## Workflow Navigation
@@ -475,19 +534,21 @@ clavix prompts clear --deep
 **You are here:** Deep Mode (Comprehensive Prompt Intelligence)
 
 **Common workflows:**
-- **Quick execute**: `/clavix:deep` → `/clavix:execute` → Implement
-- **Review first**: `/clavix:deep` → `/clavix:prompts` → `/clavix:execute`
+- **Quick execute**: `/clavix:deep` → `/clavix:execute --latest` → Implement
 - **Thorough analysis**: `/clavix:deep` → Use optimized prompt + alternatives + validation
 - **Escalate to strategic**: `/clavix:deep` → (detects strategic scope) → `/clavix:prd` → Plan → Implement → Archive
 - **From fast mode**: `/clavix:fast` → (suggests) `/clavix:deep` → Full analysis with alternatives & validation
 
 **Related commands:**
-- `/clavix:execute` - Execute saved prompt
-- `/clavix:prompts` - Manage saved prompts
+- `/clavix:execute` - Execute saved prompt (IMPLEMENTATION starts here)
 - `/clavix:fast` - Quick improvements (basic optimization only)
-- `/clavix:prd` - Strategic PRD generation (Clavix Planning Mode) for architecture/business decisions
+- `/clavix:prd` - Strategic PRD generation for architecture/business decisions
 - `/clavix:start` - Conversational mode for exploring unclear requirements
 
+**CLI commands (run directly when needed):**
+- `clavix prompts list` - View saved prompts
+- `clavix prompts clear --executed` - Clean up executed prompts
+
 ## Tips
 
 - **Intent-aware optimization**: Clavix automatically detects what you're trying to achieve

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

@@ -74,26 +74,148 @@ clavix execute --id <prompt-id>
 1. Run `clavix execute --latest`
 2. Read displayed prompt content
 3. Implement requirements
-4. Cleanup: `/clavix:prompts clear`
+4. **REQUIRED: Run verification**: `clavix verify --latest`
+5. After verification passes, cleanup: `clavix prompts clear --executed`
 
-## Prompt Management
+---
+
+## ⚠️ REQUIRED: Post-Implementation Verification
+
+**Verification is a REQUIRED step after implementation.**
+
+After implementing the prompt requirements, you MUST verify your implementation against the checklist:
+
+```bash
+clavix verify --latest
+```
+
+### What Verification Does
+
+1. **Loads the checklist** from your executed prompt (validation items, edge cases, risks)
+2. **Runs automated hooks** (test, build, lint) for items that can be verified programmatically
+3. **Guides manual verification** for items requiring human judgment
+4. **Generates a verification report** with pass/fail status for each item
+
+### Verification Report
+
+The verification report shows:
+- ✅ **Passed items** - Implementation covers the requirement
+- ❌ **Failed items** - Implementation does NOT cover (with reason why)
+- ⏭️ **Skipped items** - To be verified later
+- ➖ **N/A items** - Does not apply to this implementation
+
+### Fast Mode Prompts
+
+Fast mode prompts don't have comprehensive checklists. When verifying a fast mode prompt:
+- A **basic checklist is generated** based on detected intent
+- Covers essential items (compiles, requirements met, no errors)
+- For comprehensive checklists, use `/clavix:deep` instead
+
+### Verification Commands
+
+```bash
+# Verify latest executed prompt
+clavix verify --latest
+
+# Verify specific prompt
+clavix verify --id <prompt-id>
+
+# Show verification status
+clavix verify --status
+
+# Re-run failed items only
+clavix verify --retry-failed
+
+# Export verification report
+clavix verify --export markdown
+clavix verify --export json
+```
+
+### After Verification
+
+**If all items pass:**
+```bash
+# Cleanup executed prompts
+clavix prompts clear --executed
+
+# Or archive the project
+/clavix:archive
+```
+
+**If items fail:**
+1. Review failed items and reasons
+2. Fix implementation issues
+3. Re-run verification: `clavix verify --retry-failed --id <prompt-id>`
+
+---
 
-**List all saved prompts:**
+## Prompt Management (CLI Commands)
+
+Prompts saved from `/clavix:fast` and `/clavix:deep` are stored in:
+- Fast prompts: `.clavix/outputs/prompts/fast/`
+- Deep prompts: `.clavix/outputs/prompts/deep/`
+
+### List All Saved Prompts
 ```bash
 clavix prompts list
 ```
 
-**Clear executed prompts:**
+Shows:
+- All saved prompts with age
+- Execution status (✓ executed / ○ pending)
+- Age warnings (OLD >7d, STALE >30d)
+- Storage statistics
+
+### Cleanup Workflows
+
+**After executing prompts (recommended):**
 ```bash
 clavix prompts clear --executed
 ```
 
-**Clear all fast/deep prompts:**
+**Remove stale prompts (>30 days):**
+```bash
+clavix prompts clear --stale
+```
+
+**Remove specific type:**
 ```bash
 clavix prompts clear --fast
 clavix prompts clear --deep
 ```
 
+**Interactive cleanup:**
+```bash
+clavix prompts clear
+```
+
+**Remove all (with safety checks):**
+```bash
+clavix prompts clear --all
+```
+
+### Prompt Lifecycle
+
+```
+CREATE   → /clavix:fast or /clavix:deep
+EXECUTE  → /clavix:execute (you are here)
+CLEANUP  → clavix prompts clear --executed
+```
+
+### Best Practices
+
+**Regular cleanup schedule:**
+1. After executing prompts: Clear executed
+2. Weekly: Review and clear stale
+3. Before archiving PRD: Clear related prompts
+
+**Storage hygiene:**
+- Keep <20 active prompts for performance
+- Clear executed prompts regularly
+- Review prompts >7 days old
+
+---
+
 ## Error Recovery
 
 **No prompts found:**
@@ -109,7 +231,7 @@ clavix prompts clear --executed
 
 ---
 
-## Agent Transparency (v4.4)
+## Agent Transparency (v4.7)
 
 ### File Format Reference
 {{INCLUDE:agent-protocols/file-formats.md}}

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

@@ -3,13 +3,38 @@ name: "Clavix: Fast"
 description: Quick prompt improvements with smart quality assessment and triage
 ---
 
+# ⛔ STOP: OPTIMIZATION MODE - NOT IMPLEMENTATION
+
+**THIS IS A PROMPT OPTIMIZATION WORKFLOW. YOU MUST NOT IMPLEMENT ANYTHING.**
+
+## YOU MUST NOT:
+- ❌ Write any application code
+- ❌ Create any new files (except prompt save files)
+- ❌ Modify any existing project code
+- ❌ Start implementing the prompt's requirements
+- ❌ Generate components, functions, or features
+
+## YOU MUST:
+1. ✅ Analyze the user's prompt
+2. ✅ Apply intelligence patterns
+3. ✅ Show the optimized prompt
+4. ✅ Save the prompt (CLI command or manual)
+5. ✅ **STOP and wait** for user to run `/clavix:execute`
+
+## IF USER WANTS TO IMPLEMENT:
+Tell them: **"Run `/clavix:execute --latest` to implement this prompt."**
+
+**DO NOT IMPLEMENT YOURSELF. YOUR JOB ENDS AFTER SHOWING THE OPTIMIZED PROMPT.**
+
+---
+
 # Clavix Fast Mode - Clavix Intelligence™
 
 You are helping the user improve their prompt using Clavix's fast mode, which applies Clavix Intelligence™ with smart quality assessment and triage.
 
 ---
 
-## CLAVIX MODE: Requirements & Planning Only
+## CLAVIX MODE: Prompt Optimization Only
 
 **You are in Clavix prompt optimization mode. You help analyze and optimize PROMPTS, NOT implement features.**
 
@@ -18,11 +43,14 @@ You are helping the user improve their prompt using Clavix's fast mode, which ap
 - ✓ Apply optimization patterns
 - ✓ Generate improved versions
 - ✓ Provide quality assessments
+- ✓ Save the optimized prompt
+- ✓ **STOP** after optimization
 
 **DO NOT IMPLEMENT. DO NOT IMPLEMENT. DO NOT IMPLEMENT.**
 - ✗ DO NOT write application code for the feature
 - ✗ DO NOT implement what the prompt/PRD describes
 - ✗ DO NOT generate actual components/functions
+- ✗ DO NOT continue after showing the optimized prompt
 
 **You are optimizing prompts, not building what they describe.**
 
@@ -347,23 +375,50 @@ Confirm:
 - Index file updated with new entry
 - Display success message: `✓ Prompt saved: <prompt-id>.md`
 
-### Executing the Saved Prompt
+---
 
-After saving completes successfully:
+## ⛔ STOP HERE - Agent Verification Required
 
-**Execute immediately:**
+**Your workflow ends here. Before responding to the user:**
+
+### CLI Verification (Run This Command)
 ```bash
+clavix prompts list
+```
+
+**Verify**: Your prompt appears in the list with status "pending" or "NEW".
+
+**If verification fails**:
+- Check if file was saved to `.clavix/outputs/prompts/fast/`
+- Retry the save operation
+- Check file permissions
+
+### Required Response Ending
+
+**Your response MUST end with:**
+```
+✅ Prompt optimized and saved.
+
+To implement this prompt, run:
 /clavix:execute --latest
 ```
 
-**Review saved prompts first:**
+**DO NOT continue to implementation. DO NOT write any code. STOP HERE.**
+
+---
+
+### Prompt Management (CLI Commands)
+
+**List all saved prompts:**
 ```bash
-/clavix:prompts
+clavix prompts list
 ```
 
-**Cleanup old prompts:**
+**Cleanup after execution:**
 ```bash
-clavix prompts clear --fast
+clavix prompts clear --executed  # Remove executed prompts
+clavix prompts clear --stale     # Remove >30 day old prompts
+clavix prompts clear --fast      # Remove all fast prompts
 ```
 
 ## Workflow Navigation
@@ -371,18 +426,20 @@ clavix prompts clear --fast
 **You are here:** Fast Mode (Quick Prompt Intelligence)
 
 **Common workflows:**
-- **Quick cleanup**: `/clavix:fast` → `/clavix:execute` → Implement
-- **Review first**: `/clavix:fast` → `/clavix:prompts` → `/clavix:execute`
+- **Quick cleanup**: `/clavix:fast` → `/clavix:execute --latest` → Implement
 - **Need more depth**: `/clavix:fast` → (suggests) `/clavix:deep` → Comprehensive analysis
 - **Strategic planning**: `/clavix:fast` → (suggests) `/clavix:prd` → Plan → Implement → Archive
 
 **Related commands:**
-- `/clavix:execute` - Execute saved prompt
-- `/clavix:prompts` - Manage saved prompts
+- `/clavix:execute` - Execute saved prompt (IMPLEMENTATION starts here)
 - `/clavix:deep` - Comprehensive analysis with alternatives, edge cases, validation
-- `/clavix:prd` - Generate PRD for strategic planning (Clavix Planning Mode)
+- `/clavix:prd` - Generate PRD for strategic planning
 - `/clavix:start` - Conversational exploration before prompting
 
+**CLI commands (run directly when needed):**
+- `clavix prompts list` - View saved prompts
+- `clavix prompts clear --executed` - Clean up executed prompts
+
 ## Tips
 
 - **Intent-aware optimization**: Clavix automatically detects what you're trying to achieve