feat(cli): prompt to add @copilot during squad init (#1147)

[obit91]

Closes #1147

Problem

Running squad init scaffolds the team but never creates .github/copilot-instructions.md — that file (and the @copilot roster entry) was only produced by the separate squad copilot command. New users who didn't know about that step got a confusing Copilot first-run experience, since Copilot had no Squad context.

Change

During interactive squad init (after scaffolding completes), Squad now prompts:

Add @copilot as an autonomous team member? [y/N]

• yes → adds the @copilot roster entry and copies .github/copilot-instructions.md inline
• no → notes it can be added later with squad copilot
• non-interactive (no TTY) → skips silently, preserving existing behavior

New flags --copilot / --no-copilot skip the prompt for scripted/non-interactive use (e.g. E2E).

Implementation

• Extracted addCopilotToTeam and copyCopilotInstructions helpers in copilot.ts, now shared by the squad copilot command and init. squad copilot behavior is unchanged.
• runInit gains a copilot?: boolean option (tri-state) and a promptCopilot step.
• @copilot opt-in is skipped for --global (personal squad) and when @copilot is already on the team (idempotent re-init).

Tests

• Extended test/cli/init.test.ts: default non-interactive does not add @copilot; copilot: false skips; copilot: true adds roster + instructions; re-init is idempotent.
• npm run build passes; init + copilot suites green (25 tests).

Notes

• Includes a minor changeset for @bradygaster/squad-cli.
• The canonical command is squad copilot (the issue's squad copilot enable phrasing); messaging uses squad copilot.

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds an explicit, tri-state @copilot opt-in flow to squad init, including CLI flags and tests to ensure non-interactive runs don’t silently modify repos.

Changes:

• Add --copilot / --no-copilot support to squad init, with interactive prompting only when attached to a TTY.
• Extract shared “add @copilot + copy instructions” logic into a reusable helper used by both init and copilot commands.
• Add CLI tests covering default behavior, explicit opt-in/out, and idempotency.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
test/cli/init.test.ts	Adds coverage for @copilot opt-in/out and idempotency during init.
packages/squad-cli/src/cli/core/init.ts	Introduces tri-state copilot option and interactive prompt behavior after scaffolding.
packages/squad-cli/src/cli/commands/copilot.ts	Extracts shared helpers for adding @copilot and copying instructions template.
packages/squad-cli/src/cli-entry.ts	Adds flags/help text and wires parsed copilot tri-state into runInit.
packages/squad-cli/README.md	Documents squad init --copilot usage.
.changeset/init-copilot-opt-in.md	Declares a minor release and documents the new opt-in behavior/flags.

[github-actions]

🏗️ Architectural Review

⚠️ Architectural review: 1 warning(s).

Severity	Category	Finding	Files
🟡 warning	bootstrap-area	1 file(s) in the bootstrap area (packages/squad-cli/src/cli/core/) were modified. These files must maintain zero external dependencies. Review carefully.	packages/squad-cli/src/cli/core/init.ts

---

Automated architectural review — informational only.

[github-actions]

🟡 Impact Analysis — PR #1199

Risk tier: 🟡 MEDIUM

📊 Summary

Metric	Count
Files changed	6
Files added	1
Files modified	5
Files deleted	0
Modules touched	3

🎯 Risk Factors

• 6 files changed (6-20 → MEDIUM)
• 3 modules touched (2-4 → MEDIUM)

📦 Modules Affected

root (1 file)

• .changeset/init-copilot-opt-in.md

squad-cli (4 files)

• packages/squad-cli/README.md
• packages/squad-cli/src/cli-entry.ts
• packages/squad-cli/src/cli/commands/copilot.ts
• packages/squad-cli/src/cli/core/init.ts

tests (1 file)

• test/cli/init.test.ts

---

This report is generated automatically for every PR. See #733 for details.

[github-actions]

🛫 PR Readiness Check

ℹ️ This comment updates on each push. Last checked: commit ccab2ee

PR Scope: 📦🔧 Mixed (product + infrastructure)

⚠️ 3 item(s) to address before review

Status	Check	Details
❌	Single commit	3 commits — consider squashing before review
✅	Not in draft	Ready for review
✅	Branch up to date	Up to date with dev
❌	Copilot review	No Copilot review yet — it may still be processing
✅	Changeset present	Changeset file found
✅	Scope clean	No .squad/ or docs/proposals/ files
✅	No merge conflicts	No merge conflicts
✅	Copilot threads resolved	1 active Copilot thread(s) resolved (3 outdated skipped)
❌	CI passing	7 check(s) still running

Files Changed (6 files, +194 −17)

File	+/−
.changeset/init-copilot-opt-in.md	+5 −0
packages/squad-cli/README.md	+1 −0
packages/squad-cli/src/cli-entry.ts	+9 −3
packages/squad-cli/src/cli/commands/copilot.ts	+58 −14
packages/squad-cli/src/cli/core/init.ts	+76 −0
test/cli/init.test.ts	+45 −0

Total: +194 −17

---

This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.