@nolrm/contextkit 0.9.3 → 0.9.6

package/README.md

@@ -23,7 +23,7 @@ Update `.md` files as your project evolves; the AI follows.
 
 Works with: **Cursor** • **Claude Code** • **GitHub Copilot** • **Codex CLI** • **Gemini CLI** • **Aider** • **Continue** • **Windsurf**
 
-Each platform gets auto-loaded bridge files (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.windsurfrules`, etc.) so your AI tools read project standards automatically.
+Each platform gets auto-loaded bridge files (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.windsurfrules`, etc.) so your AI tools read project standards automatically. Claude Code uses `@` imports in CLAUDE.md to load standards content directly into context — no extra token cost from manual file reads.
 
 ---
 
@@ -111,13 +111,17 @@ Each platform generates bridge files that the AI tool auto-reads. If a bridge fi
 
 ## Use it in your tool
 
-**Cursor** — rules auto-load from `.cursor/rules/`
+**Cursor** — rules auto-load from `.cursor/rules/`, slash commands in `.cursor/prompts/`
 ```
-@.contextkit/commands/analyze.md
+/analyze    # scan codebase and generate standards
+/review     # code review with checklist
+/fix        # diagnose and fix bugs
 ```
 
-**Claude Code** — reads `CLAUDE.md` + `.claude/rules/` automatically
+**Claude Code** — `CLAUDE.md` uses `@` imports to auto-load all standards into context every session (no manual reads needed, saves tokens). Slash commands in `.claude/commands/`.
 ```bash
+/analyze    # scan codebase and generate standards
+/review     # code review with checklist
 claude "create checkout flow for customer"
 ```
 
@@ -133,14 +137,93 @@ codex "create checkout flow for customer"
 
 **CLI** (Chat with AI)
 ```bash
-ck ai "create checkout flow for customer"
+ck ai "create a button"
 ```
 
 ---
 
+## Slash Commands
+
+ContextKit installs reusable slash commands for supported platforms:
+
+| Command | What it does |
+|---------|-------------|
+| `/analyze` | Scan codebase and generate standards content |
+| `/review` | Code review with checklist |
+| `/fix` | Diagnose and fix bugs |
+| `/refactor` | Refactor code with safety checks |
+| `/test` | Generate comprehensive tests |
+| `/doc` | Add documentation |
+| `/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 |
+| `/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 |
+
+**Claude Code** — available as `/analyze`, `/review`, etc. in `.claude/commands/`
+**Cursor** — available as slash commands in Chat via `.cursor/prompts/`
+
+Both platforms delegate to the universal command files in `.contextkit/commands/`, so you maintain one set of workflows.
+
+---
+
+## Squad Workflow
+
+The squad workflow turns a single AI session into a structured multi-role pipeline. Each role has its own slash command that reads and writes to a shared handoff file (`.contextkit/squad/handoff.md`), simulating a team of specialists.
+
+### Pipeline Roles
+
+| Step | Role | Command | What it does |
+|------|------|---------|-------------|
+| 1 | Product Owner | `/squad` | Writes a user story, acceptance criteria, edge cases, and scope |
+| 2 | Architect | `/squad-architect` | Designs the technical approach, files to change, and implementation steps |
+| 3 | Developer | `/squad-dev` | Implements the code following the architect's plan |
+| 4 | Tester | `/squad-test` | Writes and runs tests against the PO's acceptance criteria |
+| 5 | Reviewer | `/squad-review` | Reviews everything and gives a PASS or NEEDS-WORK verdict |
+
+### 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
+```
+
+### Batch Flow
+
+For multiple tasks, use batch mode to spec them all up front, then run the full pipeline automatically:
+
+```bash
+/squad-batch "add dark mode" "fix login bug" "refactor checkout"
+# PO writes specs for all three tasks
+
+/squad-run
+# Runs Architect → Dev → Test → Review for each task sequentially
+```
+
+### Feedback Loop
+
+Any downstream role can raise questions for an upstream role. When this happens, the pipeline pauses and directs you to the right command:
+
+```
+Reviewer has questions for Dev → run /squad-dev to clarify
+Tester has questions for Architect → run /squad-architect to clarify
+Architect has questions for PO → run /squad to clarify
+```
+
+After clarifications are added, re-run the asking role's command to continue. This prevents misunderstandings from compounding through the pipeline.
+
+---
+
 ## Git Hooks & Quality Gates
 
-ContextKit can optionally install native Git hooks (`.git/hooks/`) during `ck install`. No external dependencies like Husky required — works in any git repo, not just Node.js projects.
+ContextKit can optionally install Git hooks during `ck install`. Uses `git config core.hooksPath` to point Git at `.contextkit/hooks/` — no external dependencies like Husky required. Works in any git repo, not just Node.js projects.
+
+For **Node.js projects**, a `prepare` script is automatically added to `package.json` so hooks activate for all developers after `npm install` — no need for everyone to run `ck install`.
 
 | Hook | What it does |
 |------|-------------|

package/lib/commands/install.js

@@ -515,12 +515,20 @@ Run \`ck analyze\` to generate this content, or manually add your API pattern be
 
       // Download commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-feature.md`,
