clavix 2.6.1 → 2.7.0

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

@@ -152,6 +152,29 @@ You are helping the user archive completed PRD projects to keep their workspace
 - They're still accessible in archive directory
 - Can be restored at any time
 
+## Prompts Are Separate (v2.7+)
+
+Fast/deep prompts from `/clavix:fast` and `/clavix:deep` are stored separately in `.clavix/outputs/prompts/`.
+
+**Prompts are NOT archived with PRD projects.**
+
+**Manage prompts separately:**
+```bash
+clavix prompts list           # View all prompts
+clavix prompts clear          # Cleanup prompts
+/clavix:prompts               # Full management workflow
+```
+
+**Before archiving, consider cleanup:**
+```bash
+/clavix:prompts clear --executed
+```
+
+**Prompts lifecycle:**
+- Independent from PRD lifecycle
+- Managed via `/clavix:prompts`
+- Clear manually when project complete
+
 ## Example Workflows
 
 ### Workflow 1: Complete Project

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

@@ -153,16 +153,39 @@ Output:
 - **Deep mode** (`/clavix:deep`): Full CLEAR (C, L, E, A, R) - comprehensive analysis with alternatives and validation
 - **PRD mode** (`/clavix:prd`): CLEAR-validated PRD generation - strategic planning with architecture decisions
 
+## Next Steps (v2.7+)
+
+After deep analysis completes, the prompt is automatically saved to `.clavix/outputs/prompts/deep/`.
+
+**Execute immediately:**
+```bash
+/clavix:execute
+```
+
+**Review saved prompts first:**
+```bash
+/clavix:prompts
+```
+
+**Cleanup old prompts:**
+```bash
+clavix prompts clear --deep
+```
+
 ## Workflow Navigation
 
 **You are here:** Deep Mode (Comprehensive CLEAR Analysis)
 
 **Common workflows:**
+- **Quick execute**: `/clavix:deep` → `/clavix:execute` → Implement
+- **Review first**: `/clavix:deep` → `/clavix:prompts` → `/clavix:execute`
 - **Thorough analysis**: `/clavix:deep` → Use optimized prompt + alternatives
 - **Escalate to strategic**: `/clavix:deep` → (detects strategic scope) → `/clavix:prd` → Plan → Implement → Archive
 - **From fast mode**: `/clavix:fast` → (suggests) `/clavix:deep` → Full analysis with A & R components
 
 **Related commands:**
+- `/clavix:execute` - Execute saved prompt
+- `/clavix:prompts` - Manage saved prompts
 - `/clavix:fast` - Quick CLEAR improvements (C, L, E only)
 - `/clavix:prd` - Strategic PRD generation for architecture/business decisions
 - `/clavix:start` - Conversational mode for exploring unclear requirements

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

@@ -0,0 +1,80 @@
+---
+name: "Clavix: Execute"
+description: Execute saved prompts from fast/deep optimization
+---
+
+# Clavix: Execute Saved Prompts
+
+Implement optimized prompts from `/clavix:fast` or `/clavix:deep`.
+
+Prompts are automatically saved to `.clavix/outputs/prompts/fast/` or `.clavix/outputs/prompts/deep/`.
+
+## Prerequisites
+
+Save a prompt first:
+```bash
+/clavix:fast "your prompt"
+# or
+/clavix:deep "your prompt"
+```
+
+## Usage
+
+**Execute latest prompt (recommended):**
+```bash
+clavix execute --latest
+```
+
+**Execute latest fast/deep:**
+```bash
+clavix execute --latest --fast
+clavix execute --latest --deep
+```
+
+**Interactive selection:**
+```bash
+clavix execute
+```
+
+**Execute specific prompt:**
+```bash
+clavix execute --id <prompt-id>
+```
+
+## Agent Workflow
+
+1. Run `clavix execute --latest`
+2. Read displayed prompt content
+3. Implement requirements
+4. Cleanup: `/clavix:prompts clear`
+
+## Prompt Management
+
+**List all saved prompts:**
+```bash
+clavix prompts list
+```
+
+**Clear executed prompts:**
+```bash
+clavix prompts clear --executed
+```
+
+**Clear all fast/deep prompts:**
+```bash
+clavix prompts clear --fast
+clavix prompts clear --deep
+```
+
+## Error Recovery
+
+**No prompts found:**
+```bash
+/clavix:fast "your requirement"
+```
+Then retry `/clavix:execute`.
+
+**Too many old prompts:**
+```bash
+clavix prompts clear --executed
+```

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

@@ -136,16 +136,38 @@ Success Criteria:
 [E] Added explicit specifications: React TypeScript persona, component output format, production-ready tone, accessibility criteria
 ```
 
+## Next Steps (v2.7+)
+
+After fast optimization completes, the prompt is automatically saved to `.clavix/outputs/prompts/fast/`.
+
+**Execute immediately:**
+```bash
+/clavix:execute
+```
+
+**Review saved prompts first:**
+```bash
+/clavix:prompts
+```
+
+**Cleanup old prompts:**
+```bash
+clavix prompts clear --fast
+```
+
 ## Workflow Navigation
 
 **You are here:** Fast Mode (Quick CLEAR Improvement)
 
 **Common workflows:**
-- **Quick cleanup**: `/clavix:fast` → Use improved prompt
+- **Quick cleanup**: `/clavix:fast` → `/clavix:execute` → Implement
+- **Review first**: `/clavix:fast` → `/clavix:prompts` → `/clavix:execute`
 - **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:deep` - Full CLEAR analysis (all 5 components: C, L, E, A, R)
 - `/clavix:prd` - Generate PRD for strategic planning
 - `/clavix:start` - Conversational exploration before prompting

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

@@ -0,0 +1,97 @@
+---
+name: "Clavix: Prompts"
+description: Manage saved prompts (list, clear, inspect)
+---
+
+# Clavix: Prompts Management
+
+Manage your saved fast/deep prompts with lifecycle awareness.
+
+## List All Prompts
+
+```bash
+clavix prompts list
+```
+
+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
+```
+
+**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
+```
+
+## 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
+
+**Safety:**
+- System warns before deleting unexecuted prompts
+- Interactive mode shows what will be deleted
+- Prompts are in `.clavix/outputs/prompts/` for manual recovery
+
+## Prompt Lifecycle
+
+```
+CREATE   → /clavix:fast or /clavix:deep
+REVIEW   → /clavix:prompts (you are here)
+EXECUTE  → /clavix:execute
+CLEANUP  → /clavix:prompts clear
+```
+
+## Common Workflows
+
+**Quick execute (no review):**
+```bash
+/clavix:fast "task"
+/clavix:execute --latest
+```
+
+**Review before executing:**
+```bash
+/clavix:fast "task"
+/clavix:prompts              # Review
+/clavix:execute              # Select interactively
+/clavix:prompts clear --executed
+```
+
+**Batch cleanup:**
+```bash
+/clavix:prompts              # See stats
+clavix prompts clear --executed
+clavix prompts clear --stale
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "2.6.1",
+  "version": "2.7.0",
   "description": "Transform vague ideas into production-ready prompts. AI agent tool with CLI interface using the CLEAR framework to analyze, improve, and generate PRDs for AI coding assistants (Claude Code, Cursor, Windsurf, and more)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -57,6 +57,7 @@
     "uuid": "^9.0.1"
   },
   "devDependencies": {
+    "@oclif/test": "^4.1.15",
     "@types/fs-extra": "^11.0.4",
     "@types/handlebars": "^4.0.40",
     "@types/inquirer": "^9.0.9",