clavix 5.6.6 → 5.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -163,7 +163,7 @@
163
163
  },
164
164
  {
165
165
  "name": "llxprt",
166
- "displayName": "LLXpert",
166
+ "displayName": "LLXPRT",
167
167
  "directory": ".llxprt/commands/clavix",
168
168
  "filenamePattern": "{name}",
169
169
  "extension": ".toml",
@@ -48,10 +48,9 @@ function transformConfig(config) {
48
48
  if (config.placeholder) {
49
49
  features.argumentPlaceholder = config.placeholder;
50
50
  }
51
- // Special handling for Claude Code (subdirectories + frontmatter + doc injection)
51
+ // Special handling for Claude Code (subdirectories + doc injection)
52
52
  if (config.specialAdapter === 'doc-injection') {
53
53
  features.supportsSubdirectories = true;
54
- features.supportsFrontmatter = true;
55
54
  features.supportsDocInjection = true;
56
55
  features.commandSeparator = ':';
57
56
  }
@@ -10,7 +10,6 @@ export declare class ClaudeCodeAdapter extends BaseAdapter {
10
10
  readonly fileExtension = ".md";
11
11
  readonly features: {
12
12
  supportsSubdirectories: boolean;
13
- supportsFrontmatter: boolean;
14
13
  };
15
14
  /**
16
15
  * Detect if Claude Code is available in the project
@@ -13,7 +13,6 @@ export class ClaudeCodeAdapter extends BaseAdapter {
13
13
  fileExtension = '.md';
14
14
  features = {
15
15
  supportsSubdirectories: true,
16
- supportsFrontmatter: false,
17
16
  };
18
17
  /**
19
18
  * Detect if Claude Code is available in the project
@@ -27,7 +27,6 @@ export declare abstract class TomlFormattingAdapter extends BaseAdapter {
27
27
  readonly fileExtension = ".toml";
28
28
  readonly features: {
29
29
  supportsSubdirectories: boolean;
30
- supportsFrontmatter: boolean;
31
30
  argumentPlaceholder: string;
32
31
  };
33
32
  protected readonly config: TomlAdapterConfig;
@@ -16,7 +16,6 @@ export class TomlFormattingAdapter extends BaseAdapter {
16
16
  fileExtension = '.toml';
17
17
  features = {
18
18
  supportsSubdirectories: true,
19
- supportsFrontmatter: false,
20
19
  argumentPlaceholder: '{{args}}',
21
20
  };
22
21
  config;
@@ -46,9 +46,5 @@ export declare class UniversalAdapter extends BaseAdapter {
46
46
  * Check if this adapter supports subdirectories
47
47
  */
48
48
  supportsSubdirectories(): boolean;
49
- /**
50
- * Check if this adapter supports frontmatter
51
- */
52
- supportsFrontmatter(): boolean;
53
49
  }
54
50
  //# sourceMappingURL=universal-adapter.d.ts.map
@@ -22,7 +22,6 @@ export class UniversalAdapter extends BaseAdapter {
22
22
  // Set features from config for interface compatibility
23
23
  this.features = {
24
24
  supportsSubdirectories: config.features.supportsSubdirectories,
25
- supportsFrontmatter: config.features.supportsFrontmatter,
26
25
  commandFormat: {
27
26
  separator: config.features.commandSeparator,
28
27
  },
@@ -102,11 +101,5 @@ export class UniversalAdapter extends BaseAdapter {
102
101
  supportsSubdirectories() {
103
102
  return this.config.features.supportsSubdirectories;
104
103
  }
105
- /**
106
- * Check if this adapter supports frontmatter
107
- */
108
- supportsFrontmatter() {
109
- return this.config.features.supportsFrontmatter;
110
- }
111
104
  }
112
105
  //# sourceMappingURL=universal-adapter.js.map
@@ -21,16 +21,20 @@ When you run `/clavix:archive`, I:
21
21
 
22
22
  ---
23
23
 
24
- ## State Assertion (REQUIRED)
24
+ ## CLAVIX MODE: Archival
25
25
 
26
- Before ANY action, output this confirmation:
26
+ **I'm in archival mode. Organizing your completed work.**
27
27
 
28
- ```
29
- **CLAVIX MODE: Archival**
30
- Mode: management
31
- Purpose: Organizing completed projects
32
- Implementation: BLOCKED (file operations only)
33
- ```
28
+ **What I'll do:**
29
+ - Find projects ready for archive
30
+ - ✓ Show you what's complete (100% tasks done)
31
+ - Move projects to archive when you confirm
32
+ - Track everything so you can restore later
33
+
34
+ **What I won't do:**
35
+ - ✗ Delete anything without explicit confirmation
36
+ - ✗ Archive projects you're still working on (unless you use --force)
37
+ - ✗ Make decisions for you - you pick what to archive
34
38
 
35
39
  ---
36
40
 
@@ -49,20 +53,16 @@ If you catch yourself doing any of these, STOP and correct:
49
53
 
50
54
  ---
51
55
 
52
- ## CLAVIX MODE: Archival
53
-
54
- **I'm in archival mode. Organizing your completed work.**
56
+ ## State Assertion (REQUIRED)
55
57
 
56
- **What I'll do:**
57
- - ✓ Find projects ready for archive
58
- - ✓ Show you what's complete (100% tasks done)
59
- - ✓ Move projects to archive when you confirm
60
- - ✓ Track everything so you can restore later
58
+ Before ANY action, output this confirmation:
61
59
 
62
- **What I won't do:**
63
- - Delete anything without explicit confirmation
64
- - ✗ Archive projects you're still working on (unless you use --force)
65
- - Make decisions for you - you pick what to archive
60
+ ```
61
+ **CLAVIX MODE: Archival**
62
+ Mode: management
63
+ Purpose: Organizing completed projects
64
+ Implementation: BLOCKED (file operations only)
65
+ ```
66
66
 
67
67
  ---
68
68
 
@@ -70,6 +70,12 @@ If you catch yourself doing any of these, STOP and correct:
70
70
 
71
71
  **I use my native tools directly - no CLI commands involved.**
72
72
 
73
+ **Tools I use:**
74
+ - **Read tool**: To read tasks.md and check completion status
75
+ - **Bash/Move**: To move directories (`mv source dest`)
76
+ - **Bash/Remove**: To delete directories (`rm -rf path`) - only with explicit confirmation
77
+ - **Glob/List**: To list projects and archive contents
78
+
73
79
  ### What I Do
74
80
 
75
81
  | What You Want | How I Do It |
@@ -90,10 +96,18 @@ I check:
90
96
 
91
97
  ### After Archiving
92
98
 
93
- I tell you:
94
- - Where the project went
95
- - How to restore it (unless you deleted it)
96
- - What to do next
99
+ I verify the operation completed and ask what you want to do next:
100
+
101
+ **Verification:**
102
+ - Confirm the project was moved/deleted
103
+ - Show the new location (for archive) or confirm removal (for delete)
104
+ - List any related files that may need cleanup
105
+
106
+ **I then ask:** "What would you like to do next?"
107
+ - Start a new project with `/clavix:prd`
108
+ - Archive another completed project
109
+ - Review archived projects
110
+ - Return to something else
97
111
 
98
112
  ### Part B: Understanding Archive Operations
99
113
 
@@ -68,35 +68,6 @@ Override auto-detection when needed:
68
68
 
69
69
  ---
70
70
 
71
- ## State Assertion (REQUIRED)
72
-
73
- Before ANY action, output this confirmation:
74
-
75
- ```
76
- **CLAVIX MODE: Implementation**
77
- Mode: implementation
78
- Purpose: Executing tasks or prompts with code generation
79
- Source: [tasks.md | prompts/ | user request]
80
- Implementation: AUTHORIZED
81
- ```
82
-
83
- ---
84
-
85
- ## Self-Correction Protocol
86
-
87
- If you catch yourself doing any of these, STOP and correct:
88
-
89
- 1. **Skipping Auto-Detection** - Not checking for tasks.md and prompts/ before asking
90
- 2. **Implementing Without Reading** - Starting code before reading the full task/prompt
91
- 3. **Skipping Verification** - Not running tests after implementation
92
- 4. **Batch Task Completion** - Marking multiple tasks done without implementing each
93
- 5. **Ignoring Blocked Tasks** - Not reporting when a task cannot be completed
94
- 6. **Capability Hallucination** - Claiming Clavix can do things it cannot
95
-
96
- **DETECT → STOP → CORRECT → RESUME**
97
-
98
- ---
99
-
100
71
  ## CLAVIX MODE: Implementation
101
72
 
102
73
  **I'm in implementation mode. Building your tasks!**
@@ -122,6 +93,35 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
122
93
 
123
94
  ---
124
95
 
96
+ ## Self-Correction Protocol
97
+
98
+ If you catch yourself doing any of these, STOP and correct:
99
+
100
+ 1. **Skipping Auto-Detection** - Not checking for tasks.md and prompts/ before asking
101
+ 2. **Implementing Without Reading** - Starting code before reading the full task/prompt
102
+ 3. **Skipping Verification** - Not running tests after implementation
103
+ 4. **Batch Task Completion** - Marking multiple tasks done without implementing each
104
+ 5. **Ignoring Blocked Tasks** - Not reporting when a task cannot be completed
105
+ 6. **Capability Hallucination** - Claiming Clavix can do things it cannot
106
+
107
+ **DETECT → STOP → CORRECT → RESUME**
108
+
109
+ ---
110
+
111
+ ## State Assertion (REQUIRED)
112
+
113
+ Before ANY action, output this confirmation:
114
+
115
+ ```
116
+ **CLAVIX MODE: Implementation**
117
+ Mode: implementation
118
+ Purpose: Executing tasks or prompts with code generation
119
+ Source: [tasks.md | prompts/ | user request]
120
+ Implementation: AUTHORIZED
121
+ ```
122
+
123
+ ---
124
+
125
125
  ## How It Works
126
126
 
127
127
  ### The Quick Version
@@ -47,6 +47,28 @@ This is a prompt improvement workflow. Your job is to ANALYZE and IMPROVE the pr
47
47
 
48
48
  ---
49
49
 
50
+ ## Self-Correction Protocol
51
+
52
+ **DETECT**: If you find yourself doing any of these mistake types:
53
+
54
+ | Type | What It Looks Like |
55
+ |------|--------------------|
56
+ | 1. Implementation Code | Writing function/class definitions, creating components, generating API endpoints |
57
+ | 2. Skipping Quality Assessment | Not scoring all 6 dimensions, jumping to improved prompt without analysis |
58
+ | 3. Wrong Depth Selection | Not explaining why standard/comprehensive was chosen |
59
+ | 4. Incomplete Pattern Application | Not showing which patterns were applied |
60
+ | 5. Missing Depth Features | In comprehensive mode: missing alternatives, edge cases, or validation |
61
+ | 6. Capability Hallucination | Claiming features Clavix doesn't have, inventing pattern names |
62
+
63
+ **STOP**: Immediately halt the incorrect action
64
+
65
+ **CORRECT**: Output:
66
+ "I apologize - I was [describe mistake]. Let me return to prompt optimization."
67
+
68
+ **RESUME**: Return to the prompt optimization workflow with correct approach.
69
+
70
+ ---
71
+
50
72
  ## State Assertion (REQUIRED)
51
73
 
52
74
  **Before starting analysis, output:**
@@ -83,28 +105,6 @@ Clavix provides a unified **improve** mode that intelligently selects the approp
83
105
 
84
106
  ---
85
107
 
86
- ## Self-Correction Protocol
87
-
88
- **DETECT**: If you find yourself doing any of these mistake types:
89
-
90
- | Type | What It Looks Like |
91
- |------|--------------------|
92
- | 1. Implementation Code | Writing function/class definitions, creating components, generating API endpoints |
93
- | 2. Skipping Quality Assessment | Not scoring all 6 dimensions, jumping to improved prompt without analysis |
94
- | 3. Wrong Depth Selection | Not explaining why standard/comprehensive was chosen |
95
- | 4. Incomplete Pattern Application | Not showing which patterns were applied |
96
- | 5. Missing Depth Features | In comprehensive mode: missing alternatives, edge cases, or validation |
97
- | 6. Capability Hallucination | Claiming features Clavix doesn't have, inventing pattern names |
98
-
99
- **STOP**: Immediately halt the incorrect action
100
-
101
- **CORRECT**: Output:
102
- "I apologize - I was [describe mistake]. Let me return to prompt optimization."
103
-
104
- **RESUME**: Return to the prompt optimization workflow with correct approach.
105
-
106
- ---
107
-
108
108
  ## Instructions
109
109
 
110
110
  1. Take the user's prompt: `{{ARGS}}`
@@ -477,10 +477,20 @@ Wait for the user to decide what to do next.
477
477
 
478
478
  **You are here:** Improve Mode (Unified Prompt Intelligence)
479
479
 
480
+ **State markers for workflow continuity:**
481
+ - If user came from `/clavix:start`: They explored conversationally, now want optimization
482
+ - If user came from `/clavix:summarize`: They have a mini-PRD, want to refine the prompt further
483
+ - If prompt is complex (score < 60%): Suggest `/clavix:prd` for comprehensive planning instead
484
+
480
485
  **Common workflows:**
481
- - **Quick cleanup**: `/clavix:improve` -> `/clavix:implement --latest` -> Build
482
- - **Force comprehensive**: `/clavix:improve --comprehensive` -> Full analysis with alternatives
483
- - **Strategic planning**: `/clavix:improve` -> (suggests) `/clavix:prd` -> Plan -> Implement -> Archive
486
+ - **Quick cleanup**: `/clavix:improve` `/clavix:implement --latest` Build
487
+ - **Force comprehensive**: `/clavix:improve --comprehensive` Full analysis with alternatives
488
+ - **Strategic planning**: `/clavix:improve` (suggests) `/clavix:prd` Plan Implement Archive
489
+
490
+ **After completion, guide user to:**
491
+ - `/clavix:implement --latest` - Build what the prompt describes
492
+ - `/clavix:prd` - If the task is larger than expected
493
+ - `/clavix:refine` - If they want to iterate on the improved prompt
484
494
 
485
495
  **Related commands:**
486
496
  - `/clavix:implement` - Execute saved prompt or tasks (IMPLEMENTATION starts here)
@@ -282,15 +282,52 @@ The generated `tasks.md` will look like:
282
282
  **Create directory if not exists**: Yes
283
283
  **Overwrite if exists**: Only with explicit user confirmation or `--overwrite` flag
284
284
 
285
+ ---
286
+
287
+ ## After Plan Generation
288
+
289
+ After creating the task breakdown, I present it and ask for verification:
290
+
291
+ **What I'll show:**
292
+ - Summary of phases and task count
293
+ - First few tasks from each phase
294
+ - Any dependencies detected
295
+
296
+ **What I'll ask:**
297
+ > "Here's your task breakdown. Before you start implementing, please verify:
298
+ > 1. Does this capture everything from your PRD?
299
+ > 2. Are the tasks in the right order?
300
+ > 3. Is the granularity right (not too big, not too small)?
301
+ >
302
+ > What would you like to do next?"
303
+
304
+ **Your options:**
305
+ 1. Start implementing with `/clavix:implement`
306
+ 2. Edit tasks.md to adjust tasks
307
+ 3. Regenerate with different granularity
308
+ 4. Go back and refine the PRD first
309
+
310
+ ---
311
+
285
312
  ## Workflow Navigation
286
313
 
287
314
  **You are here:** Plan (Task Breakdown)
288
315
 
316
+ **State markers for workflow continuity:**
317
+ - If user came from `/clavix:prd`: Full PRD available, use comprehensive task breakdown
318
+ - If user came from `/clavix:summarize`: Mini-PRD available, may need simpler task structure
319
+ - If PRD has many features: Consider grouping by feature in phases
320
+ - If PRD has dependencies: Ensure task ordering reflects them
321
+
289
322
  **Common workflows:**
290
323
  - **PRD workflow**: `/clavix:prd` → `/clavix:plan` → `/clavix:implement` → `/clavix:archive`
291
324
  - **Conversation workflow**: `/clavix:summarize` → `/clavix:plan` → `/clavix:implement` → `/clavix:archive`
292
325
  - **Standalone**: [Existing PRD] → `/clavix:plan` → Review tasks.md → `/clavix:implement`
293
326
 
327
+ **After completion, guide user to:**
328
+ - `/clavix:implement` - Start executing tasks (recommended next step)
329
+ - Edit `tasks.md` - If they want to adjust task order or granularity
330
+
294
331
  **Related commands:**
295
332
  - `/clavix:prd` - Generate PRD (typical previous step)
296
333
  - `/clavix:summarize` - Extract mini-PRD from conversation (alternative previous step)
@@ -314,11 +314,21 @@ The validation ensures generated PRDs are immediately usable for AI consumption
314
314
 
315
315
  **You are here:** Clavix Planning Mode (Strategic Planning)
316
316
 
317
+ **State markers for workflow continuity:**
318
+ - If user came from `/clavix:improve`: Prompt was too complex for simple optimization
319
+ - If user came from `/clavix:start`: They explored, now want structured planning
320
+ - If this is a greenfield project: Start with business context questions
321
+ - If modifying existing feature: Start with current state questions
322
+
317
323
  **Common workflows:**
318
324
  - **Full planning workflow**: `/clavix:prd` → `/clavix:plan` → `/clavix:implement` → `/clavix:archive`
319
325
  - **From improve mode**: `/clavix:improve` → (strategic scope detected) → `/clavix:prd`
320
326
  - **Quick to strategic**: `/clavix:improve` → (realizes complexity) → `/clavix:prd`
321
327
 
328
+ **After completion, guide user to:**
329
+ - `/clavix:plan` - Generate task breakdown from the PRD (recommended next step)
330
+ - `/clavix:refine` - If they want to iterate on the PRD
331
+
322
332
  **Related commands:**
323
333
  - `/clavix:plan` - Generate task breakdown from PRD (next step)
324
334
  - `/clavix:implement` - Execute tasks (after plan)
@@ -424,11 +424,22 @@ The `/clavix:summarize` command extracts requirements from exploratory conversat
424
424
 
425
425
  **You are here:** Summarize (Conversation Extraction)
426
426
 
427
+ **State markers for workflow continuity:**
428
+ - If user came from `/clavix:start`: There's conversation context to extract
429
+ - If user invoked directly: Look for any recent conversation in context
430
+ - If conversation was technical: Focus on implementation details in extraction
431
+ - If conversation was exploratory: Focus on requirements and goals
432
+
427
433
  **Common workflows:**
428
434
  - **Standard flow**: `/clavix:start` → [conversation] → `/clavix:summarize` → Use optimized prompt
429
435
  - **To implementation**: `/clavix:summarize` → `/clavix:plan` → `/clavix:implement` → `/clavix:archive`
430
436
  - **Standalone use**: [Any conversation] → `/clavix:summarize` → Extract and optimize
431
437
 
438
+ **After completion, guide user to:**
439
+ - `/clavix:plan` - Generate tasks from the mini-PRD (if strategic)
440
+ - `/clavix:implement --latest` - Build directly (if simple)
441
+ - `/clavix:improve` - Polish the extracted prompt further
442
+
432
443
  **Related commands:**
433
444
  - `/clavix:start` - Begin conversational exploration (typical previous step)
434
445
  - `/clavix:plan` - Generate tasks from extracted mini-PRD (next step)
@@ -27,16 +27,24 @@ My job is just to check. If something needs fixing, I'll tell you what and you d
27
27
 
28
28
  ---
29
29
 
30
- ## State Assertion (REQUIRED)
30
+ ## CLAVIX MODE: Verification
31
31
 
32
- Before ANY action, output this confirmation:
32
+ **I'm in verification mode. I check your work, not change it.**
33
33
 
34
- ```
35
- **CLAVIX MODE: Verification**
36
- Mode: verification
37
- Purpose: Checking implementation against requirements
38
- Implementation: BLOCKED (verification only)
39
- ```
34
+ **What I'll do:**
35
+ - Find the prompt you implemented
36
+ - ✓ Pull out the checklist (what should be verified)
37
+ - Run tests and checks I can automate
38
+ - Go through manual checks with you
39
+ - ✓ Generate a report of what passed/failed
40
+
41
+ **What I won't do:**
42
+ - ✗ Write code or fix issues
43
+ - ✗ Change anything in your implementation
44
+ - ✗ Skip checks without asking
45
+
46
+ **Before I start, I'll confirm:**
47
+ > "Starting verification mode. I'll check your implementation against the requirements, but I won't make any changes."
40
48
 
41
49
  ---
42
50
 
@@ -55,24 +63,16 @@ If you catch yourself doing any of these, STOP and correct:
55
63
 
56
64
  ---
57
65
 
58
- ## CLAVIX MODE: Verification
59
-
60
- **I'm in verification mode. I check your work, not change it.**
61
-
62
- **What I'll do:**
63
- - ✓ Find the prompt you implemented
64
- - ✓ Pull out the checklist (what should be verified)
65
- - ✓ Run tests and checks I can automate
66
- - ✓ Go through manual checks with you
67
- - ✓ Generate a report of what passed/failed
66
+ ## State Assertion (REQUIRED)
68
67
 
69
- **What I won't do:**
70
- - ✗ Write code or fix issues
71
- - ✗ Change anything in your implementation
72
- - ✗ Skip checks without asking
68
+ Before ANY action, output this confirmation:
73
69
 
74
- **Before I start, I'll confirm:**
75
- > "Starting verification mode. I'll check your implementation against the requirements, but I won't make any changes."
70
+ ```
71
+ **CLAVIX MODE: Verification**
72
+ Mode: verification
73
+ Purpose: Checking implementation against requirements
74
+ Implementation: BLOCKED (verification only)
75
+ ```
76
76
 
77
77
  ---
78
78
 
@@ -329,15 +329,16 @@ I generate different checklists based on what you're building:
329
329
 
330
330
  ## After Verification
331
331
 
332
+ After presenting the report, I **always ask what you want to do next**.
333
+
332
334
  ### Everything Passed! 🎉
333
335
 
334
336
  > "All checks passed! Your implementation is ready.
335
337
  >
336
- > Next steps:
337
- > - Mark tasks complete (if you haven't)
338
- > - Archive the project when you're done
339
- >
340
- > Great work!"
338
+ > **What would you like to do next?**
339
+ > 1. Archive the project with `/clavix:archive`
340
+ > 2. Continue working on something else
341
+ > 3. Review specific items in more detail"
341
342
 
342
343
  ### Some Things Failed
343
344
 
@@ -346,13 +347,17 @@ I generate different checklists based on what you're building:
346
347
  > ❌ Keyboard navigation - add tabindex
347
348
  > ❌ Empty state - add message
348
349
  >
349
- > Fix these and run verify again, or skip them if they're not critical."
350
+ > **What would you like to do next?**
351
+ > 1. Fix these issues now (I can help guide the fixes)
352
+ > 2. Re-verify after you make changes
353
+ > 3. Skip these and archive anyway
354
+ > 4. Come back to this later"
350
355
 
351
356
  ### You Want to Come Back Later
352
357
 
353
- > "Got it! I've saved this verification. You can:
358
+ > "Got it! When you're ready:
354
359
  > - Run `/clavix:verify --retry-failed` to just check the skipped/failed items
355
- > - Run `/clavix:verify --status` to see where things stand
360
+ > - Run `/clavix:verify` to do a full verification again
356
361
  >
357
362
  > No rush!"
358
363
 
@@ -389,8 +394,13 @@ I generate different checklists based on what you're building:
389
394
  | Check most recent implementation | Read `.clavix/outputs/prompts/` directory, find newest file |
390
395
  | Check specific prompt | Read the specific `.clavix/outputs/prompts/<id>.md` file |
391
396
  | Run automated checks | Execute `npm test`, `npm run build`, `npm run lint` via Bash tool |
392
- | Update verification status | Edit the prompt file metadata with verification results |
393
- | Generate report | Create verification report in `.clavix/outputs/` |
397
+ | Present report | Display verification results in chat (I do NOT save reports to files) |
398
+
399
+ **After presenting the report, I ask:** "What would you like to do next?"
400
+ - Fix the failed items
401
+ - Re-verify after making changes
402
+ - Archive the project if all passed
403
+ - Continue working on something else
394
404
 
395
405
  ---
396
406
 
@@ -441,8 +451,9 @@ When I report results, I'll indicate how confident I am:
441
451
 
442
452
  ## Agent Verification Protocol
443
453
 
444
- After completing verification, I'll summarize:
454
+ After completing verification, I'll:
445
455
 
456
+ 1. **Present the summary** (in chat, NOT saved to file):
446
457
  ```
447
458
  ✓ Verification complete for [prompt-id]
448
459
 
@@ -453,3 +464,5 @@ Results:
453
464
 
454
465
  Status: [All clear! / X items need fixing]
455
466
  ```
467
+
468
+ 2. **Ask what the user wants to do next** - I do NOT proceed without user input
@@ -18,4 +18,22 @@
18
18
 
19
19
  **RESUME**: Return to the {{MODE_NAME}} workflow with correct approach.
20
20
 
21
+ ### Recovery Patterns
22
+
23
+ **If stuck in wrong mode:**
24
+ 1. Re-read the mode declaration at the top of this template
25
+ 2. Output the state assertion to reset context
26
+ 3. Continue from the correct workflow step
27
+
28
+ **If user asks you to violate mode boundaries:**
29
+ 1. Acknowledge what they want to do
30
+ 2. Explain why this mode can't do that
31
+ 3. Suggest the correct command (e.g., "Use `/clavix:implement` to build that")
32
+
33
+ **If you made partial progress before catching the mistake:**
34
+ 1. Stop immediately - don't finish the wrong action
35
+ 2. Explain what was done incorrectly
36
+ 3. Ask user if they want to undo/revert those changes
37
+ 4. Resume from the correct workflow step
38
+
21
39
  ---
@@ -32,13 +32,18 @@ export interface DetectionConfig {
32
32
  export interface AdapterFeatures {
33
33
  /** Whether the adapter supports subdirectories in command path */
34
34
  supportsSubdirectories: boolean;
35
- /** Whether the adapter supports frontmatter in command files */
36
- supportsFrontmatter: boolean;
37
35
  /** Whether the adapter supports doc injection (CLAUDE.md, etc.) */
38
36
  supportsDocInjection: boolean;
39
37
  /** Command separator character */
40
38
  commandSeparator: CommandSeparator;
41
- /** Argument placeholder for TOML adapters */
39
+ /**
40
+ * Argument placeholder for tools that support runtime arguments.
41
+ *
42
+ * Syntax varies by tool:
43
+ * - TOML adapters (Gemini, Qwen, LLXPRT): `{{args}}` - converted at generation time
44
+ * - Some markdown adapters (Droid, OpenCode, Codex): `$ARGUMENTS` - passed through as-is
45
+ * - Most adapters: undefined - no argument support
46
+ */
42
47
  argumentPlaceholder?: string;
43
48
  }
44
49
  /**
@@ -7,7 +7,6 @@
7
7
  */
8
8
  export const DEFAULT_MD_FEATURES = {
9
9
  supportsSubdirectories: false,
10
- supportsFrontmatter: false,
11
10
  supportsDocInjection: false,
12
11
  commandSeparator: '-',
13
12
  };
@@ -16,7 +15,6 @@ export const DEFAULT_MD_FEATURES = {
16
15
  */
17
16
  export const DEFAULT_TOML_FEATURES = {
18
17
  supportsSubdirectories: true,
19
- supportsFrontmatter: false,
20
18
  supportsDocInjection: false,
21
19
  commandSeparator: ':',
22
20
  argumentPlaceholder: '{{args}}',
@@ -16,11 +16,9 @@ export interface AgentAdapter {
16
16
  validate?(): Promise<ValidationResult>;
17
17
  }
18
18
  export interface IntegrationFeatures {
19
- supportsFrontmatter?: boolean;
20
19
  supportsExecutableCommands?: boolean;
21
20
  supportsSubdirectories?: boolean;
22
21
  argumentPlaceholder?: string;
23
- frontmatterFields?: string[];
24
22
  /** Command format for slash command references in templates. Default: colon (:) */
25
23
  commandFormat?: {
26
24
  separator: ':' | '-';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "clavix",
3
- "version": "5.6.6",
3
+ "version": "5.7.0",
4
4
  "description": "Agentic-first prompt workflows. Markdown templates that teach AI agents how to optimize prompts, create PRDs, and manage implementation.\n\nSLASH COMMANDS (in your AI assistant):\n /clavix:improve Optimize prompts with auto-depth\n /clavix:prd Generate PRD through questions\n /clavix:plan Create task breakdown from PRD\n /clavix:implement Execute tasks with progress tracking\n /clavix:start Begin conversational session\n /clavix:summarize Extract requirements from conversation\n /clavix:refine Refine existing PRD or prompt\n /clavix:verify Verify implementation against requirements\n /clavix:archive Archive completed projects\n\nWorks with Claude Code, Cursor, Windsurf, and 20 AI coding tools.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",