@nolrm/contextkit 0.12.10 → 0.12.12

package/README.md

@@ -148,12 +148,11 @@ 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) |
 | `/ck` | Health check — verify setup, standards, and integrations |
@@ -173,7 +172,7 @@ The squad workflow turns a single AI session into a structured multi-role pipeli
 
 | Step | Role | Command | What it does |
 |------|------|---------|-------------|
-| 1 | Product Owner | `/squad` | Writes a user story, acceptance criteria, edge cases, and scope |
+| 1 | Product Owner | `/squad` | Writes a user story, acceptance criteria, edge cases, and scope. Optionally captures screenshots/images as visual assets. |
 | 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 |
@@ -191,10 +190,10 @@ The squad workflow turns a single AI session into a structured multi-role pipeli
 
 ### 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
@@ -204,7 +203,7 @@ For multiple tasks, use batch mode to spec them all up front, then run the full
 **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.
 
 ```bash
-/squad-batch "add dark mode" "fix login bug" "refactor checkout"
+/squad "add dark mode" "fix login bug" "refactor checkout"
 
 /squad-run-agents
 # Phase 1: architect agents for all 3 tasks run in parallel
@@ -223,6 +222,10 @@ 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.
 
+### Visual Assets (Optional)
+
+If you have a screenshot, mockup, or design image relevant to the task, paste or attach it when running `/squad`. The PO agent will save it to `.contextkit/squad/assets/` and reference the path in the handoff. Architect and Dev agents automatically read any listed assets when they pick up the handoff.
+
 ---
 
 ## Git Hooks & Quality Gates

package/lib/commands/install.js

@@ -717,10 +717,6 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
         `${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'

package/lib/commands/update.js

@@ -274,10 +274,6 @@ class UpdateCommand {
         `${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'

package/lib/integrations/claude-integration.js

@@ -22,7 +22,6 @@ 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/spec.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)) {
@@ -236,13 +236,6 @@ Write and run tests against the PO's acceptance criteria.
 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
@@ -256,7 +249,7 @@ Process all batch tasks through the remaining pipeline steps (Architect, Dev, Te
 
 Read \`.contextkit/commands/squad-run-agents.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,7 +280,6 @@ 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(''));

package/lib/integrations/cursor-integration.js

@@ -23,7 +23,6 @@ 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/ck.md',
     ];
@@ -236,13 +235,6 @@ Write and run tests against the PO's acceptance criteria.
 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
@@ -287,7 +279,6 @@ 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(''));
     console.log(chalk.dim('  Health check:'));

package/package.json

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