-        '.contextkit/commands/create-feature.md'
+        `${this.repoUrl}/commands/analyze.md`,
+        '.contextkit/commands/analyze.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-component.md`,
-        '.contextkit/commands/create-component.md'
+        `${this.repoUrl}/commands/review.md`,
+        '.contextkit/commands/review.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/fix.md`,
+        '.contextkit/commands/fix.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/refactor.md`,
+        '.contextkit/commands/refactor.md'
       );
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/commands/run-tests.md`,
@@ -535,18 +543,52 @@ Run \`ck analyze\` to generate this content, or manually add your API pattern be
         '.contextkit/commands/quality-check.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/analyze.md`,
-        '.contextkit/commands/analyze.md'
+        `${this.repoUrl}/commands/create-feature.md`,
+        '.contextkit/commands/create-feature.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/create-component.md`,
+        '.contextkit/commands/create-component.md'
+      );
+
+      // Download squad commands
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad.md`,
+        '.contextkit/commands/squad.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-architect.md`,
+        '.contextkit/commands/squad-architect.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-dev.md`,
+        '.contextkit/commands/squad-dev.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-test.md`,
+        '.contextkit/commands/squad-test.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-review.md`,
+        '.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'
       );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/hooks/pre-push.sh`,
-        '.contextkit/hooks/pre-push.sh'
+        `${this.repoUrl}/hooks/pre-push`,
+        '.contextkit/hooks/pre-push'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/hooks/commit-msg.sh`,
-        '.contextkit/hooks/commit-msg.sh'
+        `${this.repoUrl}/hooks/commit-msg`,
+        '.contextkit/hooks/commit-msg'
       );
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/hooks/setup-hooks.sh`,
@@ -581,8 +623,8 @@ Run \`ck analyze\` to generate this content, or manually add your API pattern be
       );
 
       // Make scripts executable
-      await fs.chmod('.contextkit/hooks/pre-push.sh', '755');
-      await fs.chmod('.contextkit/hooks/commit-msg.sh', '755');
+      await fs.chmod('.contextkit/hooks/pre-push', '755');
+      await fs.chmod('.contextkit/hooks/commit-msg', '755');
       await fs.chmod('.contextkit/hooks/setup-hooks.sh', '755');
       await fs.chmod('.contextkit/types/type-check.sh', '755');
       await fs.chmod('.contextkit/scripts/update.sh', '755');
@@ -683,11 +725,14 @@ claude "read .contextkit/context.md to see available standards, then create a bu
 
 ### Commands
 - \`.contextkit/commands/analyze.md\` - Analyze & customize standards
+- \`.contextkit/commands/review.md\` - Code review
+- \`.contextkit/commands/fix.md\` - Diagnose and fix bugs
+- \`.contextkit/commands/refactor.md\` - Refactor code structure
+- \`.contextkit/commands/run-tests.md\` - Generate or run tests
+- \`.contextkit/commands/add-documentation.md\` - Add documentation
+- \`.contextkit/commands/quality-check.md\` - Quality checks
 - \`.contextkit/commands/create-component.md\` - Create component
 - \`.contextkit/commands/create-feature.md\` - Create feature
-- \`.contextkit/commands/run-tests.md\` - Run tests
-- \`.contextkit/commands/quality-check.md\` - Quality checks
-- \`.contextkit/commands/add-documentation.md\` - Add documentation
 
 ### Instructions
 - \`.contextkit/instructions/meta/pre-flight.md\` - Pre-flight checks
@@ -806,12 +851,15 @@ esac
         docs: 'docs'
       },
       commands: {
-        create_component: '@.contextkit/commands/create-component.md',
-        create_feature: '@.contextkit/commands/create-feature.md',
+        analyze: '@.contextkit/commands/analyze.md',
+        review: '@.contextkit/commands/review.md',
+        fix: '@.contextkit/commands/fix.md',
+        refactor: '@.contextkit/commands/refactor.md',
         run_tests: '@.contextkit/commands/run-tests.md',
         add_docs: '@.contextkit/commands/add-documentation.md',
         quality_check: '@.contextkit/commands/quality-check.md',
-        analyze: '@.contextkit/commands/analyze.md'
+        create_component: '@.contextkit/commands/create-component.md',
+        create_feature: '@.contextkit/commands/create-feature.md'
       }
     };
 

package/lib/commands/update.js

@@ -213,12 +213,20 @@ class UpdateCommand {
 
       // Download commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-feature.md`,
