@nolrm/contextkit 0.12.11 → 0.12.14

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**
 
@@ -148,14 +148,13 @@ ContextKit installs reusable slash commands for supported platforms:
 | `/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` | Kick off a squad task — one task or many (auto-detects batch mode) |
 | `/squad-architect` | Design the technical plan from the PO spec |
 | `/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-batch` | Kick off multiple tasks at once (batch PO specs) |
-| `/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/`
@@ -182,31 +181,34 @@ 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
 
-For multiple tasks, use batch mode to spec them all up front, then run the full pipeline automatically:
+Pass multiple tasks to `/squad` and it automatically runs in batch mode:
 
 ```bash
-/squad-batch "add dark mode" "fix login bug" "refactor checkout"
+/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-batch "add dark mode" "fix login bug" "refactor checkout"
+/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
 ```

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,16 +721,12 @@ 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-batch.md`,
-        '.contextkit/commands/squad-batch.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-run-agents.md`,
-        '.contextkit/commands/squad-run-agents.md'
+        `${this.repoUrl}/commands/squad-auto-parallel.md`,
+        '.contextkit/commands/squad-auto-parallel.md'
       );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
@@ -976,8 +975,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]}"
@@ -1047,6 +1050,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

@@ -275,16 +275,12 @@ class UpdateCommand {
         '.contextkit/commands/squad-review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-batch.md`,
-        '.contextkit/commands/squad-batch.md'
+        `${this.repoUrl}/commands/squad-auto.md`,
+        '.contextkit/commands/squad-auto.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-run.md`,
-        '.contextkit/commands/squad-run.md'
-      );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-run-agents.md`,
-        '.contextkit/commands/squad-run-agents.md'
+        `${this.repoUrl}/commands/squad-auto-parallel.md`,
+        '.contextkit/commands/squad-auto-parallel.md'
       );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)

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,9 +22,8 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/commands/squad-dev.md',
       '.claude/commands/squad-test.md',
       '.claude/commands/squad-review.md',
-      '.claude/commands/squad-batch.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/spec.md',
       '.claude/commands/ck.md',
     ];
@@ -44,6 +43,7 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/rules/vibe-kit-standards.md',
       '.claude/rules/vibe-kit-testing.md',
       '.claude/rules/vibe-kit-code-style.md',
+      '.claude/commands/squad-batch.md',
     ];
     for (const file of legacyFiles) {
       if (await fs.pathExists(file)) {
@@ -203,60 +203,55 @@ 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.
-`);
-
-    await this.writeGeneratedFile('.claude/commands/squad-batch.md', `# Squad Batch — Multi-Task Kickoff
-
-Read \`.contextkit/commands/squad-batch.md\` and execute the batch kickoff workflow.
-
-Create handoff files for multiple tasks and write PO specs for each one. Pass all task descriptions as the input.
+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\` for faster execution on multi-task batches.
+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/ck.md', `# ContextKit Health Check
@@ -287,9 +282,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-batch            — Batch kickoff: PO specs for multiple tasks'));
-    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,8 +23,7 @@ class CursorIntegration extends BaseIntegration {
       '.cursor/prompts/squad-dev.md',
       '.cursor/prompts/squad-test.md',
       '.cursor/prompts/squad-review.md',
-      '.cursor/prompts/squad-batch.md',
-      '.cursor/prompts/squad-run.md',
+      '.cursor/prompts/squad-auto.md',
       '.cursor/prompts/ck.md',
     ];
     this.bridgeFiles = [];
@@ -238,18 +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-batch.md', `# Squad Batch — Multi-Task Kickoff
+    await this.writeGeneratedFile('.cursor/prompts/squad-auto.md', `# Squad Auto — Full Pipeline (recommended)
 
-Read \`.contextkit/commands/squad-batch.md\` and execute the batch kickoff workflow.
+Read \`.contextkit/commands/squad-auto.md\` and execute the pipeline runner workflow.
 
-Create handoff files for multiple tasks and write PO specs for each one. Pass all task descriptions as the input.
-`);
-
-    await this.writeGeneratedFile('.cursor/prompts/squad-run.md', `# Squad Run — Auto-Run Pipeline
-
-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.
+Run after kickoff. Automatically runs architect → dev → test → review for all tasks sequentially, hands-free.
 `);
 
     await this.writeGeneratedFile('.cursor/prompts/spec.md', `# Spec
@@ -287,8 +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-batch       — Batch kickoff: PO specs for multiple tasks'));
-    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.11",
+  "version": "0.12.14",
   "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",