@nolrm/contextkit 0.12.12 → 0.12.15

package/README.md

@@ -39,7 +39,7 @@ npm i -g @nolrm/contextkit
 cd your-project
 contextkit install
 ```
-Creates `.contextkit/` with skeleton standards files in your project.
+Creates `.contextkit/` with skeleton standards files, a self-describing `README.md`, and an attribution block in `config.yml` so any developer who encounters the folder knows what manages it.
 
 **3. Generate your standards**
 
@@ -153,8 +153,8 @@ ContextKit installs reusable slash commands for supported platforms:
 | `/squad-dev` | Implement code following the architect plan |
 | `/squad-test` | Write and run tests against acceptance criteria |
 | `/squad-review` | Review the full pipeline and give a verdict |
-| `/squad-run` | Auto-run the remaining pipeline for batch tasks (sequential) |
-| `/squad-run-agents` | Auto-run the pipeline in parallel using Claude Code agents (Claude Code only) |
+| `/squad-auto` | Auto-run the full pipeline after kickoff (recommended, sequential) |
+| `/squad-auto-parallel` | Auto-run the pipeline in parallel using Claude Code agents (Claude Code only) |
 | `/ck` | Health check — verify setup, standards, and integrations |
 
 **Claude Code** — available as `/analyze`, `/review`, etc. in `.claude/commands/`
@@ -181,11 +181,14 @@ The squad workflow turns a single AI session into a structured multi-role pipeli
 ### Single-Task Flow
 
 ```bash
-/squad "add dark mode support"        # PO writes the spec
-/squad-architect                       # Architect designs the plan
-/squad-dev                             # Dev implements the code
-/squad-test                            # Tester writes and runs tests
-/squad-review                          # Reviewer gives the verdict
+/squad "add dark mode support"   # PO writes the spec
+
+/squad-auto                      # Auto-runs architect → dev → test → review (recommended)
+# — or step through manually —
+/squad-architect                 # Architect designs the plan
+/squad-dev                       # Dev implements the code
+/squad-test                      # Tester writes and runs tests
+/squad-review                    # Reviewer gives the verdict
 ```
 
 ### Batch Flow
@@ -196,16 +199,16 @@ Pass multiple tasks to `/squad` and it automatically runs in batch mode:
 /squad "add dark mode" "fix login bug" "refactor checkout"
 # PO writes specs for all three tasks
 
-/squad-run
+/squad-auto
 # Runs Architect → Dev → Test → Review for each task sequentially
 ```
 
-**Agent mode (Claude Code only):** Use `/squad-run-agents` instead of `/squad-run` to spawn parallel subagents — one per task per phase — so all tasks progress simultaneously rather than one at a time.
+**Parallel mode (Claude Code only):** Use `/squad-auto-parallel` instead of `/squad-auto` to spawn parallel subagents — one per task per phase — so all tasks progress simultaneously rather than one at a time.
 
 ```bash
 /squad "add dark mode" "fix login bug" "refactor checkout"
 
-/squad-run-agents
+/squad-auto-parallel
 # Phase 1: architect agents for all 3 tasks run in parallel
 # Phase 2: dev→test→review pipeline runs in parallel per task
 ```
@@ -285,8 +288,6 @@ Hooks are optional and can be skipped with `ck install --no-hooks`.
 - ⚡ **Zero Config** - Auto-detects project type and package manager
 - ✅ **Policy Enforcement** - Configurable validation with `ck check`
 - 📝 **Corrections Tracking** - Track AI performance issues with corrections log
-- 🔄 **Workflow Orchestration** - Structured workflows with `ck run`
-- 📦 **Registry System** - Share standards across teams with `ck publish/pull`
 - 📊 **Observability Dashboard** - Visual metrics and compliance tracking
 
 ## Commands
@@ -319,23 +320,14 @@ ck check --strict  # treat warnings as errors
 ck note "message"  # add note to corrections log
 ck note "AI issue" --category "AI Behavior" --priority HIGH
 
-# Workflow Orchestration
-ck run <workflow>  # run structured workflow
-ck run create-component  # example workflow
-ck run create-component --interactive  # interactive mode
-
-# Registry & Versioning
-ck publish --name @company/react-standards --version 1.0.0
-ck pull @company/react-standards@1.0.0
-ck pull @company/react-standards@latest --backup
+# Squad — multi-role AI pipeline (slash commands in your AI tool)
+/squad "add dark mode"   # PO writes spec
+/squad-auto              # runs architect → dev → test → review hands-free
+/squad-reset             # clear stuck or mixed squad state
 
 # Observability
 ck dashboard   # start web dashboard
 ck dashboard --no-server  # CLI metrics only