-        '.contextkit/commands/create-feature.md'
+        `${this.repoUrl}/commands/analyze.md`,
+        '.contextkit/commands/analyze.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-component.md`,
-        '.contextkit/commands/create-component.md'
+        `${this.repoUrl}/commands/review.md`,
+        '.contextkit/commands/review.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/fix.md`,
+        '.contextkit/commands/fix.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/refactor.md`,
+        '.contextkit/commands/refactor.md'
       );
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/commands/run-tests.md`,
@@ -233,18 +241,52 @@ class UpdateCommand {
         '.contextkit/commands/quality-check.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/analyze.md`,
-        '.contextkit/commands/analyze.md'
+        `${this.repoUrl}/commands/create-feature.md`,
+        '.contextkit/commands/create-feature.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/create-component.md`,
+        '.contextkit/commands/create-component.md'
+      );
+
+      // Download squad commands
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad.md`,
+        '.contextkit/commands/squad.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-architect.md`,
+        '.contextkit/commands/squad-architect.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-dev.md`,
+        '.contextkit/commands/squad-dev.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-test.md`,
+        '.contextkit/commands/squad-test.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/squad-review.md`,
+        '.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'
       );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/hooks/pre-push.sh`,
-        '.contextkit/hooks/pre-push.sh'
+        `${this.repoUrl}/hooks/pre-push`,
+        '.contextkit/hooks/pre-push'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/hooks/commit-msg.sh`,
-        '.contextkit/hooks/commit-msg.sh'
+        `${this.repoUrl}/hooks/commit-msg`,
+        '.contextkit/hooks/commit-msg'
       );
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/hooks/setup-hooks.sh`,
@@ -278,8 +320,8 @@ class UpdateCommand {
       );
 
       // Make scripts executable
-      await fs.chmod('.contextkit/hooks/pre-push.sh', '755');
-      await fs.chmod('.contextkit/hooks/commit-msg.sh', '755');
+      await fs.chmod('.contextkit/hooks/pre-push', '755');
+      await fs.chmod('.contextkit/hooks/commit-msg', '755');
       await fs.chmod('.contextkit/hooks/setup-hooks.sh', '755');
       await fs.chmod('.contextkit/types/type-check.sh', '755');
       await fs.chmod('.contextkit/scripts/update.sh', '755');
@@ -317,12 +359,15 @@ paths:
 
 # Commands
 commands:
-  create_component: "${config.commands?.create_component || '@.contextkit/commands/create-component.md'}"
-  create_feature: "${config.commands?.create_feature || '@.contextkit/commands/create-feature.md'}"
+  analyze: "${config.commands?.analyze || '@.contextkit/commands/analyze.md'}"
+  review: "${config.commands?.review || '@.contextkit/commands/review.md'}"
+  fix: "${config.commands?.fix || '@.contextkit/commands/fix.md'}"
+  refactor: "${config.commands?.refactor || '@.contextkit/commands/refactor.md'}"
   run_tests: "${config.commands?.run_tests || '@.contextkit/commands/run-tests.md'}"
   add_docs: "${config.commands?.add_docs || '@.contextkit/commands/add-documentation.md'}"
   quality_check: "${config.commands?.quality_check || '@.contextkit/commands/quality-check.md'}"
-  analyze: "${config.commands?.analyze || '@.contextkit/commands/analyze.md'}"
+  create_component: "${config.commands?.create_component || '@.contextkit/commands/create-component.md'}"
+  create_feature: "${config.commands?.create_feature || '@.contextkit/commands/create-feature.md'}"
 `;
 
     await fs.writeFile('.contextkit/config.yml', configContent);

