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.
- package/dist/config/integrations.json +1 -1
- package/dist/core/adapter-registry.js +1 -2
- package/dist/core/adapters/claude-code-adapter.d.ts +0 -1
- package/dist/core/adapters/claude-code-adapter.js +0 -1
- package/dist/core/adapters/toml-formatting-adapter.d.ts +0 -1
- package/dist/core/adapters/toml-formatting-adapter.js +0 -1
- package/dist/core/adapters/universal-adapter.d.ts +0 -4
- package/dist/core/adapters/universal-adapter.js +0 -7
- package/dist/templates/slash-commands/_canonical/archive.md +38 -24
- package/dist/templates/slash-commands/_canonical/implement.md +29 -29
- package/dist/templates/slash-commands/_canonical/improve.md +35 -25
- package/dist/templates/slash-commands/_canonical/plan.md +37 -0
- package/dist/templates/slash-commands/_canonical/prd.md +10 -0
- package/dist/templates/slash-commands/_canonical/summarize.md +11 -0
- package/dist/templates/slash-commands/_canonical/verify.md +48 -35
- package/dist/templates/slash-commands/_components/agent-protocols/self-correction-protocol.md +18 -0
- package/dist/types/adapter-config.d.ts +8 -3
- package/dist/types/adapter-config.js +0 -2
- package/dist/types/agent.d.ts +0 -2
- package/package.json +1 -1
|
@@ -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 +
|
|
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
|
}
|
|
@@ -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;
|
|
@@ -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
|
-
##
|
|
24
|
+
## CLAVIX MODE: Archival
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
**I'm in archival mode. Organizing your completed work.**
|
|
27
27
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
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
|
-
##
|
|
53
|
-
|
|
54
|
-
**I'm in archival mode. Organizing your completed work.**
|
|
56
|
+
## State Assertion (REQUIRED)
|
|
55
57
|
|
|
56
|
-
|
|
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
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
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
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
-
|
|
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`
|
|
482
|
-
- **Force comprehensive**: `/clavix:improve --comprehensive`
|
|
483
|
-
- **Strategic planning**: `/clavix:improve`
|
|
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
|
-
##
|
|
30
|
+
## CLAVIX MODE: Verification
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
**I'm in verification mode. I check your work, not change it.**
|
|
33
33
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
-
|
|
75
|
-
|
|
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
|
-
>
|
|
337
|
-
>
|
|
338
|
-
>
|
|
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
|
-
>
|
|
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!
|
|
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
|
|
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
|
-
|
|
|
393
|
-
|
|
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
|
|
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
|
package/dist/templates/slash-commands/_components/agent-protocols/self-correction-protocol.md
CHANGED
|
@@ -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
|
-
/**
|
|
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}}',
|
package/dist/types/agent.d.ts
CHANGED
|
@@ -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.
|
|
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",
|