clavix 5.6.6 → 5.7.1

package/dist/config/integrations.json

@@ -163,7 +163,7 @@
     },
     {
       "name": "llxprt",
-      "displayName": "LLXpert",
+      "displayName": "LLXPRT",
       "directory": ".llxprt/commands/clavix",
       "filenamePattern": "{name}",
       "extension": ".toml",

package/dist/core/adapter-registry.js

@@ -48,10 +48,9 @@ function transformConfig(config) {
     if (config.placeholder) {
         features.argumentPlaceholder = config.placeholder;
     }
-    // Special handling for Claude Code (subdirectories + frontmatter + doc injection)
+    // Special handling for Claude Code (subdirectories + doc injection)
     if (config.specialAdapter === 'doc-injection') {
         features.supportsSubdirectories = true;
-        features.supportsFrontmatter = true;
         features.supportsDocInjection = true;
         features.commandSeparator = ':';
     }

package/dist/core/adapters/claude-code-adapter.d.ts

@@ -10,7 +10,6 @@ export declare class ClaudeCodeAdapter extends BaseAdapter {
     readonly fileExtension = ".md";
     readonly features: {
         supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
     };
     /**
      * Detect if Claude Code is available in the project

package/dist/core/adapters/claude-code-adapter.js

@@ -13,7 +13,6 @@ export class ClaudeCodeAdapter extends BaseAdapter {
     fileExtension = '.md';
     features = {
         supportsSubdirectories: true,
-        supportsFrontmatter: false,
     };
     /**
      * Detect if Claude Code is available in the project

package/dist/core/adapters/toml-formatting-adapter.d.ts

@@ -27,7 +27,6 @@ export declare abstract class TomlFormattingAdapter extends BaseAdapter {
     readonly fileExtension = ".toml";
     readonly features: {
         supportsSubdirectories: boolean;
-        supportsFrontmatter: boolean;
         argumentPlaceholder: string;
     };
     protected readonly config: TomlAdapterConfig;

package/dist/core/adapters/toml-formatting-adapter.js

@@ -16,7 +16,6 @@ export class TomlFormattingAdapter extends BaseAdapter {
     fileExtension = '.toml';
     features = {
         supportsSubdirectories: true,
-        supportsFrontmatter: false,
         argumentPlaceholder: '{{args}}',
     };
     config;

package/dist/core/adapters/universal-adapter.d.ts

@@ -46,9 +46,5 @@ export declare class UniversalAdapter extends BaseAdapter {
      * Check if this adapter supports subdirectories
      */
     supportsSubdirectories(): boolean;
-    /**
-     * Check if this adapter supports frontmatter
-     */
-    supportsFrontmatter(): boolean;
 }
 //# sourceMappingURL=universal-adapter.d.ts.map

package/dist/core/adapters/universal-adapter.js

@@ -22,7 +22,6 @@ export class UniversalAdapter extends BaseAdapter {
         // Set features from config for interface compatibility
         this.features = {
             supportsSubdirectories: config.features.supportsSubdirectories,
-            supportsFrontmatter: config.features.supportsFrontmatter,
             commandFormat: {
                 separator: config.features.commandSeparator,
             },
@@ -102,11 +101,5 @@ export class UniversalAdapter extends BaseAdapter {
     supportsSubdirectories() {
         return this.config.features.supportsSubdirectories;
     }
-    /**
-     * Check if this adapter supports frontmatter
-     */
-    supportsFrontmatter() {
-        return this.config.features.supportsFrontmatter;
-    }
 }
 //# sourceMappingURL=universal-adapter.js.map

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

@@ -21,16 +21,20 @@ When you run `/clavix:archive`, I:
 
 ---
 
-## State Assertion (REQUIRED)
+## CLAVIX MODE: Archival
 
-Before ANY action, output this confirmation:
+**I'm in archival mode. Organizing your completed work.**
 
-```
-**CLAVIX MODE: Archival**
-Mode: management
-Purpose: Organizing completed projects
-Implementation: BLOCKED (file operations only)
-```
+**What I'll do:**
+- ✓ Find projects ready for archive
+- ✓ Show you what's complete (100% tasks done)
+- ✓ Move projects to archive when you confirm
+- ✓ Track everything so you can restore later
+
+**What I won't do:**
+- ✗ Delete anything without explicit confirmation
+- ✗ Archive projects you're still working on (unless you use --force)
+- ✗ Make decisions for you - you pick what to archive
 
 ---
 
@@ -49,20 +53,16 @@ If you catch yourself doing any of these, STOP and correct:
 
 ---
 
-## CLAVIX MODE: Archival
-
-**I'm in archival mode. Organizing your completed work.**
+## State Assertion (REQUIRED)
 
-**What I'll do:**
-- ✓ Find projects ready for archive
-- ✓ Show you what's complete (100% tasks done)
-- ✓ Move projects to archive when you confirm
-- ✓ Track everything so you can restore later
+Before ANY action, output this confirmation:
 
-**What I won't do:**
-- ✗ Delete anything without explicit confirmation
-- ✗ Archive projects you're still working on (unless you use --force)
-- ✗ Make decisions for you - you pick what to archive
+```
+**CLAVIX MODE: Archival**
+Mode: management
+Purpose: Organizing completed projects
+Implementation: BLOCKED (file operations only)
+```
 
 ---
 
@@ -70,6 +70,12 @@ If you catch yourself doing any of these, STOP and correct:
 
 **I use my native tools directly - no CLI commands involved.**
 
+**Tools I use:**
+- **Read tool**: To read tasks.md and check completion status
+- **Bash/Move**: To move directories (`mv source dest`)
+- **Bash/Remove**: To delete directories (`rm -rf path`) - only with explicit confirmation
+- **Glob/List**: To list projects and archive contents
+
 ### What I Do
 
 | What You Want | How I Do It |
@@ -90,10 +96,18 @@ I check:
 
 ### After Archiving
 
-I tell you:
-- Where the project went
-- How to restore it (unless you deleted it)
-- What to do next
+I verify the operation completed and ask what you want to do next:
+
+**Verification:**
+- Confirm the project was moved/deleted
+- Show the new location (for archive) or confirm removal (for delete)
+- List any related files that may need cleanup
+
+**I then ask:** "What would you like to do next?"
+- Start a new project with `/clavix:prd`
+- Archive another completed project
+- Review archived projects
+- Return to something else
 
 ### Part B: Understanding Archive Operations
 
@@ -260,7 +274,7 @@ Result: Project permanently deleted
 
 ---
 
-## Agent Transparency (v5.1)
+## Agent Transparency (v5.7.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

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

@@ -68,35 +68,6 @@ Override auto-detection when needed:
 
 ---
 
-## State Assertion (REQUIRED)
-
-Before ANY action, output this confirmation:
-
-```
-**CLAVIX MODE: Implementation**
-Mode: implementation
-Purpose: Executing tasks or prompts with code generation
-Source: [tasks.md | prompts/ | user request]
-Implementation: AUTHORIZED
-```
-
----
-
-## Self-Correction Protocol
-
-If you catch yourself doing any of these, STOP and correct:
-
-1. **Skipping Auto-Detection** - Not checking for tasks.md and prompts/ before asking
-2. **Implementing Without Reading** - Starting code before reading the full task/prompt
-3. **Skipping Verification** - Not running tests after implementation
-4. **Batch Task Completion** - Marking multiple tasks done without implementing each
-5. **Ignoring Blocked Tasks** - Not reporting when a task cannot be completed
-6. **Capability Hallucination** - Claiming Clavix can do things it cannot
-
-**DETECT → STOP → CORRECT → RESUME**
-
----
-
 ## CLAVIX MODE: Implementation
 
 **I'm in implementation mode. Building your tasks!**
@@ -122,6 +93,35 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 
 ---
 
+## Self-Correction Protocol
+
+If you catch yourself doing any of these, STOP and correct:
+
+1. **Skipping Auto-Detection** - Not checking for tasks.md and prompts/ before asking
+2. **Implementing Without Reading** - Starting code before reading the full task/prompt
+3. **Skipping Verification** - Not running tests after implementation
+4. **Batch Task Completion** - Marking multiple tasks done without implementing each
+5. **Ignoring Blocked Tasks** - Not reporting when a task cannot be completed
+6. **Capability Hallucination** - Claiming Clavix can do things it cannot
+
+**DETECT → STOP → CORRECT → RESUME**
+
+---
+
+## State Assertion (REQUIRED)
+
+Before ANY action, output this confirmation:
+
+```
+**CLAVIX MODE: Implementation**
+Mode: implementation
+Purpose: Executing tasks or prompts with code generation
+Source: [tasks.md | prompts/ | user request]
+Implementation: AUTHORIZED
+```
+
+---
+
 ## How It Works
 
 ### The Quick Version
@@ -524,7 +524,7 @@ I'll explain what's wrong and what you might need to do:
 
 ---
 
-## Agent Transparency (v5.1)
+## Agent Transparency (v5.7.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

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

@@ -5,6 +5,24 @@ description: Analyze and improve prompts with auto-detected depth
 
 # Clavix: Improve Your Prompt
 
+---
+
+## What This Does
+
+When you run `/clavix:improve`, I:
+1. **Analyze your prompt quality** - 6-dimension assessment (Clarity, Efficiency, Structure, Completeness, Actionability, Specificity)
+2. **Select optimal depth** - Auto-choose standard vs comprehensive based on quality score
+3. **Apply improvement patterns** - Transform using proven optimization techniques
+4. **Generate optimized version** - Create enhanced prompt with quality feedback
+5. **Save for implementation** - Store in `.clavix/outputs/prompts/` for `/clavix:implement`
+
+**Smart Depth Selection:**
+- **Quality ≥ 75%**: Comprehensive depth (add polish and enhancements)
+- **Quality 60-74%**: User choice (borderline quality)
+- **Quality < 60%**: Standard depth (focus on basic fixes)
+
+---
+
 ## Important: This is Planning Mode
 
 This is a prompt improvement workflow. Your job is to ANALYZE and IMPROVE the prompt, then STOP.
@@ -47,6 +65,28 @@ This is a prompt improvement workflow. Your job is to ANALYZE and IMPROVE the pr
 
 ---
 
+## Self-Correction Protocol
+
+**DETECT**: If you find yourself doing any of these mistake types:
+
+| Type | What It Looks Like |
+|------|--------------------|
+| 1. Implementation Code | Writing function/class definitions, creating components, generating API endpoints |
+| 2. Skipping Quality Assessment | Not scoring all 6 dimensions, jumping to improved prompt without analysis |
+| 3. Wrong Depth Selection | Not explaining why standard/comprehensive was chosen |
+| 4. Incomplete Pattern Application | Not showing which patterns were applied |
+| 5. Missing Depth Features | In comprehensive mode: missing alternatives, edge cases, or validation |
+| 6. Capability Hallucination | Claiming features Clavix doesn't have, inventing pattern names |
+
+**STOP**: Immediately halt the incorrect action
+
+**CORRECT**: Output:
+"I apologize - I was [describe mistake]. Let me return to prompt optimization."
+
+**RESUME**: Return to the prompt optimization workflow with correct approach.
+
+---
+
 ## State Assertion (REQUIRED)
 
 **Before starting analysis, output:**
@@ -83,28 +123,6 @@ Clavix provides a unified **improve** mode that intelligently selects the approp
 
 ---
 
-## Self-Correction Protocol
-
-**DETECT**: If you find yourself doing any of these mistake types:
-
-| Type | What It Looks Like |
-|------|--------------------|
-| 1. Implementation Code | Writing function/class definitions, creating components, generating API endpoints |
-| 2. Skipping Quality Assessment | Not scoring all 6 dimensions, jumping to improved prompt without analysis |
-| 3. Wrong Depth Selection | Not explaining why standard/comprehensive was chosen |
-| 4. Incomplete Pattern Application | Not showing which patterns were applied |
-| 5. Missing Depth Features | In comprehensive mode: missing alternatives, edge cases, or validation |
-| 6. Capability Hallucination | Claiming features Clavix doesn't have, inventing pattern names |
-
-**STOP**: Immediately halt the incorrect action
-
-**CORRECT**: Output:
-"I apologize - I was [describe mistake]. Let me return to prompt optimization."
-
-**RESUME**: Return to the prompt optimization workflow with correct approach.
-
----
-
 ## Instructions
 
 1. Take the user's prompt: `{{ARGS}}`
@@ -477,10 +495,20 @@ Wait for the user to decide what to do next.
 
 **You are here:** Improve Mode (Unified Prompt Intelligence)
 
+**State markers for workflow continuity:**
+- If user came from `/clavix:start`: They explored conversationally, now want optimization
+- If user came from `/clavix:summarize`: They have a mini-PRD, want to refine the prompt further
+- If prompt is complex (score < 60%): Suggest `/clavix:prd` for comprehensive planning instead
+
 **Common workflows:**
-- **Quick cleanup**: `/clavix:improve` -> `/clavix:implement --latest` -> Build
-- **Force comprehensive**: `/clavix:improve --comprehensive` -> Full analysis with alternatives
-- **Strategic planning**: `/clavix:improve` -> (suggests) `/clavix:prd` -> Plan -> Implement -> Archive
+- **Quick cleanup**: `/clavix:improve` → `/clavix:implement --latest` → Build
+- **Force comprehensive**: `/clavix:improve --comprehensive` → Full analysis with alternatives
+- **Strategic planning**: `/clavix:improve` → (suggests) `/clavix:prd` → Plan → Implement → Archive
+
+**After completion, guide user to:**
+- `/clavix:implement --latest` - Build what the prompt describes
+- `/clavix:prd` - If the task is larger than expected
+- `/clavix:refine` - If they want to iterate on the improved prompt
 
 **Related commands:**
 - `/clavix:implement` - Execute saved prompt or tasks (IMPLEMENTATION starts here)
@@ -494,7 +522,7 @@ Wait for the user to decide what to do next.
 
 ---
 
-## Agent Transparency (v5.1)
+## Agent Transparency (v5.7.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

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

@@ -282,15 +282,52 @@ The generated `tasks.md` will look like:
 **Create directory if not exists**: Yes
 **Overwrite if exists**: Only with explicit user confirmation or `--overwrite` flag
 
+---
+
+## After Plan Generation
+
+After creating the task breakdown, I present it and ask for verification:
+
+**What I'll show:**
+- Summary of phases and task count
+- First few tasks from each phase
+- Any dependencies detected
+
+**What I'll ask:**
+> "Here's your task breakdown. Before you start implementing, please verify:
+> 1. Does this capture everything from your PRD?
+> 2. Are the tasks in the right order?
+> 3. Is the granularity right (not too big, not too small)?
+>
+> What would you like to do next?"
+
+**Your options:**
+1. Start implementing with `/clavix:implement`
+2. Edit tasks.md to adjust tasks
+3. Regenerate with different granularity
+4. Go back and refine the PRD first
+
+---
+
 ## Workflow Navigation
 
 **You are here:** Plan (Task Breakdown)
 
+**State markers for workflow continuity:**
+- If user came from `/clavix:prd`: Full PRD available, use comprehensive task breakdown
+- If user came from `/clavix:summarize`: Mini-PRD available, may need simpler task structure
+- If PRD has many features: Consider grouping by feature in phases
+- If PRD has dependencies: Ensure task ordering reflects them
+
 **Common workflows:**
 - **PRD workflow**: `/clavix:prd` → `/clavix:plan` → `/clavix:implement` → `/clavix:archive`
 - **Conversation workflow**: `/clavix:summarize` → `/clavix:plan` → `/clavix:implement` → `/clavix:archive`
 - **Standalone**: [Existing PRD] → `/clavix:plan` → Review tasks.md → `/clavix:implement`
 
+**After completion, guide user to:**
+- `/clavix:implement` - Start executing tasks (recommended next step)
+- Edit `tasks.md` - If they want to adjust task order or granularity
+
 **Related commands:**
 - `/clavix:prd` - Generate PRD (typical previous step)
 - `/clavix:summarize` - Extract mini-PRD from conversation (alternative previous step)
@@ -307,7 +344,7 @@ The generated `tasks.md` will look like:
 
 ---
 
-## Agent Transparency (v5.1)
+## Agent Transparency (v5.7.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}

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

@@ -314,11 +314,21 @@ The validation ensures generated PRDs are immediately usable for AI consumption
 
 **You are here:** Clavix Planning Mode (Strategic Planning)
 
+**State markers for workflow continuity:**
+- If user came from `/clavix:improve`: Prompt was too complex for simple optimization
+- If user came from `/clavix:start`: They explored, now want structured planning
+- If this is a greenfield project: Start with business context questions
+- If modifying existing feature: Start with current state questions
+
 **Common workflows:**
 - **Full planning workflow**: `/clavix:prd` → `/clavix:plan` → `/clavix:implement` → `/clavix:archive`
 - **From improve mode**: `/clavix:improve` → (strategic scope detected) → `/clavix:prd`
 - **Quick to strategic**: `/clavix:improve` → (realizes complexity) → `/clavix:prd`
 
+**After completion, guide user to:**
+- `/clavix:plan` - Generate task breakdown from the PRD (recommended next step)
+- `/clavix:refine` - If they want to iterate on the PRD
+
 **Related commands:**
 - `/clavix:plan` - Generate task breakdown from PRD (next step)
 - `/clavix:implement` - Execute tasks (after plan)
@@ -334,7 +344,7 @@ The validation ensures generated PRDs are immediately usable for AI consumption
 
 ---
 
-## Agent Transparency (v5.1)
+## Agent Transparency (v5.7.1)
 
 ### Agent Manual (Universal Protocols)
 {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}