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.
Files changed (50) hide show
  1. package/dist/cli/commands/config.js +1 -1
  2. package/dist/cli/commands/init.js +2 -3
  3. package/dist/cli/commands/update.js +1 -2
  4. package/dist/core/adapters/gemini-adapter.js +3 -1
  5. package/dist/core/adapters/llxprt-adapter.js +3 -1
  6. package/dist/core/doc-injector.d.ts +2 -2
  7. package/dist/core/doc-injector.js +12 -12
  8. package/dist/templates/agents/agents.md +3 -4
  9. package/dist/templates/agents/copilot-instructions.md +4 -5
  10. package/dist/templates/agents/octo.md +7 -8
  11. package/dist/templates/agents/warp.md +3 -4
  12. package/dist/templates/instructions/README.md +12 -14
  13. package/dist/templates/instructions/core/clavix-mode.md +10 -25
  14. package/dist/templates/instructions/core/mode-enforcement.md +10 -11
  15. package/dist/templates/slash-commands/_canonical/archive.md +5 -8
  16. package/dist/templates/slash-commands/_canonical/implement.md +231 -21
  17. package/dist/templates/slash-commands/_canonical/improve.md +11 -14
  18. package/dist/templates/slash-commands/_canonical/plan.md +5 -8
  19. package/dist/templates/slash-commands/_canonical/prd.md +5 -8
  20. package/dist/templates/slash-commands/_canonical/start.md +4 -7
  21. package/dist/templates/slash-commands/_canonical/summarize.md +6 -9
  22. package/dist/templates/slash-commands/_canonical/verify.md +9 -12
  23. package/dist/templates/slash-commands/_components/agent-protocols/AGENT_MANUAL.md +284 -0
  24. package/dist/types/agent.d.ts +0 -4
  25. package/dist/types/config.js +1 -1
  26. package/dist/utils/agent-error-messages.d.ts +5 -5
  27. package/dist/utils/agent-error-messages.js +5 -5
  28. package/dist/utils/error-utils.d.ts +1 -7
  29. package/dist/utils/error-utils.js +12 -11
  30. package/dist/utils/toml-templates.js +4 -1
  31. package/package.json +2 -7
  32. package/dist/templates/slash-commands/_canonical/execute.md +0 -276
  33. package/dist/templates/slash-commands/_components/agent-protocols/assertion-checkpoints.md +0 -122
  34. package/dist/templates/slash-commands/_components/agent-protocols/file-formats.md +0 -169
  35. package/dist/templates/slash-commands/_components/agent-protocols/quality-output.md +0 -94
  36. package/dist/templates/slash-commands/_components/agent-protocols/self-correction.md +0 -61
  37. package/dist/templates/slash-commands/_components/agent-protocols/state-assertion.md +0 -51
  38. package/dist/templates/slash-commands/_components/agent-protocols/verification-methods.md +0 -184
  39. package/dist/templates/slash-commands/_components/mode-headers/implementation-mode.md +0 -21
  40. package/dist/templates/slash-commands/_components/mode-headers/planning-mode.md +0 -17
  41. package/dist/templates/slash-commands/_components/mode-headers/self-correction.md +0 -13
  42. package/dist/templates/slash-commands/_components/references/intent-types.md +0 -39
  43. package/dist/templates/slash-commands/_components/sections/file-saving-protocol.md +0 -40
  44. package/dist/templates/slash-commands/_components/sections/intent-detection.md +0 -24
  45. package/dist/templates/slash-commands/_components/sections/pattern-visibility.md +0 -122
  46. package/dist/templates/slash-commands/_components/sections/quality-assessment.md +0 -26
  47. package/dist/templates/slash-commands/_components/sections/workflow-navigation.md +0 -13
  48. package/dist/templates/slash-commands/_components/troubleshooting/file-not-saved.md +0 -19
  49. package/dist/templates/slash-commands/_components/troubleshooting/mode-confusion.md +0 -46
  50. 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 with progress tracking |
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:execute\` - Implement when ready
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 with progress tracking |
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 ? path.join('.gemini', 'commands', 'clavix') : path.join('.gemini', 'commands');
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 ? path.join('.llxprt', 'commands', 'clavix') : path.join('.llxprt', 'commands');
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
- * v4.11: Updated for unified /clavix:improve command
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
- * v4.11: Updated for unified /clavix:improve command
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
- * v4.11: Updated for unified /clavix:improve command
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
- * v4.11: Updated for unified /clavix:improve command
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 Commands
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 Commands
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 from your task plan with AI assistance. Supports automatic git commits and progress tracking.
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
- ### Session Management Commands
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:execute
202
- Run saved prompts with lifecycle awareness. Execute previously optimized prompts.
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. Archive when complete with \`/clavix:archive\`
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 (v4.7)
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:execute --latest` to implement"
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 with progress tracking |
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 (v4.7)
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:execute --latest` to implement"
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 with progress tracking |
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:execute` → Implement when ready
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 (v4.11)
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:execute --latest` to implement"
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`, `/clavix:execute`
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 with progress tracking |
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:execute` - implement saved prompt
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:execute` → Done
178
- - **Conversational**: `/clavix:start` → `/clavix:summarize` → `/clavix:execute` → Done
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 (v4.7)
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:execute --latest` to implement"
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 with progress tracking |
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 (v4.11)
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 with progress tracking
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
- The v4.11.2 release introduced validation to catch incomplete updates:
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 (fast, deep commands removed in v4.11)
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 v4.11 migration
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 fast/deep commands with `clavix improve`
251
- 3. Replace "fast mode"/"deep mode" with "standard depth"/"comprehensive depth"
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 (v4.11)
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:** v4.11.2 (November 2025)
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`, `/clavix:execute`, `/clavix:task-complete`
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
- - Uses `task-complete` to mark progress
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` or `/clavix:execute`
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: User Runs Execute Command
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 6: User Gives Direct Implementation Request
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` or `/clavix:execute`. This ensures proper task tracking and file management."
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`, `fast`, `deep`, `prd`, `plan`)
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`, `execute`, `task-complete`)
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 v4.0
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: `fast.md`, `deep.md`, `prd.md`, `start.md`, `summarize.md`, `plan.md`
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`, `execute.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:execute` or `/clavix:implement`"
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 (6 total)
207
+ ### Planning Templates (5 total)
208
208
 
209
209
  | Template | Mode Type | Self-Correction | Primary Action |
210
210
  |----------|-----------|-----------------|----------------|
211
- | `fast.md` | Requirements & Planning | Required | Prompt optimization |
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 (2 total)
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
- | `prompts.md` | Management | Prompt management |
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.0)
235
+ ## Agent Transparency (v5.1)
236
236
 
237
- ### CLI Reference (Commands I Execute)
238
- {{INCLUDE:agent-protocols/cli-reference.md}}
237
+ ### Agent Manual (Universal Protocols)
238
+ {{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
239
239
 
240
- ### Error Handling
241
- {{INCLUDE:agent-protocols/error-handling.md}}
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)