@nolrm/contextkit 0.19.0 → 0.21.0

package/README.md

@@ -1,24 +1,31 @@
 # ContextKit
 
-> Context Engineering for AI Development
+> Context Engineering + Agentic AI Pipelines
 
-Give your AI assistants (Cursor, Claude, Copilot, Codex, OpenCode, Gemini, Aider, Continue, Windsurf) structured context through markdown files. ContextKit creates a knowledge base that ensures AI generates code matching your exact patterns, style, and architecture—no more hallucinated code or mismatched conventions.
+ContextKit gives your AI assistants (Cursor, Claude, Copilot, Codex, OpenCode, Gemini, Aider, Continue, Windsurf) structured context through markdown files—and gives you a multi-role autonomous pipeline (PO → Architect → Dev → Test → Review → Doc) to execute work with those same agents. The context layer is what keeps the pipeline grounded: agents read your standards, so they never hallucinate your conventions.
 
-ContextKit is a CLI tool that provides **context-engineering** capabilities by creating `.contextkit/` directories with project standards, guidelines, and patterns that AI assistants read automatically.
+ContextKit is a CLI tool with two capabilities: **context engineering** (`.contextkit/standards/` + platform bridge files so every AI tool reads your project conventions automatically) and **squad pipelines** (a six-role agentic workflow grounded by those same standards).
 
 **[Read the full documentation](https://contextkit-docs.vercel.app/)** · **[How context works](https://contextkit-docs.vercel.app/docs/how-context-works)**
 
 ## Why ContextKit?
 
-**The problem:** LLMs are great at syntax, not at _your_ conventions. Generic AI output requires manual fixes for style, structure, and architecture.
+**The problem:** LLMs are good at syntax, not at _your_ conventions — and multi-agent pipelines amplify that. An autonomous dev agent that doesn't know your architecture, naming, or testing patterns will produce code you have to fully rewrite.
 
-**The solution:** ContextKit provides your AI with:
+**The solution — two pillars that reinforce each other:**
 
-- **Glossary** of project terminology and domain-specific terms (e.g., your entity, feature, and module names)
-- **Standards** for code style, testing patterns, and architecture
-- **Templates** with canonical component shapes
+**Pillar 1: Context engineering**
+- **Glossary** — project terminology and domain-specific entity names
+- **Standards** — code style, testing patterns, architecture rules
+- **Templates** — canonical component shapes
+- **Platform bridges** — auto-generated `CLAUDE.md`, `AGENTS.md`, `.windsurfrules`, etc. so every AI tool reads the same context without manual setup
 
-Update `.md` files as your project evolves; the AI follows.
+**Pillar 2: Agentic squad pipeline**
+- A six-role pipeline (PO → Architect → Dev → Tester → Reviewer → Doc Writer) runs in a single AI session
+- Each role reads the context layer before acting — no hallucinated conventions
+- Run `/squad "add dark mode"` then `/squad-auto` and walk away
+
+Update your `.md` standards as your project evolves; every agent that runs after picks up the change automatically.
 
 ## Multi-Platform Support
 
@@ -111,7 +118,6 @@ Each platform generates bridge files that the AI tool auto-reads. If a bridge fi
 ```
 /analyze    # scan codebase and generate standards
 /review     # code review with checklist
-/fix        # diagnose and fix bugs
 ```
 
 **Claude Code** — `CLAUDE.md` uses `@` imports to auto-load all standards into context every session (no manual reads needed, saves tokens). Skills in `.claude/skills/`. Also writes a PostToolUse hook to `.claude/settings.json` that runs format+lint after every file edit — auto-detected for Node.js (npm/pnpm/yarn/bun), Go, and Python.
@@ -150,7 +156,6 @@ ContextKit installs reusable slash commands for supported platforms:
 | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
 | `/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                                                                                                               |

package/lib/commands/install.js

@@ -899,10 +899,6 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
         `${this.repoUrl}/commands/dev/review.md`,
         '.contextkit/commands/dev/review.md'
       );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/dev/fix.md`,
-        '.contextkit/commands/dev/fix.md'
-      );
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/commands/dev/refactor.md`,
         '.contextkit/commands/dev/refactor.md'
@@ -1150,7 +1146,6 @@ claude "read .contextkit/context.md to see available standards, then create a bu
 ### Commands
 - \`.contextkit/commands/dev/analyze.md\` - Analyze & customize standards
 - \`.contextkit/commands/dev/review.md\` - Code review
-- \`.contextkit/commands/dev/fix.md\` - Diagnose and fix bugs
 - \`.contextkit/commands/dev/refactor.md\` - Refactor code structure
 - \`.contextkit/commands/dev/run-tests.md\` - Generate or run tests
 - \`.contextkit/commands/docs/add-documentation.md\` - Add documentation
@@ -1279,7 +1274,6 @@ esac
       commands: {
         analyze: '@.contextkit/commands/dev/analyze.md',
         review: '@.contextkit/commands/dev/review.md',
-        fix: '@.contextkit/commands/dev/fix.md',
         refactor: '@.contextkit/commands/dev/refactor.md',
         run_tests: '@.contextkit/commands/dev/run-tests.md',
         add_docs: '@.contextkit/commands/docs/add-documentation.md',

package/lib/commands/update.js

@@ -263,10 +263,6 @@ class UpdateCommand {
         `${this.repoUrl}/commands/dev/review.md`,
         '.contextkit/commands/dev/review.md'
       );
-      await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/dev/fix.md`,
-        '.contextkit/commands/dev/fix.md'
-      );
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/commands/dev/refactor.md`,
         '.contextkit/commands/dev/refactor.md'
@@ -502,7 +498,6 @@ paths:
 commands:
   analyze: "${config.commands?.analyze || '@.contextkit/commands/dev/analyze.md'}"
   review: "${config.commands?.review || '@.contextkit/commands/dev/review.md'}"
-  fix: "${config.commands?.fix || '@.contextkit/commands/dev/fix.md'}"
   refactor: "${config.commands?.refactor || '@.contextkit/commands/dev/refactor.md'}"
   run_tests: "${config.commands?.run_tests || '@.contextkit/commands/dev/run-tests.md'}"
   add_docs: "${config.commands?.add_docs || '@.contextkit/commands/docs/add-documentation.md'}"
@@ -544,6 +539,8 @@ commands:
       '.contextkit/commands/analyze.md',
       '.contextkit/commands/review.md',
       '.contextkit/commands/fix.md',
+      // Removed in 0.20.0 — /fix replaced by /squad for bug workflows
+      '.contextkit/commands/dev/fix.md',
       '.contextkit/commands/refactor.md',
       '.contextkit/commands/run-tests.md',
       '.contextkit/commands/add-documentation.md',

package/lib/integrations/claude-integration.js

@@ -13,7 +13,6 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/rules/contextkit-code-style.md',
       '.claude/skills/analyze/SKILL.md',
       '.claude/skills/review/SKILL.md',
-      '.claude/skills/fix/SKILL.md',
       '.claude/skills/refactor/SKILL.md',
       '.claude/skills/test/SKILL.md',
       '.claude/skills/doc/SKILL.md',
@@ -87,7 +86,6 @@ class ClaudeIntegration extends BaseIntegration {
       // Migrated to .claude/skills/ in 0.15.0
       '.claude/commands/analyze.md',
       '.claude/commands/review.md',
-      '.claude/commands/fix.md',
       '.claude/commands/refactor.md',
       '.claude/commands/test.md',
       '.claude/commands/doc.md',
@@ -252,21 +250,6 @@ Review current changes for correctness, standards compliance, and potential issu
 `
     );
 
