@nolrm/contextkit 0.9.6 → 0.9.7

package/README.md

@@ -161,6 +161,7 @@ ContextKit installs reusable slash commands for supported platforms:
 | `/squad-review` | Review the full pipeline and give a verdict |
 | `/squad-batch` | Kick off multiple tasks at once (batch PO specs) |
 | `/squad-run` | Auto-run the remaining pipeline for batch tasks |
+| `/ck` | Health check — verify setup, standards, and integrations |
 
 **Claude Code** — available as `/analyze`, `/review`, etc. in `.claude/commands/`
 **Cursor** — available as slash commands in Chat via `.cursor/prompts/`

package/lib/commands/install.js

@@ -638,6 +638,7 @@ Run \`ck analyze\` to generate this content, or manually add your API pattern be
     await this.createCorrectionsLog();
     await this.createMetaInstructions();
     await this.createPolicyFile();
+    await this.createHealthCheckCommand();
 
     // Install platform integrations
     await this.installPlatformIntegrations(detectedTools);
@@ -1461,6 +1462,58 @@ enforcement:
     console.log(chalk.green('✅ Policy file created'));
   }
 
+  async createHealthCheckCommand() {
+    const healthCheckContent = `# ContextKit Health Check
+
+Check this project's ContextKit setup and report status.
+
+## Steps
+
+1. Check if \`.contextkit/\` directory exists. If not → STOP and tell user: "Run \`ck install\` to set up ContextKit."
+
+2. Read \`.contextkit/config.yml\` and check the \`last_analyzed\` field.
+
+3. Check each standards file for skeleton markers. Read these files and check if they contain \`<!-- Content will be generated by running: ck analyze -->\`:
+   - \`.contextkit/standards/code-style.md\`
+   - \`.contextkit/standards/testing.md\`
+   - \`.contextkit/standards/architecture.md\`
+   - \`.contextkit/standards/ai-guidelines.md\`
+   - \`.contextkit/standards/workflows.md\`
+   - \`.contextkit/standards/glossary.md\`
+
+4. Check product files for placeholder content (e.g., \`[ELEVATOR_PITCH_FROM_MISSION_MD]\`):
+   - \`.contextkit/product/mission-lite.md\`
+   - \`.contextkit/product/decisions.md\`
+   - \`.contextkit/product/roadmap.md\`
+
+5. Check which platform integrations exist:
+   - \`CLAUDE.md\` → Claude Code
+   - \`.cursor/rules/\` → Cursor
+   - \`AGENTS.md\` → Codex
+   - \`GEMINI.md\` → Gemini
+   - \`CONVENTIONS.md\` → Aider
+   - \`.windsurfrules\` → Windsurf
+   - \`.github/copilot-instructions.md\` → Copilot
+
+6. Report findings as a status summary table and list recommended next steps.
+
+## Output Format
+
+| Area | Status | Action |
+|------|--------|--------|
+| Installation | OK/Missing | \`ck install\` |
+| Standards | Populated/Skeleton | \`ck analyze\` or \`/analyze\` |
+| Product context | Populated/Placeholder | Edit \`.contextkit/product/\` files |
+| Integrations | List active | \`ck <platform>\` to add more |
+
+## Token Note
+
+If standards are still skeletons, warn that @imports in CLAUDE.md are loading empty files — wasting context tokens. Run \`/analyze\` to populate them.
+`;
+
+    await fs.writeFile('.contextkit/commands/health-check.md', healthCheckContent);
+  }
+
   showSuccessMessage(hookChoices, detectedTools = {}, projectType = '', packageManager = '') {
     console.log('');
     console.log(chalk.green('🎉 ContextKit v1.0.0 successfully installed!'));

package/lib/integrations/claude-integration.js

@@ -24,6 +24,7 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/commands/squad-review.md',
       '.claude/commands/squad-batch.md',
       '.claude/commands/squad-run.md',
+      '.claude/commands/ck.md',
     ];
     this.platformDir = '.claude/rules';
   }
@@ -240,6 +241,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('.claude/commands/ck.md', `# ContextKit Health Check
+
+Read \`.contextkit/commands/health-check.md\` and execute the health check workflow.
+
+Check project setup, standards status, and integrations. Report what needs attention.
 `);
   }
 
@@ -265,6 +273,9 @@ Process all batch tasks through the remaining pipeline steps (Architect, Dev, Te
     console.log(chalk.dim('    /squad-review      — Review and write verdict'));
     console.log(chalk.dim('    /squad-batch       — Batch kickoff: PO specs for multiple tasks'));
     console.log(chalk.dim('    /squad-run         — Auto-run pipeline for batch tasks'));
+    console.log(chalk.dim(''));
+    console.log(chalk.dim('  Health check:'));
+    console.log(chalk.dim('    /ck           — Check project setup and standards status'));
   }
 }
 

package/lib/integrations/cursor-integration.js

@@ -25,6 +25,7 @@ class CursorIntegration extends BaseIntegration {
       '.cursor/prompts/squad-review.md',
       '.cursor/prompts/squad-batch.md',
       '.cursor/prompts/squad-run.md',
+      '.cursor/prompts/ck.md',
     ];
     this.bridgeFiles = [];
     this.platformDir = '.cursor/rules';
@@ -248,6 +249,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/ck.md', `# ContextKit Health Check
+
+Read \`.contextkit/commands/health-check.md\` and execute the health check workflow.
+
+Check project setup, standards status, and integrations. Report what needs attention.
 `);
   }
 
@@ -272,6 +280,9 @@ Process all batch tasks through the remaining pipeline steps (Architect, Dev, Te
     console.log(chalk.dim('    /squad-review      — Review and write verdict'));
     console.log(chalk.dim('    /squad-batch       — Batch kickoff: PO specs for multiple tasks'));
     console.log(chalk.dim('    /squad-run         — Auto-run pipeline for batch tasks'));
+    console.log(chalk.dim(''));
+    console.log(chalk.dim('  Health check:'));
+    console.log(chalk.dim('    /ck           — Check project setup and standards status'));
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "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": {