clavix 5.0.1 → 5.1.1
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/cli/commands/config.js +1 -1
- package/dist/cli/commands/init.js +2 -3
- package/dist/cli/commands/update.js +1 -2
- package/dist/core/adapters/gemini-adapter.js +3 -1
- package/dist/core/adapters/llxprt-adapter.js +3 -1
- package/dist/core/doc-injector.d.ts +2 -2
- package/dist/core/doc-injector.js +12 -12
- package/dist/templates/agents/agents.md +3 -4
- package/dist/templates/agents/copilot-instructions.md +4 -5
- package/dist/templates/agents/octo.md +7 -8
- package/dist/templates/agents/warp.md +3 -4
- package/dist/templates/instructions/README.md +12 -14
- package/dist/templates/instructions/core/clavix-mode.md +10 -25
- package/dist/templates/instructions/core/mode-enforcement.md +10 -11
- package/dist/templates/slash-commands/_canonical/archive.md +5 -8
- package/dist/templates/slash-commands/_canonical/implement.md +231 -21
- package/dist/templates/slash-commands/_canonical/improve.md +11 -14
- package/dist/templates/slash-commands/_canonical/plan.md +5 -8
- package/dist/templates/slash-commands/_canonical/prd.md +5 -8
- package/dist/templates/slash-commands/_canonical/start.md +4 -7
- package/dist/templates/slash-commands/_canonical/summarize.md +6 -9
- package/dist/templates/slash-commands/_canonical/verify.md +9 -12
- package/dist/templates/slash-commands/_components/agent-protocols/AGENT_MANUAL.md +284 -0
- package/dist/types/agent.d.ts +0 -4
- package/dist/types/config.js +1 -1
- package/dist/utils/agent-error-messages.d.ts +5 -5
- package/dist/utils/agent-error-messages.js +5 -5
- package/dist/utils/error-utils.d.ts +1 -7
- package/dist/utils/error-utils.js +12 -11
- package/dist/utils/toml-templates.js +4 -1
- package/package.json +2 -7
- package/dist/templates/slash-commands/_canonical/execute.md +0 -276
- package/dist/templates/slash-commands/_components/agent-protocols/assertion-checkpoints.md +0 -122
- package/dist/templates/slash-commands/_components/agent-protocols/file-formats.md +0 -169
- package/dist/templates/slash-commands/_components/agent-protocols/quality-output.md +0 -94
- package/dist/templates/slash-commands/_components/agent-protocols/self-correction.md +0 -61
- package/dist/templates/slash-commands/_components/agent-protocols/state-assertion.md +0 -51
- package/dist/templates/slash-commands/_components/agent-protocols/verification-methods.md +0 -184
- package/dist/templates/slash-commands/_components/mode-headers/implementation-mode.md +0 -21
- package/dist/templates/slash-commands/_components/mode-headers/planning-mode.md +0 -17
- package/dist/templates/slash-commands/_components/mode-headers/self-correction.md +0 -13
- package/dist/templates/slash-commands/_components/references/intent-types.md +0 -39
- package/dist/templates/slash-commands/_components/sections/file-saving-protocol.md +0 -40
- package/dist/templates/slash-commands/_components/sections/intent-detection.md +0 -24
- package/dist/templates/slash-commands/_components/sections/pattern-visibility.md +0 -122
- package/dist/templates/slash-commands/_components/sections/quality-assessment.md +0 -26
- package/dist/templates/slash-commands/_components/sections/workflow-navigation.md +0 -13
- package/dist/templates/slash-commands/_components/troubleshooting/file-not-saved.md +0 -19
- package/dist/templates/slash-commands/_components/troubleshooting/mode-confusion.md +0 -46
- package/dist/templates/slash-commands/_components/troubleshooting/triage-escalation.md +0 -26
|
@@ -420,7 +420,7 @@ export default class Config extends Command {
|
|
|
420
420
|
}
|
|
421
421
|
displayConfig(config) {
|
|
422
422
|
this.log(` ${chalk.gray('Version:')} ${config.version}`);
|
|
423
|
-
this.log(` ${chalk.gray('Integrations:')} ${config.integrations.map(p => chalk.cyan(p)).join(', ') || chalk.gray('(none)')}`);
|
|
423
|
+
this.log(` ${chalk.gray('Integrations:')} ${config.integrations.map((p) => chalk.cyan(p)).join(', ') || chalk.gray('(none)')}`);
|
|
424
424
|
if (config.preferences) {
|
|
425
425
|
this.log(`\n ${chalk.bold('Preferences:')}`);
|
|
426
426
|
this.log(` ${chalk.gray('Auto-open outputs:')} ${config.preferences.autoOpenOutputs ? chalk.green('yes') : chalk.gray('no')}`);
|
|
@@ -305,10 +305,9 @@ All workflows are executed via slash commands that AI agents read and follow:
|
|
|
305
305
|
| \`/clavix:improve\` | Optimize prompts (auto-selects depth) |
|
|
306
306
|
| \`/clavix:prd\` | Generate PRD through guided questions |
|
|
307
307
|
| \`/clavix:plan\` | Create task breakdown from PRD |
|
|
308
|
-
| \`/clavix:implement\` | Execute tasks
|
|
308
|
+
| \`/clavix:implement\` | Execute tasks or prompts (auto-detects source) |
|
|
309
309
|
| \`/clavix:start\` | Begin conversational session |
|
|
310
310
|
| \`/clavix:summarize\` | Extract requirements from conversation |
|
|
311
|
-
| \`/clavix:execute\` | Run saved prompts |
|
|
312
311
|
| \`/clavix:verify\` | Verify implementation |
|
|
313
312
|
| \`/clavix:archive\` | Archive completed projects |
|
|
314
313
|
|
|
@@ -351,7 +350,7 @@ PRD Creation → Task Planning → Implementation → Archive
|
|
|
351
350
|
|
|
352
351
|
1. **Optimize prompt**: \`/clavix:improve\` - Analyzes and improves your prompt
|
|
353
352
|
2. **Review**: Agent lists saved prompts from \`.clavix/outputs/prompts/\`
|
|
354
|
-
3. **Execute**: \`/clavix:
|
|
353
|
+
3. **Execute**: \`/clavix:implement --latest\` - Implement when ready
|
|
355
354
|
4. **Cleanup**: Agent deletes old prompt files from \`.clavix/outputs/prompts/\`
|
|
356
355
|
|
|
357
356
|
## When to Use Which Mode
|
|
@@ -229,10 +229,9 @@ This project uses Clavix for prompt improvement and PRD generation.
|
|
|
229
229
|
| \`/clavix:improve\` | Optimize prompts (auto-selects depth) |
|
|
230
230
|
| \`/clavix:prd\` | Generate PRD through guided questions |
|
|
231
231
|
| \`/clavix:plan\` | Create task breakdown from PRD |
|
|
232
|
-
| \`/clavix:implement\` | Execute tasks
|
|
232
|
+
| \`/clavix:implement\` | Execute tasks or prompts (auto-detects source) |
|
|
233
233
|
| \`/clavix:start\` | Begin conversational session |
|
|
234
234
|
| \`/clavix:summarize\` | Extract requirements from conversation |
|
|
235
|
-
| \`/clavix:execute\` | Run saved prompts |
|
|
236
235
|
| \`/clavix:verify\` | Verify implementation |
|
|
237
236
|
| \`/clavix:archive\` | Archive completed projects |
|
|
238
237
|
|
|
@@ -22,7 +22,9 @@ export class GeminiAdapter extends BaseAdapter {
|
|
|
22
22
|
}
|
|
23
23
|
get directory() {
|
|
24
24
|
const useNamespace = this.options.useNamespace ?? true;
|
|
25
|
-
return useNamespace
|
|
25
|
+
return useNamespace
|
|
26
|
+
? path.join('.gemini', 'commands', 'clavix')
|
|
27
|
+
: path.join('.gemini', 'commands');
|
|
26
28
|
}
|
|
27
29
|
async detectProject() {
|
|
28
30
|
if (await FileSystem.exists('.gemini')) {
|
|
@@ -22,7 +22,9 @@ export class LlxprtAdapter extends BaseAdapter {
|
|
|
22
22
|
}
|
|
23
23
|
get directory() {
|
|
24
24
|
const useNamespace = this.options.useNamespace ?? true;
|
|
25
|
-
return useNamespace
|
|
25
|
+
return useNamespace
|
|
26
|
+
? path.join('.llxprt', 'commands', 'clavix')
|
|
27
|
+
: path.join('.llxprt', 'commands');
|
|
26
28
|
}
|
|
27
29
|
async detectProject() {
|
|
28
30
|
if (await FileSystem.exists('.llxprt')) {
|
|
@@ -41,13 +41,13 @@ export declare class DocInjector {
|
|
|
41
41
|
private static validateMarkdown;
|
|
42
42
|
/**
|
|
43
43
|
* Create default AGENTS.md content
|
|
44
|
-
*
|
|
44
|
+
* v5.1: Updated for consolidated implement command
|
|
45
45
|
*/
|
|
46
46
|
static getDefaultAgentsContent(): string;
|
|
47
47
|
/**
|
|
48
48
|
* Create the CLAUDE.md block content (without file wrapper)
|
|
49
49
|
* This is the single source of truth for Claude Code documentation
|
|
50
|
-
*
|
|
50
|
+
* v5.1: Consolidated execute into implement, removed prompts command
|
|
51
51
|
*/
|
|
52
52
|
static getClaudeBlockContent(): string;
|
|
53
53
|
/**
|
|
@@ -134,7 +134,7 @@ export class DocInjector {
|
|
|
134
134
|
}
|
|
135
135
|
/**
|
|
136
136
|
* Create default AGENTS.md content
|
|
137
|
-
*
|
|
137
|
+
* v5.1: Updated for consolidated implement command
|
|
138
138
|
*/
|
|
139
139
|
static getDefaultAgentsContent() {
|
|
140
140
|
return `# AI Agent Instructions
|
|
@@ -165,19 +165,19 @@ For more information, run \`clavix --help\` in your terminal.
|
|
|
165
165
|
/**
|
|
166
166
|
* Create the CLAUDE.md block content (without file wrapper)
|
|
167
167
|
* This is the single source of truth for Claude Code documentation
|
|
168
|
-
*
|
|
168
|
+
* v5.1: Consolidated execute into implement, removed prompts command
|
|
169
169
|
*/
|
|
170
170
|
static getClaudeBlockContent() {
|
|
171
171
|
return `## Clavix Integration
|
|
172
172
|
|
|
173
173
|
This project uses Clavix for prompt improvement and PRD generation. The following slash commands are available:
|
|
174
174
|
|
|
175
|
-
### Prompt Optimization
|
|
175
|
+
### Prompt Optimization
|
|
176
176
|
|
|
177
177
|
#### /clavix:improve [prompt]
|
|
178
178
|
Optimize prompts with smart depth auto-selection. Clavix analyzes your prompt quality and automatically selects the appropriate depth (standard or comprehensive). Use for all prompt optimization needs.
|
|
179
179
|
|
|
180
|
-
### PRD & Planning
|
|
180
|
+
### PRD & Planning
|
|
181
181
|
|
|
182
182
|
#### /clavix:prd
|
|
183
183
|
Launch the PRD generation workflow. Clavix will guide you through strategic questions and generate both a comprehensive PRD and a quick-reference version optimized for AI consumption.
|
|
@@ -186,9 +186,11 @@ Launch the PRD generation workflow. Clavix will guide you through strategic ques
|
|
|
186
186
|
Generate an optimized implementation task breakdown from your PRD. Creates a phased task plan with dependencies and priorities.
|
|
187
187
|
|
|
188
188
|
#### /clavix:implement
|
|
189
|
-
Execute tasks
|
|
189
|
+
Execute tasks or prompts with AI assistance. Auto-detects source: tasks.md (from PRD workflow) or prompts/ (from improve workflow). Supports automatic git commits and progress tracking.
|
|
190
190
|
|
|
191
|
-
|
|
191
|
+
Use \`--latest\` to execute most recent prompt, \`--tasks\` to force task mode.
|
|
192
|
+
|
|
193
|
+
### Session Management
|
|
192
194
|
|
|
193
195
|
#### /clavix:start
|
|
194
196
|
Enter conversational mode for iterative prompt development. Discuss your requirements naturally, and later use \`/clavix:summarize\` to extract an optimized prompt.
|
|
@@ -198,11 +200,8 @@ Analyze the current conversation and extract key requirements into a structured
|
|
|
198
200
|
|
|
199
201
|
### Utility Commands
|
|
200
202
|
|
|
201
|
-
#### /clavix:
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
#### /clavix:prompts
|
|
205
|
-
Manage your saved prompts. List, view, and organize your prompt library.
|
|
203
|
+
#### /clavix:verify
|
|
204
|
+
Verify implementation against checklist. Run automated checks and generate pass/fail reports.
|
|
206
205
|
|
|
207
206
|
#### /clavix:archive
|
|
208
207
|
Archive completed projects. Move finished PRDs and outputs to the archive for future reference.
|
|
@@ -215,7 +214,8 @@ Archive completed projects. Move finished PRDs and outputs to the archive for fu
|
|
|
215
214
|
1. Start with \`/clavix:prd\` or \`/clavix:start\` for complex features
|
|
216
215
|
2. Generate tasks with \`/clavix:plan\`
|
|
217
216
|
3. Implement with \`/clavix:implement\`
|
|
218
|
-
4.
|
|
217
|
+
4. Verify with \`/clavix:verify\`
|
|
218
|
+
5. Archive when complete with \`/clavix:archive\`
|
|
219
219
|
|
|
220
220
|
**Pro tip**: Start complex features with \`/clavix:prd\` or \`/clavix:start\` to ensure clear requirements before implementation.`;
|
|
221
221
|
}
|
|
@@ -4,7 +4,7 @@ This guide is for agents that can only read documentation (no slash-command supp
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## ⛔ CLAVIX MODE ENFORCEMENT
|
|
7
|
+
## ⛔ CLAVIX MODE ENFORCEMENT
|
|
8
8
|
|
|
9
9
|
**CRITICAL: Know which mode you're in and STOP at the right point.**
|
|
10
10
|
|
|
@@ -12,7 +12,7 @@ This guide is for agents that can only read documentation (no slash-command supp
|
|
|
12
12
|
- Improve mode - Prompt optimization only (auto-selects depth)
|
|
13
13
|
- Your role: Analyze, optimize, show improved prompt, **STOP**
|
|
14
14
|
- ❌ DO NOT implement the prompt's requirements
|
|
15
|
-
- ✅ After showing optimized prompt, tell user: "Run `/clavix:
|
|
15
|
+
- ✅ After showing optimized prompt, tell user: "Run `/clavix:implement --latest` to implement"
|
|
16
16
|
|
|
17
17
|
**PLANNING workflows** (NO CODE ALLOWED):
|
|
18
18
|
- Conversational mode, requirement extraction, PRD generation
|
|
@@ -84,10 +84,9 @@ All workflows are executed via slash commands that AI agents read and follow:
|
|
|
84
84
|
| `/clavix:improve` | Optimize prompts (auto-selects depth) |
|
|
85
85
|
| `/clavix:prd` | Generate PRD through guided questions |
|
|
86
86
|
| `/clavix:plan` | Create task breakdown from PRD |
|
|
87
|
-
| `/clavix:implement` | Execute tasks
|
|
87
|
+
| `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
|
|
88
88
|
| `/clavix:start` | Begin conversational session |
|
|
89
89
|
| `/clavix:summarize` | Extract requirements from conversation |
|
|
90
|
-
| `/clavix:execute` | Run saved prompts |
|
|
91
90
|
| `/clavix:verify` | Verify implementation |
|
|
92
91
|
| `/clavix:archive` | Archive completed projects |
|
|
93
92
|
|
|
@@ -4,7 +4,7 @@ These instructions enhance GitHub Copilot's understanding of Clavix prompt optim
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## ⛔ CLAVIX MODE ENFORCEMENT
|
|
7
|
+
## ⛔ CLAVIX MODE ENFORCEMENT
|
|
8
8
|
|
|
9
9
|
**CRITICAL: Know which mode you're in and STOP at the right point.**
|
|
10
10
|
|
|
@@ -12,7 +12,7 @@ These instructions enhance GitHub Copilot's understanding of Clavix prompt optim
|
|
|
12
12
|
- Fast/deep optimization - Prompt improvement only
|
|
13
13
|
- Your role: Analyze, optimize, show improved prompt, **STOP**
|
|
14
14
|
- ❌ DO NOT implement the prompt's requirements
|
|
15
|
-
- ✅ After showing optimized prompt, tell user: "Run `/clavix:
|
|
15
|
+
- ✅ After showing optimized prompt, tell user: "Run `/clavix:implement --latest` to implement"
|
|
16
16
|
|
|
17
17
|
**PLANNING workflows** (NO CODE ALLOWED):
|
|
18
18
|
- Conversational mode, requirement extraction, PRD generation
|
|
@@ -71,10 +71,9 @@ All workflows are executed via slash commands:
|
|
|
71
71
|
| `/clavix:improve` | Optimize prompts (auto-selects depth) |
|
|
72
72
|
| `/clavix:prd` | Generate PRD through guided questions |
|
|
73
73
|
| `/clavix:plan` | Create task breakdown from PRD |
|
|
74
|
-
| `/clavix:implement` | Execute tasks
|
|
74
|
+
| `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
|
|
75
75
|
| `/clavix:start` | Begin conversational session |
|
|
76
76
|
| `/clavix:summarize` | Extract requirements from conversation |
|
|
77
|
-
| `/clavix:execute` | Run saved prompts |
|
|
78
77
|
| `/clavix:verify` | Verify implementation |
|
|
79
78
|
| `/clavix:archive` | Archive completed projects |
|
|
80
79
|
|
|
@@ -85,7 +84,7 @@ All workflows are executed via slash commands:
|
|
|
85
84
|
**Prompt Lifecycle:**
|
|
86
85
|
1. **Optimize**: `/clavix:improve` → Analyzes and improves your prompt
|
|
87
86
|
2. **Review**: Agent reads `.clavix/outputs/prompts/*.md` to list saved prompts
|
|
88
|
-
3. **Execute**: `/clavix:
|
|
87
|
+
3. **Execute**: `/clavix:implement --latest` → Implement when ready
|
|
89
88
|
4. **Cleanup**: Agent deletes old prompt files from `.clavix/outputs/prompts/`
|
|
90
89
|
|
|
91
90
|
---
|
|
@@ -4,7 +4,7 @@ Clavix workflows optimized for Octofriend's capabilities: model switching, multi
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## ⛔ CLAVIX MODE ENFORCEMENT
|
|
7
|
+
## ⛔ CLAVIX MODE ENFORCEMENT
|
|
8
8
|
|
|
9
9
|
**CRITICAL: Know which mode you're in and STOP at the right point.**
|
|
10
10
|
|
|
@@ -12,7 +12,7 @@ Clavix workflows optimized for Octofriend's capabilities: model switching, multi
|
|
|
12
12
|
- `/clavix:improve` - Prompt optimization with smart depth auto-selection
|
|
13
13
|
- Your role: Analyze, optimize, show improved prompt, **STOP**
|
|
14
14
|
- ❌ DO NOT implement the prompt's requirements
|
|
15
|
-
- ✅ After showing optimized prompt, tell user: "Run `/clavix:
|
|
15
|
+
- ✅ After showing optimized prompt, tell user: "Run `/clavix:implement --latest` to implement"
|
|
16
16
|
|
|
17
17
|
**PLANNING workflows** (NO CODE ALLOWED):
|
|
18
18
|
- `/clavix:start`, `/clavix:summarize`, `/clavix:prd`, `/clavix:plan`
|
|
@@ -20,7 +20,7 @@ Clavix workflows optimized for Octofriend's capabilities: model switching, multi
|
|
|
20
20
|
- ❌ DO NOT implement features during these workflows
|
|
21
21
|
|
|
22
22
|
**IMPLEMENTATION workflows** (CODE ALLOWED):
|
|
23
|
-
- `/clavix:implement
|
|
23
|
+
- `/clavix:implement`
|
|
24
24
|
- Your role: Write code, execute tasks, implement features
|
|
25
25
|
- ✅ DO implement code during these workflows
|
|
26
26
|
- Mark task completion by editing tasks.md directly (`- [ ]` → `- [x]`)
|
|
@@ -132,10 +132,9 @@ Autofix handles edge cases gracefully - let it work.
|
|
|
132
132
|
| `/clavix:improve` | Optimize prompts (auto-selects depth) |
|
|
133
133
|
| `/clavix:prd` | Generate PRD through questions |
|
|
134
134
|
| `/clavix:plan` | Create task breakdown from PRD |
|
|
135
|
-
| `/clavix:implement` | Execute tasks
|
|
135
|
+
| `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
|
|
136
136
|
| `/clavix:start` | Begin conversational session |
|
|
137
137
|
| `/clavix:summarize` | Extract requirements from conversation |
|
|
138
|
-
| `/clavix:execute` | Run saved prompts |
|
|
139
138
|
| `/clavix:verify` | Verify implementation |
|
|
140
139
|
| `/clavix:archive` | Archive completed projects |
|
|
141
140
|
|
|
@@ -146,7 +145,7 @@ Autofix handles edge cases gracefully - let it work.
|
|
|
146
145
|
**When you have a saved prompt to execute:**
|
|
147
146
|
|
|
148
147
|
1. **List available prompts**: List files in `.clavix/outputs/prompts/*.md`
|
|
149
|
-
2. **Execute prompt**: `/clavix:
|
|
148
|
+
2. **Execute prompt**: `/clavix:implement --latest` - implement saved prompt
|
|
150
149
|
3. **Implement**: Agent reads the optimized prompt and implements the feature
|
|
151
150
|
|
|
152
151
|
**Note:** Slash commands save prompts as `.md` files with frontmatter metadata.
|
|
@@ -174,8 +173,8 @@ Autofix handles edge cases gracefully - let it work.
|
|
|
174
173
|
- Archives completed project
|
|
175
174
|
|
|
176
175
|
**Alternative quick paths:**
|
|
177
|
-
- **Quick improvement**: `/clavix:improve` → `/clavix:
|
|
178
|
-
- **Conversational**: `/clavix:start` → `/clavix:summarize` → `/clavix:
|
|
176
|
+
- **Quick improvement**: `/clavix:improve` → `/clavix:implement --latest` → Done
|
|
177
|
+
- **Conversational**: `/clavix:start` → `/clavix:summarize` → `/clavix:implement` → Done
|
|
179
178
|
|
|
180
179
|
---
|
|
181
180
|
|
|
@@ -4,7 +4,7 @@ Clavix helps Warp developers turn rough ideas into quality, AI-ready prompts and
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
### ⛔ CLAVIX MODE ENFORCEMENT
|
|
7
|
+
### ⛔ CLAVIX MODE ENFORCEMENT
|
|
8
8
|
|
|
9
9
|
**CRITICAL: Know which mode you're in and STOP at the right point.**
|
|
10
10
|
|
|
@@ -12,7 +12,7 @@ Clavix helps Warp developers turn rough ideas into quality, AI-ready prompts and
|
|
|
12
12
|
- Fast/deep optimization - Prompt improvement only
|
|
13
13
|
- Your role: Analyze, optimize, show improved prompt, **STOP**
|
|
14
14
|
- ❌ DO NOT implement the prompt's requirements
|
|
15
|
-
- ✅ After showing optimized prompt, tell user: "Run `/clavix:
|
|
15
|
+
- ✅ After showing optimized prompt, tell user: "Run `/clavix:implement --latest` to implement"
|
|
16
16
|
|
|
17
17
|
**PLANNING workflows** (NO CODE ALLOWED):
|
|
18
18
|
- Conversational mode, requirement extraction, PRD generation
|
|
@@ -60,10 +60,9 @@ For complete step-by-step workflows, see `.clavix/instructions/`:
|
|
|
60
60
|
| `/clavix:improve` | Optimize prompts (auto-selects depth) |
|
|
61
61
|
| `/clavix:prd` | Generate PRD through guided questions |
|
|
62
62
|
| `/clavix:plan` | Create task breakdown from PRD |
|
|
63
|
-
| `/clavix:implement` | Execute tasks
|
|
63
|
+
| `/clavix:implement` | Execute tasks or prompts (auto-detects source) |
|
|
64
64
|
| `/clavix:start` | Begin conversational session |
|
|
65
65
|
| `/clavix:summarize` | Extract requirements from conversation |
|
|
66
|
-
| `/clavix:execute` | Run saved prompts |
|
|
67
66
|
| `/clavix:verify` | Verify implementation |
|
|
68
67
|
| `/clavix:archive` | Archive completed projects |
|
|
69
68
|
|
|
@@ -4,7 +4,7 @@ This directory contains the complete instruction set for AI agents consuming Cla
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## 📐 Documentation Architecture
|
|
7
|
+
## 📐 Documentation Architecture
|
|
8
8
|
|
|
9
9
|
```
|
|
10
10
|
Canonical Templates (SOURCE OF TRUTH)
|
|
@@ -14,8 +14,7 @@ Canonical Templates (SOURCE OF TRUTH)
|
|
|
14
14
|
├── start.md - Conversational mode entry
|
|
15
15
|
├── summarize.md - Extract requirements from conversation
|
|
16
16
|
├── plan.md - Task breakdown from PRD
|
|
17
|
-
├── implement.md - Execute tasks
|
|
18
|
-
├── execute.md - Run saved prompts
|
|
17
|
+
├── implement.md - Execute tasks or prompts (auto-detection)
|
|
19
18
|
├── verify.md - Post-implementation verification
|
|
20
19
|
└── archive.md - Archive completed projects
|
|
21
20
|
↓ (referenced by)
|
|
@@ -133,7 +132,6 @@ PRD Creation → Task Planning → Implementation → Verification → Archive
|
|
|
133
132
|
| `/clavix:prd` | Planning | ✗ NO |
|
|
134
133
|
| `/clavix:plan` | Planning | ✗ NO |
|
|
135
134
|
| `/clavix:implement` | Implementation | ✓ YES |
|
|
136
|
-
| `/clavix:execute` | Implementation | ✓ YES |
|
|
137
135
|
| `/clavix:verify` | Verification | Context-dependent |
|
|
138
136
|
| `/clavix:archive` | Management | ✗ NO |
|
|
139
137
|
|
|
@@ -177,14 +175,14 @@ In v5, agents use native tools (Write, Edit, Bash) instead of CLI commands:
|
|
|
177
175
|
|
|
178
176
|
### Preventing the "Half-Update" Problem
|
|
179
177
|
|
|
180
|
-
|
|
178
|
+
Clavix includes validation to catch incomplete updates:
|
|
181
179
|
|
|
182
180
|
```bash
|
|
183
181
|
# Run before committing
|
|
184
182
|
npm run validate:consistency
|
|
185
183
|
|
|
186
184
|
# Checks performed:
|
|
187
|
-
# - No legacy command references (
|
|
185
|
+
# - No legacy command references (removed deprecated commands)
|
|
188
186
|
# - All CLI commands have templates (if required)
|
|
189
187
|
# - All templates have CLI implementations
|
|
190
188
|
# - No deprecated version references
|
|
@@ -243,12 +241,12 @@ npm run validate:consistency
|
|
|
243
241
|
|
|
244
242
|
### "Legacy command references found"
|
|
245
243
|
|
|
246
|
-
**Root cause:** Template not updated during
|
|
244
|
+
**Root cause:** Template not updated during migration
|
|
247
245
|
|
|
248
246
|
**Fix:**
|
|
249
247
|
1. Run `npm run validate:consistency` to find all occurrences
|
|
250
|
-
2. Replace legacy
|
|
251
|
-
3. Replace "fast mode"
|
|
248
|
+
2. Replace legacy commands with current equivalents (e.g., `/clavix:implement`)
|
|
249
|
+
3. Replace deprecated terminology (e.g., "fast mode" → "standard depth")
|
|
252
250
|
4. Update any navigation references
|
|
253
251
|
|
|
254
252
|
### "Template doesn't match CLI behavior"
|
|
@@ -267,14 +265,14 @@ npm run validate:consistency
|
|
|
267
265
|
## 📚 Key Files Reference
|
|
268
266
|
|
|
269
267
|
### Canonical Templates (Start Here)
|
|
270
|
-
- `improve.md` - Unified prompt optimization
|
|
268
|
+
- `improve.md` - Unified prompt optimization
|
|
271
269
|
- `prd.md` - PRD generation workflow
|
|
272
|
-
- `implement.md` - Task execution workflow
|
|
270
|
+
- `implement.md` - Task and prompt execution workflow
|
|
273
271
|
|
|
274
272
|
### Agent Protocols
|
|
275
|
-
- `_components/agent-protocols/self-correction.md` - Mistake detection
|
|
276
|
-
- `_components/agent-protocols/state-awareness.md` - Workflow state tracking
|
|
277
273
|
- `_components/agent-protocols/decision-rules.md` - Decision logic
|
|
274
|
+
- `_components/agent-protocols/state-awareness.md` - Workflow state tracking
|
|
275
|
+
- `_components/agent-protocols/error-handling.md` - Error recovery patterns
|
|
278
276
|
|
|
279
277
|
### Validation
|
|
280
278
|
- `scripts/validate-consistency.ts` - TypeScript ↔ Template validator
|
|
@@ -282,6 +280,6 @@ npm run validate:consistency
|
|
|
282
280
|
|
|
283
281
|
---
|
|
284
282
|
|
|
285
|
-
**Last updated:**
|
|
283
|
+
**Last updated:** v5.1.0
|
|
286
284
|
|
|
287
285
|
**Validation:** Run `npm run validate:consistency` before committing changes.
|
|
@@ -20,7 +20,7 @@ Clavix has **two distinct modes** based on the command type:
|
|
|
20
20
|
|
|
21
21
|
### CLAVIX IMPLEMENTATION MODE (Code Execution)
|
|
22
22
|
|
|
23
|
-
**Commands:** `/clavix:implement
|
|
23
|
+
**Commands:** `/clavix:implement`
|
|
24
24
|
|
|
25
25
|
**Your role:**
|
|
26
26
|
- Write code and implement features
|
|
@@ -44,8 +44,6 @@ Clavix has **two distinct modes** based on the command type:
|
|
|
44
44
|
| `/clavix:prd` | Planning | ✗ NO |
|
|
45
45
|
| `/clavix:plan` | Planning (Pre-Implementation) | ✗ NO |
|
|
46
46
|
| `/clavix:implement` | Implementation | ✓ YES |
|
|
47
|
-
| `/clavix:execute` | Implementation | ✓ YES |
|
|
48
|
-
| `/clavix:task-complete` | Implementation | ✓ YES |
|
|
49
47
|
|
|
50
48
|
---
|
|
51
49
|
|
|
@@ -87,9 +85,9 @@ Clavix has **two distinct modes** based on the command type:
|
|
|
87
85
|
- Output: `.clavix/outputs/{project}/tasks.md`
|
|
88
86
|
|
|
89
87
|
3. **Implementation Phase** (`/clavix:implement`)
|
|
90
|
-
- Agent executes tasks systematically
|
|
88
|
+
- Agent executes tasks or prompts systematically (auto-detects source)
|
|
91
89
|
- Mode: IMPLEMENTATION
|
|
92
|
-
-
|
|
90
|
+
- Agent edits tasks.md directly (`- [ ]` → `- [x]`) to mark progress
|
|
93
91
|
|
|
94
92
|
4. **Completion** (`/clavix:archive`)
|
|
95
93
|
- Archives completed project
|
|
@@ -104,7 +102,7 @@ Clavix has **two distinct modes** based on the command type:
|
|
|
104
102
|
**User says:** "Now implement this" or "Build this feature"
|
|
105
103
|
→ **Switch to IMPLEMENTATION MODE** if not already in implementation command
|
|
106
104
|
|
|
107
|
-
**User runs:** `/clavix:implement`
|
|
105
|
+
**User runs:** `/clavix:implement`
|
|
108
106
|
→ **You are in IMPLEMENTATION MODE** - write code
|
|
109
107
|
|
|
110
108
|
**User runs:** `/clavix:prd` or `/clavix:improve` or `/clavix:start`
|
|
@@ -199,21 +197,7 @@ export function TodoApp() {
|
|
|
199
197
|
|
|
200
198
|
---
|
|
201
199
|
|
|
202
|
-
### Scenario 4:
|
|
203
|
-
|
|
204
|
-
**Command:** `/clavix:execute` or `/clavix:execute --latest`
|
|
205
|
-
|
|
206
|
-
**Your mode:** CLAVIX IMPLEMENTATION MODE
|
|
207
|
-
|
|
208
|
-
**Actions:**
|
|
209
|
-
- Load saved prompt from fast/deep workflow
|
|
210
|
-
- Implement the feature described in the prompt
|
|
211
|
-
- Write actual code
|
|
212
|
-
- Complete the implementation
|
|
213
|
-
|
|
214
|
-
---
|
|
215
|
-
|
|
216
|
-
### Scenario 5: Ambiguous Request During Planning
|
|
200
|
+
### Scenario 4: Ambiguous Request During Planning
|
|
217
201
|
|
|
218
202
|
**User:** "What do you think about adding real-time updates?"
|
|
219
203
|
|
|
@@ -230,14 +214,14 @@ export function TodoApp() {
|
|
|
230
214
|
|
|
231
215
|
---
|
|
232
216
|
|
|
233
|
-
### Scenario
|
|
217
|
+
### Scenario 5: User Gives Direct Implementation Request
|
|
234
218
|
|
|
235
219
|
**User:** "Now implement this feature" or "Build the dashboard we discussed"
|
|
236
220
|
|
|
237
221
|
**Your mode:** Check context first
|
|
238
222
|
|
|
239
223
|
**If no `/clavix:implement` command was run:**
|
|
240
|
-
- Suggest: "To implement this, please run `/clavix:implement
|
|
224
|
+
- Suggest: "To implement this, please run `/clavix:implement`. This ensures proper task tracking and file management."
|
|
241
225
|
|
|
242
226
|
**If `/clavix:implement` command was run:**
|
|
243
227
|
- You're already in CLAVIX IMPLEMENTATION MODE
|
|
@@ -261,13 +245,14 @@ If you catch yourself implementing during a Clavix workflow:
|
|
|
261
245
|
|
|
262
246
|
**Two distinct Clavix modes:**
|
|
263
247
|
|
|
264
|
-
1. **CLAVIX PLANNING MODE** (`start`, `summarize`, `
|
|
248
|
+
1. **CLAVIX PLANNING MODE** (`start`, `summarize`, `improve`, `prd`, `plan`)
|
|
265
249
|
- Create PRDs, prompts, documentation
|
|
266
250
|
- DO NOT implement features
|
|
267
251
|
|
|
268
|
-
2. **CLAVIX IMPLEMENTATION MODE** (`implement
|
|
252
|
+
2. **CLAVIX IMPLEMENTATION MODE** (`implement`)
|
|
269
253
|
- Write code and build features
|
|
270
254
|
- DO implement what's been planned
|
|
255
|
+
- Auto-detects tasks.md or prompts/
|
|
271
256
|
|
|
272
257
|
**Standard workflow:** PRD → Plan → Implement → Archive
|
|
273
258
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Clavix Mode Enforcement
|
|
1
|
+
# Clavix Mode Enforcement v5.1
|
|
2
2
|
|
|
3
3
|
This is the authoritative reference for mode enforcement in Clavix workflows. All templates MUST adhere to these patterns.
|
|
4
4
|
|
|
@@ -8,7 +8,7 @@ This is the authoritative reference for mode enforcement in Clavix workflows. Al
|
|
|
8
8
|
|
|
9
9
|
### Planning Mode Declaration
|
|
10
10
|
|
|
11
|
-
Used in: `
|
|
11
|
+
Used in: `improve.md`, `prd.md`, `start.md`, `summarize.md`, `plan.md`
|
|
12
12
|
|
|
13
13
|
```markdown
|
|
14
14
|
## CLAVIX MODE: [Specific Planning Type]
|
|
@@ -32,7 +32,7 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
|
|
|
32
32
|
|
|
33
33
|
### Implementation Mode Declaration
|
|
34
34
|
|
|
35
|
-
Used in: `implement.md
|
|
35
|
+
Used in: `implement.md`
|
|
36
36
|
|
|
37
37
|
```markdown
|
|
38
38
|
## CLAVIX MODE: Implementation
|
|
@@ -148,7 +148,7 @@ All planning templates MUST include this protocol:
|
|
|
148
148
|
1. Planning workflow must complete first (files saved)
|
|
149
149
|
2. User must explicitly run implementation command
|
|
150
150
|
3. Do NOT switch modes based on verbal requests alone
|
|
151
|
-
4. Suggest correct command: "To implement, run `/clavix:
|
|
151
|
+
4. Suggest correct command: "To implement, run `/clavix:implement`"
|
|
152
152
|
|
|
153
153
|
### From Implementation Back to Planning
|
|
154
154
|
|
|
@@ -204,34 +204,33 @@ When updating templates, verify:
|
|
|
204
204
|
|
|
205
205
|
## Template Categories
|
|
206
206
|
|
|
207
|
-
### Planning Templates (
|
|
207
|
+
### Planning Templates (5 total)
|
|
208
208
|
|
|
209
209
|
| Template | Mode Type | Self-Correction | Primary Action |
|
|
210
210
|
|----------|-----------|-----------------|----------------|
|
|
211
|
-
| `
|
|
212
|
-
| `deep.md` | Requirements & Planning | Required | Comprehensive analysis |
|
|
211
|
+
| `improve.md` | Requirements & Planning | Required | Smart prompt optimization (auto-depth) |
|
|
213
212
|
| `prd.md` | Requirements & Planning | Required | PRD generation |
|
|
214
213
|
| `start.md` | Requirements & Planning | Required | Requirements gathering |
|
|
215
214
|
| `summarize.md` | Requirements & Planning | Required | Requirements extraction |
|
|
216
215
|
| `plan.md` | Pre-Implementation Planning | Required | Task breakdown |
|
|
217
216
|
|
|
218
|
-
### Implementation Templates (
|
|
217
|
+
### Implementation Templates (1 total)
|
|
219
218
|
|
|
220
219
|
| Template | Mode Type | Entry Validation | Primary Action |
|
|
221
220
|
|----------|-----------|------------------|----------------|
|
|
222
|
-
| `implement.md` | Implementation | Required | Task execution |
|
|
223
|
-
| `execute.md` | Implementation | Required | Prompt implementation |
|
|
221
|
+
| `implement.md` | Implementation | Required | Task or prompt execution (auto-detects source) |
|
|
224
222
|
|
|
225
223
|
### Utility Templates (2 total)
|
|
226
224
|
|
|
227
225
|
| Template | Mode | Notes |
|
|
228
226
|
|----------|------|-------|
|
|
229
227
|
| `archive.md` | Management | Project archival |
|
|
230
|
-
| `
|
|
228
|
+
| `verify.md` | Verification | Post-implementation verification |
|
|
231
229
|
|
|
232
230
|
---
|
|
233
231
|
|
|
234
232
|
## Version History
|
|
235
233
|
|
|
234
|
+
- **v5.1** (2025): Consolidated execute into implement with auto-detection, removed fast/deep in favor of unified improve
|
|
236
235
|
- **v4.0** (2024): Added self-correction protocol, standardized checkpoints, mode entry validation
|
|
237
236
|
- **v3.0** (2024): Initial mode separation between planning and implementation
|
|
@@ -232,20 +232,17 @@ Result: Project permanently deleted
|
|
|
232
232
|
|
|
233
233
|
---
|
|
234
234
|
|
|
235
|
-
## Agent Transparency (v5.
|
|
235
|
+
## Agent Transparency (v5.1)
|
|
236
236
|
|
|
237
|
-
###
|
|
238
|
-
{{INCLUDE:agent-protocols/
|
|
237
|
+
### Agent Manual (Universal Protocols)
|
|
238
|
+
{{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
|
|
239
239
|
|
|
240
|
-
###
|
|
241
|
-
{{INCLUDE:agent-protocols/
|
|
240
|
+
### CLI Reference
|
|
241
|
+
{{INCLUDE:agent-protocols/cli-reference.md}}
|
|
242
242
|
|
|
243
243
|
### Recovery Patterns
|
|
244
244
|
{{INCLUDE:troubleshooting/vibecoder-recovery.md}}
|
|
245
245
|
|
|
246
|
-
### Agent Decision Rules
|
|
247
|
-
{{INCLUDE:agent-protocols/decision-rules.md}}
|
|
248
|
-
|
|
249
246
|
## Workflow Navigation
|
|
250
247
|
|
|
251
248
|
**You are here:** Archive (Project Cleanup)
|