feat(ci-squad): GitHub Issues → auto-branch, squad pipeline, draft PR (0.13.3)

  Label any issue  to trigger a full squad pipeline in GitHub
  Actions — no local setup needed. Draft PR opened on completion.

  - New opt-in prompt in
   ______                     __                     __     __ __    _    __
  / ____/  ____     ____     / /_   ___     _  __   / /_   / //_/   (_)  / /_
 / /      / __ \   / __ \   / __/  / _ \   | |/_/  / __/  / ,<     / /  / __/
/ /___   / /_/ /  / / / /  / /_   /  __/  _>  <   / /_   / /| |   / /  / /_
\____/   \____/  /_/ /_/   \__/   \___/  /_/|_|   \__/  /_/ |_|  /_/   \__/

🎵 Installing ContextKit...

🧩 Detected project: node
📦 Package manager: pnpm

? ContextKit is already installed. Do you want to reinstall? (y/N) �[67D�[67C�[2K�[G? ContextKit is already installed. Do you want to reinstall? No�[63D�[63C
⏭️  Installation cancelled
💡 To get the latest command and squad files, run: ck update /
   ______                     __                     __     __ __    _    __
  / ____/  ____     ____     / /_   ___     _  __   / /_   / //_/   (_)  / /_
 / /      / __ \   / __ \   / __/  / _ \   | |/_/  / __/  / ,<     / /  / __/
/ /___   / /_/ /  / / / /  / /_   /  __/  _>  <   / /_   / /| |   / /  / /_
\____/   \____/  /_/ /_/   \__/   \___/  /_/|_|   \__/  /_/ |_|  /_/   \__/

🔄 Updating ContextKit...
📦 Updating from latest to latest
🪝 Setting up Git hooks...
✅ Git hooks path set to .contextkit/hooks
✅ Git hooks setup complete
  ✅ Refreshed 1 platform integration(s)
✅ ContextKit updated successfully! for squad-issue.yml
  - New squad-ci.md command for non-interactive CI pipeline mode
  - squad_ci_workflow flag persisted in config.yml
  - Docs: new CI Squad page, sidebar entry, squad page callout
  - Fix: commit-msg hook types (style → improve)

Author: nolrm

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.13.3] - 2026-03-16
+
+### Added
+- **CI Squad** — label any GitHub issue `squad-ready` to trigger a full squad pipeline in GitHub Actions (PO → Architect → Dev → Test → Review → Doc) and open a draft PR automatically. No local setup required.
+- **`ck install` CI Squad prompt** — opt-in prompt during install downloads `squad-issue.yml` to `.github/workflows/` and records `squad_ci_workflow: true` in config
+- **`ck update` CI Squad sync** — re-downloads `squad-issue.yml` on `ck update` when `squad_ci_workflow` flag is set
+- **`squad-ci.md` command** — new command distributed via install/update; instructs Claude Code CLI to run the full pipeline non-interactively in CI mode. On clarify: posts a GitHub comment and exits 0. On completion: writes `ci-result.md` for the PR body.
+- **`templates/github-actions/squad-issue.yml`** — new GitHub Actions workflow template with branch creation, clarify comment flow, concurrency guard, and draft PR creation
+- **Docs: CI Squad page** — new website page covering setup, how it works, writing good issues, clarify flow, and behaviour table
+
+### Fixed
+- **Website: commit types** — quality-gates page was showing stale `style` type; updated to `improve` (matches CLI and standards)
+
+---
+
 ## [0.13.2] - 2026-03-13
 
 ### Fixed

CLAUDE.md

@@ -4,7 +4,7 @@
 This project uses [ContextKit](https://github.com/nolrm/contextkit) for AI development standards.
 
 ## ContextKit
-Version: 0.13.1
+Version: 0.13.2
 
 ## Project Standards
 

README.md

@@ -284,6 +284,36 @@ Hooks are optional and can be skipped with `ck install --no-hooks`.
 
 ---
 
+## CI Squad — GitHub Issues → PR
+
+ContextKit can automatically turn GitHub issues into pull requests — no local development required.
+
+**How it works:**
+
+1. Label any issue `squad-ready`
+2. GitHub Actions runs the full squad pipeline (architect → dev → test → review) using Claude
+3. A draft PR is opened, linked to the issue
+
+**Setup:**
+
+```bash
+ck install   # answer "yes" to the CI squad prompt
+```
+
+Then add your Anthropic API key as a repository secret:
+
+> **Settings → Secrets and variables → Actions → New repository secret**
+> Name: `ANTHROPIC_API_KEY`
+
+**Tips:**
+
+- Write issues with clear acceptance criteria for the best results
+- If the issue is too vague, the workflow posts a comment asking for clarification instead of generating a bad PR
+- PRs always open as **draft** — you review and merge manually
+- Re-apply the `squad-ready` label after answering a clarification comment to re-trigger the pipeline
+
+---
+
 ## Key Features
 
 - 🧠 **Context Engineering** - Structured MD files your AI reads automatically

__tests__/commands/install.test.js

@@ -273,14 +273,19 @@ describe('InstallCommand', () => {
     };
     getIntegration.mockReturnValue(mockIntegration);
 
-    // First prompt: platform choice, second: git hooks (prePush), third: git hooks (commitMsg)
-    inquirer.prompt
-      .mockResolvedValueOnce({ platform: 'cursor' })
-      .mockResolvedValueOnce({ prePush: false })
-      .mockResolvedValueOnce({ commitMsg: false });
+    // Force CI=true so promptGitHubActionsWorkflow() returns early (no prompt consumed)
+    const savedCI = process.env.CI;
+    process.env.CI = 'true';
+    inquirer.prompt.mockReset();
+    inquirer.prompt.mockResolvedValueOnce({ platform: 'cursor' });
 
     const install = getInstallModule();
-    await install({ fullInstall: true });
+    try {
+      await install({ fullInstall: true, noHooks: true });
+    } finally {
+      if (savedCI === undefined) delete process.env.CI;
+      else process.env.CI = savedCI;
+    }
 
     // Should have prompted for platform
     expect(inquirer.prompt).toHaveBeenCalledWith(
@@ -342,6 +347,58 @@ describe('InstallCommand', () => {
     expect(config).toContain('npm: "https://www.npmjs.com/package/@nolrm/contextkit"');
   });
 
+  it('23. CI squad workflow is installed when prompt returns yes', async () => {
+    // Temporarily unset CI env so promptGitHubActionsWorkflow runs interactively
+    const savedCI = process.env.CI;
+    delete process.env.CI;
+
+    try {
+      inquirer.prompt.mockReset();
+      // noHooks=true skips hook prompts; mock squad CI (yes) then platform (none)
+      inquirer.prompt
+        .mockResolvedValueOnce({ squadCi: true })
+        .mockResolvedValueOnce({ platform: null });
+
+      const install = getInstallModule();
+      await install({ noHooks: true });
+
+      expect(await fs.pathExists('.github/workflows/squad-issue.yml')).toBe(true);
+      const config = await fs.readFile('.contextkit/config.yml', 'utf8');
+      expect(config).toContain('squad_ci_workflow: true');
+    } finally {
+      process.env.CI = savedCI;
+    }
+  });
+
+  it('24. config.yml sets squad_ci_workflow: false when prompt declined', async () => {
+    const savedCI = process.env.CI;
+    delete process.env.CI;
+
+    try {
+      inquirer.prompt.mockReset();
+      inquirer.prompt
+        .mockResolvedValueOnce({ squadCi: false })
+        .mockResolvedValueOnce({ platform: null });
+
+      const install = getInstallModule();
+      await install({ noHooks: true });
+
+      expect(await fs.pathExists('.github/workflows/squad-issue.yml')).toBe(false);
+      const config = await fs.readFile('.contextkit/config.yml', 'utf8');
+      expect(config).toContain('squad_ci_workflow: false');
+    } finally {
+      process.env.CI = savedCI;
+    }
+  });
+
+  it('25. config.yml sets squad_ci_workflow: false by default', async () => {
+    const install = getInstallModule();
+    await install({ nonInteractive: true, noHooks: true });
+
+    const config = await fs.readFile('.contextkit/config.yml', 'utf8');
+    expect(config).toContain('squad_ci_workflow: false');
+  });
+
   it('22. ck install <platform> when already installed adds platform without reinstall prompt', async () => {
     const { getIntegration } = require('../../lib/integrations');
     const mockIntegration = {

__tests__/commands/update.test.js

@@ -223,6 +223,46 @@ describe('UpdateCommand', () => {
     expect(await fs.pathExists('.contextkit/commands/my-custom-command.md')).toBe(true);
   });
 
+  it('12. always downloads squad-ci.md command on update', async () => {
+    const DownloadManager = require('../../lib/utils/download');
+    await fs.ensureDir('.contextkit');
+    await fs.writeFile('.contextkit/config.yml', baseConfig);
+
+    const update = getUpdateModule();
+    await update({ force: true });
+
+    const downloadMock = DownloadManager.mock.results.at(-1).value;
+    const downloadedUrls = downloadMock.downloadFile.mock.calls.map(c => c[0]);
+    expect(downloadedUrls.some(u => u.includes('squad-ci.md'))).toBe(true);
+  });
+
+  it('13. updates squad-issue.yml when squad_ci_workflow feature is enabled', async () => {
+    const DownloadManager = require('../../lib/utils/download');
+    const configWithSquadCi = baseConfig + '  squad_ci_workflow: true\n';
+    await fs.ensureDir('.contextkit');
+    await fs.writeFile('.contextkit/config.yml', configWithSquadCi);
+
+    const update = getUpdateModule();
+    await update({ force: true });
+
+    const downloadMock = DownloadManager.mock.results.at(-1).value;
+    const downloadedDests = downloadMock.downloadFile.mock.calls.map(c => c[1]);
+    expect(downloadedDests.some(d => d.includes('squad-issue.yml'))).toBe(true);
+  });
+
+  it('14. does not update squad-issue.yml when squad_ci_workflow is false', async () => {
+    const DownloadManager = require('../../lib/utils/download');
+    await fs.ensureDir('.contextkit');
+    await fs.writeFile('.contextkit/config.yml', baseConfig);
+
+    const update = getUpdateModule();
+    await update({ force: true });
+
+    const downloadMock = DownloadManager.mock.results.at(-1).value;
+    const downloadedDests = downloadMock.downloadFile.mock.calls.map(c => c[1]);
+    expect(downloadedDests.some(d => d.includes('squad-issue.yml'))).toBe(false);
+  });
+
   it('11. version comparison works correctly', async () => {
     // Access the class to test isNewerVersion
     delete require.cache[require.resolve('../../lib/commands/update')];

commands/squad-ci.md

@@ -0,0 +1,176 @@
+# Squad CI — Automated Pipeline
+
+You are the **Squad CI Runner** — an automated agent executing the full squad pipeline inside a GitHub Actions workflow. There is no human present. Do not pause for input, ask questions interactively, or wait for confirmation.
+
+## Key Differences from Interactive Squad
+
+| Interactive (`/squad-auto`) | CI mode (this command) |
+|-----------------------------|------------------------|
+| Can pause for clarification | Posts a comment instead and exits |
+| Can use sub-agents | Runs all phases inline |
+| Checkpoints configurable | Always runs full pipeline |
+| Human reviews handoff | Writes `ci-result.md` for the workflow |
+
+---
+
+## Step 1 — Read context
+
+Read `.contextkit/squad/handoff.md`. Note the `task:` field and the issue context in the PO Spec `### Answers` section.
+
+Check `ISSUE_NUMBER` from the environment (`$ISSUE_NUMBER`).
+
+---
+
+## Step 2 — PO Phase
+
+The handoff arrives with `status: po` and raw issue content in the spec. Your job:
+
+1. Read the issue title (task field) and issue body (in `### Answers`)
+2. **Assess clarity**: Is the issue specific enough to write testable acceptance criteria?
+
+**If too vague** (missing: what to build, success criteria, or key constraints):
+- Write `### Questions` listing up to 5 specific questions that would unblock the spec
+- Write `.contextkit/squad/ci-result.md`:
+  ```
+  status: clarify
+
+  ### Questions
+
+  1. [question]
+  2. [question]
+  ```
+- Set handoff `status: po-clarify`
+- **Stop here.** The workflow will post a GitHub comment with the questions.
+
+**If clear enough**: Write the full PO Spec:
+- **User Story** — As a [role], I want [feature], so that [benefit]
+- **Acceptance Criteria** — specific, testable, numbered
+- **Edge Cases** — what dev and tester should handle
+- **Out of Scope** — scope guard
+
+Set `## 1. PO Spec` → `status: done`. Set top-level `status:` → `architect`.
+
+---
+
+## Step 3 — Architect Phase
+
+Read the PO Spec. Explore the codebase. Fill in `## 2. Architect Plan`:
+- **Approach**: High-level technical approach
+- **Files to Change**: Every file to create/modify with a summary
+- **Trade-offs**: Alternatives considered
+- **Implementation Steps**: Numbered, ordered steps for dev
+
+Set `## 2. Architect Plan` → `status: done`. Set top-level `status:` → `dev`.
+
+---
+
+## Step 4 — Dev Phase
+
+Read PO Spec and Architect Plan. Implement the code following the architect's steps exactly.
+
+Fill in `## 3. Dev Implementation`:
+- **Changes Made**: Files changed and what was done
+- **Decisions & Deviations**: Any deviations from the plan and why
+
+Set `## 3. Dev Implementation` → `status: done`. Set top-level `status:` → `test`.
+
+---
+
+## Step 5 — Test Phase
+
+Write tests against the acceptance criteria. Run the tests.
+
+Fill in `## 4. Test Report`:
+- **Tests Written**: Numbered test cases (follow project testing standards)
+- **Results**: Pass/fail counts and exit code
+- **Coverage Notes**: Which acceptance criteria are covered
+
+Set `## 4. Test Report` → `status: done`. Set top-level `status:` → `review`.
+
+---
+
+## Step 6 — Review Phase
+
+Read the full handoff. Fill in `## 6. Review`:
+- **Checklist**: Verify each acceptance criterion is met
+- **Issues Found**: List any issues (or "None")
+- **Verdict**: `pass` or `needs-work`
+
+Set `## 6. Review` → `status: done`.
+
+**If verdict is `needs-work`**: Set top-level `status:` → `review`. Write `ci-result.md`:
+```
+status: needs-work
+
+## Review Issues
+
+[list of issues found]
+```
+Then continue to write the PR body anyway (draft PR will be opened with the issues noted).
+
+**If verdict is `pass`**: Set top-level `status:` → `doc`. Continue to Doc phase.
+
+---
+
+## Step 7 — Doc Phase
+
+For each new file: create a companion `<filename>.md` with Purpose, Public API, Usage Example, Edge Cases.
+For modified files: update companion `.md` if the change was significant.
+Check if README or `.contextkit/` docs reference changed files — update if stale.
+
+Fill in `## 7. Doc` → `status: done`. Set top-level `status:` → `done`.
+
+---
+
+## Step 8 — Write ci-result.md
+
+Write `.contextkit/squad/ci-result.md` so the workflow can build the PR:
+
+```markdown
+status: done
+
+## Summary
+
+[1-3 sentences: what was built and why]
+
+## Changes
+
+- [file]: [what changed]
+- [file]: [what changed]
+
+## Test Results
+
+[pass count] tests passing. [any notes]
+
+## Review Verdict
+
+pass
+```
+
+If review was `needs-work`, write:
+```markdown
+status: needs-work
+
+## Summary
+
+[what was built]
+
+## Review Issues
+
+[list of issues — the PR will be opened as draft for human review]
+
+## Test Results
+
+[results]
+```
+
+---
+
+## Important Rules
+
+- Never pause for user input
+- Never use interactive prompts or spinner tools
+- Run all phases inline — no sub-agents
+- If any phase produces an error you cannot recover from, write `ci-result.md` with `status: error\n\n[description]` and stop
+- Follow all project standards from `.contextkit/standards/`
+- Numbered test cases are required: `it('1. description')`