@nolrm/contextkit 0.12.7 → 0.12.8

package/README.md

@@ -165,6 +165,7 @@ ContextKit installs reusable slash commands for supported platforms:
 | `/refactor` | Refactor code with safety checks |
 | `/test` | Generate comprehensive tests |
 | `/doc` | Add documentation |
+| `/spec` | Write a component spec (MD-first) before any code is created |
 | `/squad` | Kick off a squad task — write the PO spec |
 | `/squad-architect` | Design the technical plan from the PO spec |
 | `/squad-dev` | Implement code following the architect plan |

package/lib/commands/install.js

@@ -577,6 +577,10 @@ Run \`ck analyze\` to generate this content, or manually add your API pattern be
         `${this.repoUrl}/commands/create-component.md`,
         '.contextkit/commands/create-component.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/spec.md`,
+        '.contextkit/commands/spec.md'
+      );
 
       // Download squad commands
       await this.downloadManager.downloadFile(

package/lib/commands/update.js

@@ -248,6 +248,10 @@ class UpdateCommand {
         `${this.repoUrl}/commands/create-component.md`,
         '.contextkit/commands/create-component.md'
       );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/spec.md`,
+        '.contextkit/commands/spec.md'
+      );
 
       // Download squad commands
       await this.downloadManager.downloadFile(

package/lib/integrations/claude-integration.js

@@ -25,6 +25,7 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/commands/squad-batch.md',
       '.claude/commands/squad-run.md',
       '.claude/commands/squad-run-agents.md',
+      '.claude/commands/spec.md',
       '.claude/commands/ck.md',
     ];
     this.platformDir = '.claude/rules';
@@ -192,6 +193,13 @@ Generate or run tests for the specified code, covering happy paths, edge cases,
 Read \`.contextkit/commands/add-documentation.md\` and execute the documentation workflow.
 
 Add inline docs, README sections, and usage examples for the specified code.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/spec.md', `# Spec
+
+Read \`.contextkit/commands/spec.md\` and execute the spec workflow.
+
+Write a component spec (MD-first) before any code is created. Scaffold the spec file colocated with the component and wait for review before coding begins.
 `);
 
     // Squad slash commands

package/lib/integrations/cursor-integration.js

@@ -134,6 +134,7 @@ Reference: @.contextkit/standards/code-style.md
 ## Commands
 
 - @.contextkit/commands/create-component.md — Create component workflow
+- @.contextkit/commands/spec.md — Write a component spec before coding
 `;
     await this.writeGeneratedFile('.cursor/rules/contextkit-components.mdc', componentsRule);
 
@@ -249,6 +250,13 @@ Create handoff files for multiple tasks and write PO specs for each one. Pass al
 Read \`.contextkit/commands/squad-run.md\` and execute the pipeline runner workflow.
 
 Process all batch tasks through the remaining pipeline steps (Architect, Dev, Test, Review) sequentially.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/spec.md', `# Spec
+
+Read \`.contextkit/commands/spec.md\` and execute the spec workflow.
+
+Write a component spec (MD-first) before any code is created. Scaffold the spec file colocated with the component and wait for review before coding begins.
 `);
 
     await this.writeGeneratedFile('.cursor/prompts/ck.md', `# ContextKit Health Check
@@ -271,6 +279,7 @@ Check project setup, standards status, and integrations. Report what needs atten
     console.log(chalk.dim('    /refactor — Refactor code structure'));
     console.log(chalk.dim('    /test     — Generate or run tests'));
     console.log(chalk.dim('    /doc      — Add documentation'));
+    console.log(chalk.dim('    /spec     — Write a component spec before coding'));
     console.log(chalk.dim(''));
     console.log(chalk.dim('  Squad (multi-agent workflow):'));
     console.log(chalk.dim('    /squad "task"      — Kickoff: create handoff + PO spec'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.12.7",
+  "version": "0.12.8",
   "description": "ContextKit - Context Engineering for AI Development. Provide rich context to AI through structured MD files with standards, code guides, and documentation. Works with Cursor, Claude, Aider, VS Code Copilot, and more.",
   "main": "lib/index.js",
   "bin": {