clavix 7.2.1 → 7.2.2
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/core/adapters/agent-skills-adapter.d.ts +2 -1
- package/dist/core/adapters/agent-skills-adapter.js +10 -3
- package/dist/templates/agents/agents.md +17 -0
- package/dist/templates/slash-commands/_canonical/archive.md +1 -1
- package/dist/templates/slash-commands/_canonical/implement.md +1 -1
- package/dist/templates/slash-commands/_canonical/improve.md +1 -1
- package/dist/templates/slash-commands/_canonical/plan.md +1 -1
- package/dist/templates/slash-commands/_canonical/prd.md +1 -1
- package/dist/templates/slash-commands/_canonical/refine.md +1 -1
- package/dist/templates/slash-commands/_canonical/review.md +1 -1
- package/dist/templates/slash-commands/_canonical/start.md +1 -1
- package/dist/templates/slash-commands/_canonical/summarize.md +1 -1
- package/dist/templates/slash-commands/_canonical/verify.md +1 -1
- package/package.json +1 -1
|
@@ -45,6 +45,7 @@ export declare class AgentSkillsAdapter extends BaseAdapter {
|
|
|
45
45
|
/**
|
|
46
46
|
* Skills use directory names, not filenames
|
|
47
47
|
* Returns the skill directory name (e.g., 'clavix-improve')
|
|
48
|
+
* Special case: 'using-clavix' keeps its name (no prefix) to match superpowers pattern
|
|
48
49
|
*/
|
|
49
50
|
getTargetFilename(name: string): string;
|
|
50
51
|
/**
|
|
@@ -82,7 +83,7 @@ export declare class AgentSkillsAdapter extends BaseAdapter {
|
|
|
82
83
|
removeAllCommands(): Promise<number>;
|
|
83
84
|
/**
|
|
84
85
|
* Determine if an entry is a Clavix-generated skill
|
|
85
|
-
* Skills are directories starting with 'clavix-'
|
|
86
|
+
* Skills are directories starting with 'clavix-' or the special 'using-clavix' meta-skill
|
|
86
87
|
*/
|
|
87
88
|
protected isClavixGeneratedCommand(name: string): boolean;
|
|
88
89
|
/**
|
|
@@ -104,8 +104,13 @@ export class AgentSkillsAdapter extends BaseAdapter {
|
|
|
104
104
|
/**
|
|
105
105
|
* Skills use directory names, not filenames
|
|
106
106
|
* Returns the skill directory name (e.g., 'clavix-improve')
|
|
107
|
+
* Special case: 'using-clavix' keeps its name (no prefix) to match superpowers pattern
|
|
107
108
|
*/
|
|
108
109
|
getTargetFilename(name) {
|
|
110
|
+
// using-clavix is special - it's the meta-skill that tells agents how to use other skills
|
|
111
|
+
if (name === 'using-clavix') {
|
|
112
|
+
return 'using-clavix';
|
|
113
|
+
}
|
|
109
114
|
return `clavix-${name}`;
|
|
110
115
|
}
|
|
111
116
|
/**
|
|
@@ -147,7 +152,8 @@ export class AgentSkillsAdapter extends BaseAdapter {
|
|
|
147
152
|
* Generate a single skill directory from a command template
|
|
148
153
|
*/
|
|
149
154
|
async generateSkill(template, basePath) {
|
|
150
|
-
|
|
155
|
+
// using-clavix keeps its name (no prefix) - it's the meta-skill
|
|
156
|
+
const skillName = template.name === 'using-clavix' ? 'using-clavix' : `clavix-${template.name}`;
|
|
151
157
|
const skillDir = path.join(basePath, skillName);
|
|
152
158
|
// Ensure skill directory exists
|
|
153
159
|
await FileSystem.ensureDir(skillDir);
|
|
@@ -190,6 +196,7 @@ export class AgentSkillsAdapter extends BaseAdapter {
|
|
|
190
196
|
verify: 'Verify implementation against PRD requirements with systematic checking. Use after implementation to validate completeness.',
|
|
191
197
|
review: 'Review code changes with criteria-driven analysis (Security, Architecture, Standards, Performance). Use when reviewing PRs or code changes.',
|
|
192
198
|
archive: 'Archive completed projects by moving outputs to archive directory. Use when a project is complete and ready for archival.',
|
|
199
|
+
'using-clavix': 'Use when starting any conversation involving Clavix workflows - establishes skill invocation rules, verification requirements, and workflow orchestration',
|
|
193
200
|
};
|
|
194
201
|
return descriptionMap[name] || baseDescription;
|
|
195
202
|
}
|
|
@@ -221,10 +228,10 @@ export class AgentSkillsAdapter extends BaseAdapter {
|
|
|
221
228
|
}
|
|
222
229
|
/**
|
|
223
230
|
* Determine if an entry is a Clavix-generated skill
|
|
224
|
-
* Skills are directories starting with 'clavix-'
|
|
231
|
+
* Skills are directories starting with 'clavix-' or the special 'using-clavix' meta-skill
|
|
225
232
|
*/
|
|
226
233
|
isClavixGeneratedCommand(name) {
|
|
227
|
-
return name.startsWith('clavix-');
|
|
234
|
+
return name.startsWith('clavix-') || name === 'using-clavix';
|
|
228
235
|
}
|
|
229
236
|
/**
|
|
230
237
|
* Validate skills directory
|
|
@@ -4,6 +4,23 @@ This guide is for agents that can only read documentation (no slash-command supp
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## 🚨 FIRST: Load using-clavix Skill
|
|
8
|
+
|
|
9
|
+
**Before ANY Clavix workflow, invoke the `using-clavix` skill.**
|
|
10
|
+
|
|
11
|
+
This meta-skill establishes:
|
|
12
|
+
- Skill invocation rules (check skills BEFORE any response)
|
|
13
|
+
- Required skill chains (prd → plan → implement → verify)
|
|
14
|
+
- Iron Laws for verification (no completion claims without evidence)
|
|
15
|
+
- Workflow orchestration and fix loops
|
|
16
|
+
|
|
17
|
+
If you have even a 1% chance a Clavix skill applies, you MUST check it first.
|
|
18
|
+
|
|
19
|
+
**In environments with Skill tool:** Invoke `using-clavix` before any Clavix action.
|
|
20
|
+
**In environments without Skill tool:** Read `.config/agents/skills/using-clavix/SKILL.md` or the bundled template.
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
7
24
|
## ⛔ CLAVIX MODE ENFORCEMENT
|
|
8
25
|
|
|
9
26
|
**CRITICAL: Know which mode you're in and STOP at the right point.**
|
|
@@ -354,7 +354,7 @@ The validation ensures generated PRDs are immediately usable for AI consumption
|
|
|
354
354
|
|
|
355
355
|
---
|
|
356
356
|
|
|
357
|
-
## Agent Transparency (v7.2.
|
|
357
|
+
## Agent Transparency (v7.2.2)
|
|
358
358
|
|
|
359
359
|
### Agent Manual (Universal Protocols)
|
|
360
360
|
{{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
|
|
@@ -230,7 +230,7 @@ The goal is natural exploration of requirements, not a rigid questionnaire. Foll
|
|
|
230
230
|
|
|
231
231
|
---
|
|
232
232
|
|
|
233
|
-
## Agent Transparency (v7.2.
|
|
233
|
+
## Agent Transparency (v7.2.2)
|
|
234
234
|
|
|
235
235
|
### Agent Manual (Universal Protocols)
|
|
236
236
|
{{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
|
|
@@ -409,7 +409,7 @@ The `/clavix:summarize` command extracts requirements from exploratory conversat
|
|
|
409
409
|
|
|
410
410
|
---
|
|
411
411
|
|
|
412
|
-
## Agent Transparency (v7.2.
|
|
412
|
+
## Agent Transparency (v7.2.2)
|
|
413
413
|
|
|
414
414
|
### Agent Manual (Universal Protocols)
|
|
415
415
|
{{INCLUDE:agent-protocols/AGENT_MANUAL.md}}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "clavix",
|
|
3
|
-
"version": "7.2.
|
|
3
|
+
"version": "7.2.2",
|
|
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:review Review teammate PRs with criteria\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",
|