-
-# AI Usage (loads .contextkit context automatically)
-ck "create a button"  # quick AI chat with context
-ck ai "create a button"  # explicit AI command
 ```
 
 ## Links

package/lib/commands/install.js

@@ -93,6 +93,9 @@ class InstallCommand {
     // Create directory structure
     await this.createDirectoryStructure();
 
+    // Write attribution README
+    await this.createReadme();
+
     // Download files
     await this.downloadFiles(projectType, options);
 
@@ -718,12 +721,16 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
         '.contextkit/commands/squad-review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-run.md`,
-        '.contextkit/commands/squad-run.md'
+        `${this.repoUrl}/commands/squad-auto.md`,
+        '.contextkit/commands/squad-auto.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-auto-parallel.md`,
+        '.contextkit/commands/squad-auto-parallel.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-run-agents.md`,
-        '.contextkit/commands/squad-run-agents.md'
+        `${this.repoUrl}/commands/squad-reset.md`,
+        '.contextkit/commands/squad-reset.md'
       );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
@@ -972,8 +979,12 @@ esac
                        (await fs.pathExists('package.json') && 
                         (await fs.readJson('package.json').catch(() => ({}))).workspaces);
     
-    await fs.writeFile('.contextkit/config.yml', 
+    await fs.writeFile('.contextkit/config.yml',
       `# ContextKit Configuration
+_source:
+  tool: "@nolrm/contextkit"
+  version: "${require('../../package.json').version}"
+  npm: "https://www.npmjs.com/package/@nolrm/contextkit"
 ck: 1
 version: "${config.version}"
 updated: "${now.split('T')[0]}"
@@ -1043,6 +1054,20 @@ metadata:
     );
   }
 
+  async createReadme() {
+    const content = `# .contextkit
+
+This directory is managed by ContextKit — a CLI tool that provides AI assistants with structured project standards.
+
+\`\`\`
+npm install -g @nolrm/contextkit
+\`\`\`
+
+https://www.npmjs.com/package/@nolrm/contextkit
+`;
+    await fs.writeFile('.contextkit/README.md', content);
+  }
+
   async createStatusFile(projectType, packageManager, hookChoices) {
     try {
       const status = this.statusManager.getDefaultStatus();

package/lib/commands/update.js

@@ -55,6 +55,9 @@ class UpdateCommand {
       // Download latest files
       await this.downloadFiles(projectType);
 
+      // Remove files that were removed from CK
+      await this.removeLegacyFiles();
+
       // Restore user configuration
       await this.restoreUserConfig(config);
 
@@ -275,12 +278,16 @@ class UpdateCommand {
         '.contextkit/commands/squad-review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-run.md`,
-        '.contextkit/commands/squad-run.md'
+        `${this.repoUrl}/commands/squad-auto.md`,
+        '.contextkit/commands/squad-auto.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-auto-parallel.md`,
+        '.contextkit/commands/squad-auto-parallel.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-run-agents.md`,
-        '.contextkit/commands/squad-run-agents.md'
+        `${this.repoUrl}/commands/squad-reset.md`,
+        '.contextkit/commands/squad-reset.md'
       );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
@@ -401,6 +408,17 @@ commands:
     }
   }
 
+  async removeLegacyFiles() {
+    const legacyFiles = [
+      '.contextkit/commands/squad-peer-review.md',
+    ];
+    for (const file of legacyFiles) {
+      if (await fs.pathExists(file)) {
+        await fs.remove(file);
+      }
+    }
+  }
+
   async updateConfigVersion(version) {
     const configContent = await fs.readFile('.contextkit/config.yml', 'utf8');
     const updatedContent = configContent.replace(

package/lib/integrations/base-integration.js

@@ -2,8 +2,9 @@ const chalk = require('chalk');
 const fs = require('fs-extra');
 const path = require('path');
 
-const MARKER = '<!-- Generated by ContextKit -->';
+const MARKER = '<!-- Generated by ContextKit (@nolrm/contextkit) https://www.npmjs.com/package/@nolrm/contextkit -->';
 const MARKER_END = '<!-- End ContextKit -->';
+const LEGACY_MARKER_V1 = '<!-- Generated by ContextKit -->';
 const LEGACY_MARKER = '<!-- Generated by Vibe Kit -->';
 const LEGACY_MARKER_END = '<!-- End Vibe Kit -->';
 
@@ -59,11 +60,12 @@ class BaseIntegration {
 
       // Check for current or legacy markers
       const hasCurrentMarker = existing.includes(MARKER);
+      const hasLegacyMarkerV1 = existing.includes(LEGACY_MARKER_V1);
       const hasLegacyMarker = existing.includes(LEGACY_MARKER);
 
-      if (hasCurrentMarker || hasLegacyMarker) {
-        const activeMarker = hasCurrentMarker ? MARKER : LEGACY_MARKER;
-        const activeMarkerEnd = hasCurrentMarker ? MARKER_END : LEGACY_MARKER_END;
+      if (hasCurrentMarker || hasLegacyMarkerV1 || hasLegacyMarker) {
+        const activeMarker = hasCurrentMarker ? MARKER : (hasLegacyMarkerV1 ? LEGACY_MARKER_V1 : LEGACY_MARKER);
+        const activeMarkerEnd = hasLegacyMarker && !hasCurrentMarker && !hasLegacyMarkerV1 ? LEGACY_MARKER_END : MARKER_END;
         const before = existing.substring(0, existing.indexOf(activeMarker));
         const afterMarkerEnd = existing.indexOf(activeMarkerEnd);
         const after = afterMarkerEnd !== -1

package/lib/integrations/claude-integration.js

@@ -22,8 +22,9 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/commands/squad-dev.md',
       '.claude/commands/squad-test.md',
       '.claude/commands/squad-review.md',
-      '.claude/commands/squad-run.md',
-      '.claude/commands/squad-run-agents.md',
+      '.claude/commands/squad-auto.md',
+      '.claude/commands/squad-auto-parallel.md',
+      '.claude/commands/squad-reset.md',
       '.claude/commands/spec.md',
       '.claude/commands/ck.md',
     ];
@@ -44,6 +45,7 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/rules/vibe-kit-testing.md',
       '.claude/rules/vibe-kit-code-style.md',
       '.claude/commands/squad-batch.md',
+      '.claude/commands/squad-peer-review.md',
     ];
     for (const file of legacyFiles) {
       if (await fs.pathExists(file)) {
@@ -203,53 +205,62 @@ Write a component spec (MD-first) before any code is created. Scaffold the spec
 `);
 
     // Squad slash commands
-    await this.writeGeneratedFile('.claude/commands/squad.md', `# Squad — Kickoff
+    await this.writeGeneratedFile('.claude/commands/squad.md', `# Squad — Kickoff (start here)
 
 Read \`.contextkit/commands/squad.md\` and execute the squad kickoff workflow.
 
 Create the handoff file and write the PO spec for the given task. Pass the user's task description as the input.
+
+After kickoff, run \`/squad-auto\` to auto-run the full pipeline hands-free, or step through manually with \`/squad-architect\` → \`/squad-dev\` → \`/squad-test\` → \`/squad-review\`.
 `);
 
-    await this.writeGeneratedFile('.claude/commands/squad-architect.md', `# Squad — Architect
+    await this.writeGeneratedFile('.claude/commands/squad-architect.md', `# Squad — Architect (manual step 1/4)
 
 Read \`.contextkit/commands/squad-architect.md\` and execute the architect workflow.
 
-Read the PO spec from the handoff file, design the technical approach, and write the implementation plan.
+Read the PO spec from the handoff file, design the technical approach, and write the implementation plan. Use \`/squad-auto\` instead to run all steps automatically.
 `);
 
-    await this.writeGeneratedFile('.claude/commands/squad-dev.md', `# Squad — Dev
+    await this.writeGeneratedFile('.claude/commands/squad-dev.md', `# Squad — Dev (manual step 2/4)
 
 Read \`.contextkit/commands/squad-dev.md\` and execute the dev workflow.
 
-Follow the architect's plan to implement the code changes.
+Follow the architect's plan to implement the code changes. Use \`/squad-auto\` instead to run all steps automatically.
 `);
 
-    await this.writeGeneratedFile('.claude/commands/squad-test.md', `# Squad — Test
+    await this.writeGeneratedFile('.claude/commands/squad-test.md', `# Squad — Test (manual step 3/4)
 
 Read \`.contextkit/commands/squad-test.md\` and execute the test workflow.
 
-Write and run tests against the PO's acceptance criteria.
+Write and run tests against the PO's acceptance criteria. Use \`/squad-auto\` instead to run all steps automatically.
 `);
 
-    await this.writeGeneratedFile('.claude/commands/squad-review.md', `# Squad — Review
+    await this.writeGeneratedFile('.claude/commands/squad-review.md', `# Squad — Review (manual step 4/4)
 
 Read \`.contextkit/commands/squad-review.md\` and execute the review workflow.
 
-Review the full handoff (spec, plan, implementation, tests) and write the final verdict.
+Review the full handoff (spec, plan, implementation, tests) and write the final verdict. Use \`/squad-auto\` instead to run all steps automatically.
 `);
 
-    await this.writeGeneratedFile('.claude/commands/squad-run.md', `# Squad Run — Auto-Run Pipeline
+    await this.writeGeneratedFile('.claude/commands/squad-auto.md', `# Squad Auto — Full Pipeline (recommended)
 
-Read \`.contextkit/commands/squad-run.md\` and execute the pipeline runner workflow.
+Read \`.contextkit/commands/squad-auto.md\` and execute the pipeline runner workflow.
 
-Process all batch tasks through the remaining pipeline steps (Architect, Dev, Test, Review) sequentially.
+Run after \`/squad\` kickoff. Automatically runs architect → dev → test → review for all tasks sequentially, hands-free.
 `);
 
-    await this.writeGeneratedFile('.claude/commands/squad-run-agents.md', `# Squad Run — Agent Mode (Parallel)
+    await this.writeGeneratedFile('.claude/commands/squad-auto-parallel.md', `# Squad Auto — Parallel Agents (batch, fastest)
 
-Read \`.contextkit/commands/squad-run-agents.md\` and execute the parallel pipeline workflow.
+Read \`.contextkit/commands/squad-auto-parallel.md\` and execute the parallel pipeline workflow.
 
 Spawn one subagent per task per phase using the Task tool, so all tasks progress simultaneously instead of sequentially. Use this after \`/squad\` batch kickoff for faster execution on multi-task batches.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/squad-reset.md', `# Squad — Reset
+
+Read \`.contextkit/commands/squad-reset.md\` and execute the reset workflow.
+
+Delete the current squad state (.contextkit/squad/) so you can start fresh. Use when the squad folder is in a mixed or stuck state.
 `);
 
     await this.writeGeneratedFile('.claude/commands/ck.md', `# ContextKit Health Check
@@ -280,8 +291,8 @@ Check project setup, standards status, and integrations. Report what needs atten
     console.log(chalk.dim('    /squad-dev         — Implement the code'));
     console.log(chalk.dim('    /squad-test        — Write and run tests'));
     console.log(chalk.dim('    /squad-review      — Review and write verdict'));
-    console.log(chalk.dim('    /squad-run              — Auto-run pipeline sequentially'));
-    console.log(chalk.dim('    /squad-run-agents       — Auto-run pipeline in parallel (agent mode)'));
+    console.log(chalk.dim('    /squad-auto             — Auto-run full pipeline (recommended)'));
+    console.log(chalk.dim('    /squad-auto-parallel    — Auto-run pipeline in parallel (batch, fastest)'));
     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

@@ -23,7 +23,7 @@ class CursorIntegration extends BaseIntegration {
       '.cursor/prompts/squad-dev.md',
       '.cursor/prompts/squad-test.md',
       '.cursor/prompts/squad-review.md',
-      '.cursor/prompts/squad-run.md',
+      '.cursor/prompts/squad-auto.md',
       '.cursor/prompts/ck.md',
     ];
     this.bridgeFiles = [];
@@ -237,11 +237,11 @@ Read \`.contextkit/commands/squad-review.md\` and execute the review workflow.
 Review the full handoff (spec, plan, implementation, tests) and write the final verdict.
 `);
 
-    await this.writeGeneratedFile('.cursor/prompts/squad-run.md', `# Squad Run — Auto-Run Pipeline
+    await this.writeGeneratedFile('.cursor/prompts/squad-auto.md', `# Squad Auto — Full Pipeline (recommended)
 
-Read \`.contextkit/commands/squad-run.md\` and execute the pipeline runner workflow.
+Read \`.contextkit/commands/squad-auto.md\` and execute the pipeline runner workflow.
 
-Process all batch tasks through the remaining pipeline steps (Architect, Dev, Test, Review) sequentially.
+Run after kickoff. Automatically runs architect → dev → test → review for all tasks sequentially, hands-free.
 `);
 
     await this.writeGeneratedFile('.cursor/prompts/spec.md', `# Spec
@@ -279,7 +279,7 @@ Check project setup, standards status, and integrations. Report what needs atten
     console.log(chalk.dim('    /squad-dev         — Implement the code'));
     console.log(chalk.dim('    /squad-test        — Write and run tests'));
     console.log(chalk.dim('    /squad-review      — Review and write verdict'));
-    console.log(chalk.dim('    /squad-run         — Auto-run pipeline for batch tasks'));
+    console.log(chalk.dim('    /squad-auto        — Auto-run full pipeline (recommended)'));
     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.12.12",
+  "version": "0.12.15",
   "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": {
@@ -12,7 +12,8 @@
   "scripts": {
     "test": "jest",
     "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
+    "test:coverage": "jest --coverage",
+    "prepare": "git config core.hooksPath .contextkit/hooks"
   },
   "keywords": [
     "contextkit",