@nolrm/contextkit 0.12.12 → 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**
 
@@ -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
 ```

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,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-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)
@@ -972,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]}"
@@ -1043,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,12 +275,12 @@ 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-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,8 +22,8 @@ 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/spec.md',
       '.claude/commands/ck.md',
     ];
@@ -203,51 +203,53 @@ 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.
 `);
@@ -280,8 +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-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.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",