package/lib/integrations/claude-integration.js

@@ -12,6 +12,18 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/rules/contextkit-testing.md',
       '.claude/rules/contextkit-code-style.md',
       '.claude/commands/analyze.md',
+      '.claude/commands/review.md',
+      '.claude/commands/fix.md',
+      '.claude/commands/refactor.md',
+      '.claude/commands/test.md',
+      '.claude/commands/doc.md',
+      '.claude/commands/squad.md',
+      '.claude/commands/squad-architect.md',
+      '.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',
     ];
     this.platformDir = '.claude/rules';
   }
@@ -37,6 +49,33 @@ class ClaudeIntegration extends BaseIntegration {
     }
   }
 
+  getStandardsBlock() {
+    return `## Project Standards
+
+The following standards are auto-loaded into context via @imports:
+
+- @.contextkit/standards/code-style.md — Coding conventions and style rules
+- @.contextkit/standards/testing.md — Testing patterns and requirements
+- @.contextkit/standards/architecture.md — Architecture decisions and patterns
+- @.contextkit/standards/ai-guidelines.md — AI behavior and usage guidelines
+- @.contextkit/standards/workflows.md — Development workflows and processes
+- @.contextkit/standards/glossary.md — Project terminology and shortcuts
+
+## Product Context
+
+- @.contextkit/product/mission-lite.md — Product mission (condensed)
+- @.contextkit/product/decisions.md — Architecture Decision Records
+- @.contextkit/product/roadmap.md — Development roadmap
+
+## Commands
+
+- \`.contextkit/commands/analyze.md\` — Analyze and customize standards
+- \`.contextkit/commands/create-component.md\` — Create components
+- \`.contextkit/commands/create-feature.md\` — Create features
+- \`.contextkit/commands/run-tests.md\` — Run tests
+- \`.contextkit/commands/quality-check.md\` — Quality checks`;
+  }
+
   async generateFiles() {
     // Bridge file: CLAUDE.md (auto-loaded every session)
     const bridgeContent = `# Project Standards (ContextKit)
@@ -47,7 +86,7 @@ ${this.getStandardsBlock()}
 
 ## Corrections Log
 
-- \`.contextkit/corrections.md\` — Track AI performance improvements
+- @.contextkit/corrections.md — Track AI performance improvements
 
 ## Quick Reference
 
@@ -63,14 +102,14 @@ alwaysApply: true
 
 # ContextKit Standards
 
-This project uses ContextKit for structured development standards.
+This project uses ContextKit. Project standards are auto-loaded via CLAUDE.md imports.
 
-Always reference the following before generating code:
-- \`.contextkit/standards/code-style.md\` for coding conventions
-- \`.contextkit/standards/architecture.md\` for architecture patterns
-- \`.contextkit/standards/ai-guidelines.md\` for AI behavior rules
-- \`.contextkit/standards/glossary.md\` for project terminology
-- \`.contextkit/product/mission-lite.md\` for product context
+Key areas to follow:
+- Code style conventions (from code-style.md)
+- Architecture patterns (from architecture.md)
+- AI behavior rules (from ai-guidelines.md)
+- Project terminology (from glossary.md)
+- Product context (from mission-lite.md)
 `;
     await this.writeGeneratedFile('.claude/rules/contextkit-standards.md', standardsRule);
 
@@ -85,8 +124,7 @@ globs:
 
 # Testing Standards
 
-When writing or modifying tests, follow:
-- \`.contextkit/standards/testing.md\` for test patterns and requirements
+Follow the testing standards auto-loaded via CLAUDE.md (from testing.md).
 - All test cases MUST use numbered descriptions (e.g., \`it("1. renders correctly")\`)
 - Reference \`.contextkit/templates/test.md\` for test template patterns
 `;
@@ -104,22 +142,105 @@ globs:
 
 # Code Style
 
-When writing or modifying source code, follow:
-- \`.contextkit/standards/code-style.md\` for coding conventions
-- \`.contextkit/templates/component.md\` for component patterns
-- \`.contextkit/templates/hook.md\` for custom hook patterns
-- \`.contextkit/templates/api.md\` for API service patterns
+Follow the code style standards auto-loaded via CLAUDE.md (from code-style.md).
+- Reference \`.contextkit/templates/component.md\` for component patterns
+- Reference \`.contextkit/templates/hook.md\` for custom hook patterns
+- Reference \`.contextkit/templates/api.md\` for API service patterns
 `;
     await this.writeGeneratedFile('.claude/rules/contextkit-code-style.md', codeStyleRule);
 
-    // Command: analyze
-    const analyzeCommand = `# Analyze Project
+    // Slash commands — thin wrappers that delegate to .contextkit/commands/
+    await this.writeGeneratedFile('.claude/commands/analyze.md', `# Analyze Project
 
 Read \`.contextkit/commands/analyze.md\` and execute the analysis workflow for this project.
 
 Scan the codebase structure, detect frameworks and patterns, then generate customized standards files in \`.contextkit/standards/\`.
-`;
-    await this.writeGeneratedFile('.claude/commands/analyze.md', analyzeCommand);
+`);
+
+    await this.writeGeneratedFile('.claude/commands/review.md', `# Code Review
+
+Read \`.contextkit/commands/review.md\` and execute the review workflow.
+
+Review current changes for correctness, standards compliance, and potential issues.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/fix.md', `# Fix Bug
+
+Read \`.contextkit/commands/fix.md\` and execute the bug fix workflow.
+
+Diagnose the root cause, implement the minimal fix, and add a regression test.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/refactor.md', `# Refactor
+
+Read \`.contextkit/commands/refactor.md\` and execute the refactoring workflow.
+
+Improve code structure without changing behavior, keeping tests green at every step.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/test.md', `# Run Tests
+
+Read \`.contextkit/commands/run-tests.md\` and execute the testing workflow.
+
+Generate or run tests for the specified code, covering happy paths, edge cases, and errors.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/doc.md', `# Add Documentation
+
+Read \`.contextkit/commands/add-documentation.md\` and execute the documentation workflow.
+
+Add inline docs, README sections, and usage examples for the specified code.
+`);
+
+    // Squad slash commands
+    await this.writeGeneratedFile('.claude/commands/squad.md', `# Squad — Kickoff
+
+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.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/squad-architect.md', `# Squad — Architect
+
+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.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/squad-dev.md', `# Squad — Dev
+
+Read \`.contextkit/commands/squad-dev.md\` and execute the dev workflow.
+
+Follow the architect's plan to implement the code changes.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/squad-test.md', `# Squad — Test
+
+Read \`.contextkit/commands/squad-test.md\` and execute the test workflow.
+
+Write and run tests against the PO's acceptance criteria.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/squad-review.md', `# Squad — Review
+
+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.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/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.
+`);
   }
 
   showUsage() {
@@ -127,14 +248,23 @@ Scan the codebase structure, detect frameworks and patterns, then generate custo
     console.log(chalk.bold('  Claude Code Usage:'));
     console.log('    CLAUDE.md is auto-loaded every session');
     console.log('    .claude/rules/ are loaded based on file context');
-    console.log('    Use /analyze slash command for project analysis');
     console.log('');
-    console.log(chalk.dim('  Files created:'));
-    console.log(chalk.dim('    CLAUDE.md (bridge - auto-loaded)'));
-    console.log(chalk.dim('    .claude/rules/contextkit-standards.md (always apply)'));
-    console.log(chalk.dim('    .claude/rules/contextkit-testing.md (test files)'));
-    console.log(chalk.dim('    .claude/rules/contextkit-code-style.md (source files)'));
-    console.log(chalk.dim('    .claude/commands/analyze.md (slash command)'));
+    console.log(chalk.dim('  Slash commands:'));
+    console.log(chalk.dim('    /analyze  — Analyze project and generate standards'));
+    console.log(chalk.dim('    /review   — Review current changes'));
+    console.log(chalk.dim('    /fix      — Diagnose and fix a bug'));
+    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(''));
+    console.log(chalk.dim('  Squad (multi-agent workflow):'));
+    console.log(chalk.dim('    /squad "task"      — Kickoff: create handoff + PO spec'));
+    console.log(chalk.dim('    /squad-architect   — Design the implementation plan'));
+    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'));
   }
 }
 

package/lib/integrations/cursor-integration.js

@@ -12,6 +12,19 @@ class CursorIntegration extends BaseIntegration {
       '.cursor/rules/contextkit-testing.mdc',
       '.cursor/rules/contextkit-components.mdc',
       '.cursor/rules/contextkit-api.mdc',
+      '.cursor/prompts/analyze.md',
+      '.cursor/prompts/review.md',
+      '.cursor/prompts/fix.md',
+      '.cursor/prompts/refactor.md',
+      '.cursor/prompts/test.md',
+      '.cursor/prompts/doc.md',
+      '.cursor/prompts/squad.md',
+      '.cursor/prompts/squad-architect.md',
+      '.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',
     ];
     this.bridgeFiles = [];
     this.platformDir = '.cursor/rules';
@@ -19,6 +32,7 @@ class CursorIntegration extends BaseIntegration {
 
   async install() {
     await super.install();
+    await fs.ensureDir('.cursor/prompts');
     // Remove old monolithic rule file if present
     await this.removeLegacyFiles();
   }
@@ -142,20 +156,122 @@ Reference: @.contextkit/standards/architecture.md
 - @.contextkit/commands/create-feature.md — Create feature workflow
 `;
     await this.writeGeneratedFile('.cursor/rules/contextkit-api.mdc', apiRule);
+
+    // Cursor prompts — reusable slash commands in Cursor Chat
+    await this.writeGeneratedFile('.cursor/prompts/analyze.md', `# Analyze Project
+
+Read \`.contextkit/commands/analyze.md\` and execute the analysis workflow for this project.
+
+Scan the codebase structure, detect frameworks and patterns, then generate customized standards files in \`.contextkit/standards/\`.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/review.md', `# Code Review
+
+Read \`.contextkit/commands/review.md\` and execute the review workflow.
+
+Review current changes for correctness, standards compliance, and potential issues. Flag bugs, security concerns, and standards violations.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/fix.md', `# Fix Bug
+
+Read \`.contextkit/commands/fix.md\` and execute the bug fix workflow.
+
+Diagnose the root cause, implement the minimal fix, and add a regression test.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/refactor.md', `# Refactor
+
+Read \`.contextkit/commands/refactor.md\` and execute the refactoring workflow.
+
+Improve code structure without changing behavior, keeping tests green at every step.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/test.md', `# Run Tests
+
+Read \`.contextkit/commands/run-tests.md\` and execute the testing workflow.
+
+Generate or run tests for the specified code, covering happy paths, edge cases, and errors.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/doc.md', `# Add Documentation
+
+Read \`.contextkit/commands/add-documentation.md\` and execute the documentation workflow.
+
+Add inline docs, README sections, and usage examples for the specified code.
+`);
+
+    // Squad prompts
+    await this.writeGeneratedFile('.cursor/prompts/squad.md', `# Squad — Kickoff
+
+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.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/squad-architect.md', `# Squad — Architect
+
+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.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/squad-dev.md', `# Squad — Dev
+
+Read \`.contextkit/commands/squad-dev.md\` and execute the dev workflow.
+
+Follow the architect's plan to implement the code changes.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/squad-test.md', `# Squad — Test
+
+Read \`.contextkit/commands/squad-test.md\` and execute the test workflow.
+
+Write and run tests against the PO's acceptance criteria.
+`);
+
+    await this.writeGeneratedFile('.cursor/prompts/squad-review.md', `# Squad — Review
+
+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
+
+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.
+`);
+
+    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.
+`);
   }
 
   showUsage() {
     console.log('');
     console.log(chalk.bold('  Cursor Usage:'));
     console.log('    Rules auto-load based on file context');
-    console.log('    In Cursor Chat: @.contextkit/commands/analyze.md');
-    console.log('    Or: @.contextkit Create a button component');
     console.log('');
-    console.log(chalk.dim('  Files created:'));
-    console.log(chalk.dim('    .cursor/rules/contextkit-standards.mdc (always apply)'));
-    console.log(chalk.dim('    .cursor/rules/contextkit-testing.mdc (test files)'));
-    console.log(chalk.dim('    .cursor/rules/contextkit-components.mdc (components)'));
-    console.log(chalk.dim('    .cursor/rules/contextkit-api.mdc (API/services)'));
+    console.log(chalk.dim('  Slash commands (in Cursor Chat):'));
+    console.log(chalk.dim('    /analyze  — Analyze project and generate standards'));
+    console.log(chalk.dim('    /review   — Review current changes'));
+    console.log(chalk.dim('    /fix      — Diagnose and fix a bug'));
+    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(''));
+    console.log(chalk.dim('  Squad (multi-agent workflow):'));
+    console.log(chalk.dim('    /squad "task"      — Kickoff: create handoff + PO spec'));
+    console.log(chalk.dim('    /squad-architect   — Design the implementation plan'));
+    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'));
   }
 }
 

package/lib/utils/git-hooks.js

@@ -1,9 +1,10 @@
+const { execSync } = require('child_process');
 const fs = require('fs-extra');
 const chalk = require('chalk');
 
 class GitHooksManager {
   constructor() {
-    this.hooksDir = '.git/hooks';
+    this.hooksPath = '.contextkit/hooks';
   }
 
   async installHooks(packageManager, hookChoices = { prePush: true, commitMsg: true }) {
@@ -19,8 +20,24 @@ class GitHooksManager {
       // Clean up legacy Husky directory if present
       await this.cleanupLegacyHusky();
 
-      // Add hooks
-      await this.addHooks(hookChoices);
+      // Clean up legacy .git/hooks/ files from previous ContextKit versions
+      await this.cleanupLegacyGitHooks();
+
+      // Remove hooks the user didn't select
+      await this.removeUnselectedHooks(hookChoices);
+
+      // Set core.hooksPath so git uses .contextkit/hooks/ directly
+      execSync(`git config core.hooksPath ${this.hooksPath}`, { stdio: 'pipe' });
+      console.log(chalk.green(`✅ Git hooks path set to ${this.hooksPath}`));
+
+      // Add prepare script to package.json for automatic setup on npm install
+      await this.addPrepareScript();
+
+      // Show non-Node setup hint if no package.json
+      if (!fs.existsSync('package.json')) {
+        console.log(chalk.dim('   💡 For other developers, add to your setup:'));
+        console.log(chalk.dim(`      git config core.hooksPath ${this.hooksPath}`));
+      }
 
       console.log(chalk.green('✅ Git hooks setup complete'));
 
@@ -30,45 +47,49 @@ class GitHooksManager {
     }
   }
 
-  async addHooks(hookChoices = { prePush: true, commitMsg: true }) {
-    // Backup existing hooks
-    await this.backupExistingHooks();
-
-    // Remove legacy pre-commit hook if it exists (replaced by pre-push)
-    const legacyPreCommitHook = `${this.hooksDir}/pre-commit`;
-    if (fs.existsSync(legacyPreCommitHook)) {
-      const content = await fs.readFile(legacyPreCommitHook, 'utf8');
-      if (content.includes('.contextkit/') || content.includes('.vibe-kit/')) {
-        await fs.remove(legacyPreCommitHook);
-        console.log(chalk.yellow('🧹 Removed legacy pre-commit hook (replaced by pre-push)'));
+  async removeUnselectedHooks(hookChoices) {
+    // If user didn't select a hook, remove it from .contextkit/hooks/
+    // so core.hooksPath doesn't run hooks they didn't want
+    if (!hookChoices.prePush) {
+      const hookPath = `${this.hooksPath}/pre-push`;
+      if (fs.existsSync(hookPath)) {
+        await fs.remove(hookPath);
       }
     }
-
-    // Add selected hooks
-    if (hookChoices.prePush) {
-      await this.addNativeHook('pre-push', '.contextkit/hooks/pre-push.sh');
-    }
-    if (hookChoices.commitMsg) {
-      await this.addNativeHook('commit-msg', '.contextkit/hooks/commit-msg.sh');
+    if (!hookChoices.commitMsg) {
+      const hookPath = `${this.hooksPath}/commit-msg`;
+      if (fs.existsSync(hookPath)) {
+        await fs.remove(hookPath);
+      }
     }
   }
 
-  async addNativeHook(hookName, scriptPath) {
-    const hookPath = `${this.hooksDir}/${hookName}`;
+  async addPrepareScript() {
+    if (!fs.existsSync('package.json')) return;
+
+    try {
+      const pkg = await fs.readJson('package.json');
+      const prepareCmd = `git config core.hooksPath ${this.hooksPath}`;
 
-    // Ensure .git/hooks directory exists
-    await fs.ensureDir(this.hooksDir);
+      if (!pkg.scripts) pkg.scripts = {};
 
-    // Write hook directly — no Husky, just a shebang + delegation
-    const hookContent = `#!/usr/bin/env sh
-# ContextKit managed hook — do not edit
-${scriptPath} "$@"
-`;
+      // Don't overwrite if prepare already has our command
+      if (pkg.scripts.prepare && pkg.scripts.prepare.includes('core.hooksPath')) {
+        return;
+      }
 
-    await fs.writeFile(hookPath, hookContent);
-    await fs.chmod(hookPath, '755');
+      // Append to existing prepare script or create new one
+      if (pkg.scripts.prepare) {
+        pkg.scripts.prepare = `${pkg.scripts.prepare} && ${prepareCmd}`;
+      } else {
+        pkg.scripts.prepare = prepareCmd;
+      }
 
-    console.log(chalk.green(`✅ Created hook: ${hookName}`));
+      await fs.writeJson('package.json', pkg, { spaces: 2 });
+      console.log(chalk.green('✅ Added prepare script to package.json'));
+    } catch (error) {
+      console.log(chalk.yellow('⚠️  Could not update package.json prepare script'));
+    }
   }
 
   async cleanupLegacyHusky() {
@@ -91,24 +112,21 @@ ${scriptPath} "$@"
 
     if (hasContextKitHooks) {
       await fs.remove('.husky');
-      console.log(chalk.yellow('🧹 Removed legacy .husky/ directory (now using native .git/hooks/)'));
+      console.log(chalk.yellow('🧹 Removed legacy .husky/ directory'));
       console.log(chalk.dim('   💡 You can also run: npm uninstall husky'));
     }
   }
 
-  async backupExistingHooks() {
+  async cleanupLegacyGitHooks() {
+    // Remove wrapper hooks from .git/hooks/ left by previous ContextKit versions
     const hooks = ['pre-push', 'commit-msg'];
-
     for (const hook of hooks) {
-      const hookPath = `${this.hooksDir}/${hook}`;
+      const hookPath = `.git/hooks/${hook}`;
       if (fs.existsSync(hookPath)) {
-        // Don't back up our own hooks
         const content = await fs.readFile(hookPath, 'utf8');
-        if (content.includes('ContextKit managed hook')) continue;
-
-        const backupPath = `${hookPath}.backup`;
-        await fs.copy(hookPath, backupPath);
-        console.log(chalk.yellow(`📦 Backed up existing hook: ${hook}`));
+        if (content.includes('ContextKit managed hook')) {
+          await fs.remove(hookPath);
+        }
       }
     }
   }
@@ -116,19 +134,41 @@ ${scriptPath} "$@"
   async uninstallHooks() {
     console.log(chalk.yellow('🪝 Removing Git hooks...'));
 
-    const hooks = ['pre-push', 'commit-msg'];
+    // Unset core.hooksPath
+    try {
+      execSync('git config --unset core.hooksPath', { stdio: 'pipe' });
+      console.log(chalk.green('✅ Removed core.hooksPath config'));
+    } catch (error) {
+      // Already unset, that's fine
+    }
 
-    for (const hook of hooks) {
-      const hookPath = `${this.hooksDir}/${hook}`;
-      const backupPath = `${hookPath}.backup`;
+    // Remove prepare script from package.json
+    await this.removePrepareScript();
 
-      if (fs.existsSync(backupPath)) {
-        await fs.move(backupPath, hookPath);
-        console.log(chalk.green(`✅ Restored original hook: ${hook}`));
-      } else if (fs.existsSync(hookPath)) {
-        await fs.remove(hookPath);
-        console.log(chalk.green(`✅ Removed hook: ${hook}`));
+    console.log(chalk.green('✅ Git hooks removed'));
+  }
+
+  async removePrepareScript() {
+    if (!fs.existsSync('package.json')) return;
+
+    try {
+      const pkg = await fs.readJson('package.json');
+      if (!pkg.scripts?.prepare) return;
+
+      const prepareCmd = `git config core.hooksPath ${this.hooksPath}`;
+
+      if (pkg.scripts.prepare === prepareCmd) {
+        delete pkg.scripts.prepare;
+      } else if (pkg.scripts.prepare.includes(prepareCmd)) {
+        // Remove our command from a chained prepare script
+        pkg.scripts.prepare = pkg.scripts.prepare
+          .replace(` && ${prepareCmd}`, '')
+          .replace(`${prepareCmd} && `, '');
       }
+
+      await fs.writeJson('package.json', pkg, { spaces: 2 });
+    } catch (error) {
+      // Best effort
     }
   }
 }

package/package.json

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