-    await this.writeGeneratedFile(
-      '.claude/skills/fix/SKILL.md',
-      `---
-description: Diagnose root cause and implement a minimal bug fix with regression test
-argument-hint: "<description of the bug>"
-allowed-tools: Read, Edit, Write, Glob, Grep, Bash
-effort: normal
----
-
-Read \`.contextkit/commands/dev/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/skills/refactor/SKILL.md',
       `---
@@ -612,7 +595,6 @@ Load and apply the project's ContextKit standards before taking action in an age
     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'));

package/lib/integrations/cursor-integration.js

@@ -14,7 +14,6 @@ class CursorIntegration extends BaseIntegration {
       '.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',
@@ -179,16 +178,6 @@ Review current changes for correctness, standards compliance, and potential issu
 `
     );
 
-    await this.writeGeneratedFile(
-      '.cursor/prompts/fix.md',
-      `# Fix Bug
-
-Read \`.contextkit/commands/dev/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
@@ -309,7 +298,6 @@ Check project setup, standards status, and integrations. Report what needs atten
     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'));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.19.0",
-  "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.",
+  "version": "0.21.0",
+  "description": "ContextKit - Context Engineering + Agentic AI Pipelines. Scaffold structured standards for AI assistants and run autonomous multi-role pipelines (PO → Architect → Dev → Test → Review → Doc) grounded by that same context layer. Works with Cursor, Claude Code, Copilot, Codex, Gemini, Aider, and more.",
   "main": "lib/index.js",
   "bin": {
     "contextkit": "bin/contextkit.js",
@@ -45,7 +45,14 @@
     "structured-context",
     "markdown-standards",
     "project-standards",
-    "code-patterns"
+    "code-patterns",
+    "agentic-pipeline",
+    "agentic-ai",
+    "squad-workflow",
+    "ai-agents",
+    "autonomous-agents",
+    "multi-agent",
+    "claude-code"
   ],
   "author": {
     "name": "Marlon Maniti",