feat(gh-aw): Squad Agentic Workflows — /squad command #1612

Epic: Squad Agentic Workflows — /squad command

The unified GitHub Agentic Workflows integration for Squad. One slash command (/squad) handles all squad lifecycle operations via agent intelligence, delivered as reviewable PRs.

User Journey

1. Install: gh aw add bradygaster/squad/workflows/squad.md@latest
2. Trigger: User invokes /squad (or variations like /squad from org/repo, /squad adopt org/repo)
3. Analyze: Agent analyzes repo structure, languages, CI, patterns
4. Cast: Squad casting intelligence composes the right team
5. Deliver: Opens PR with full .squad/ scaffolding, squad.agent.md, meet-the-squad.md
6. Iterate: User refines via /squad cast ... or /squad retire ... comments
7. Merge: User merges PR → Squad is live and operational

Distribution Model

Files live in workflows/ in our repo (NOT .github/workflows/). Users install via gh-aw add command pointing at our repo.

Three Sourcing Modes

/squad Command Intents

• /squad → Cast mode (analyze repo, propose team)
• /squad from org/squad-repo → Connect mode
• /squad adopt org/squad-repo → Adopt mode
• /squad cast a mermaid diagram specialist → Add member to existing squad
• /squad retire the tester → Remove member
• /squad status → Report team state

PR Outputs

• .squad/ (full scaffolding with charters, routing, casting state)
• .github/agents/squad.agent.md (coordinator custom agent)
• meet-the-squad.md (repo root — introduces the cast)
• copilot-setup-steps.yml (if missing — reduces friction)

Sub-Issues

• chore(gh-aw): Create workflows/ directory with squad.md + shared/squad.md #1620 — chore(gh-aw): Create workflows/ directory with squad.md + shared/squad.md
• feat(gh-aw): Create shared/squad.md bootstrap component #1613 — feat(gh-aw): Create shared/squad.md bootstrap component
• feat(gh-aw): /squad command — Cast mode (fresh team) #1614 — feat(gh-aw): /squad command — Cast mode (fresh team)
• feat(gh-aw): /squad from {url} — Connect mode (remote squad) #1615 — feat(gh-aw): /squad from {url} — Connect mode (remote squad)
• feat(gh-aw): /squad adopt {url} — Adopt mode (fork squad) #1616 — feat(gh-aw): /squad adopt {url} — Adopt mode (fork squad)
• feat(gh-aw): /squad cast — iterate squad composition via PR/issue comments #1617 — feat(gh-aw): /squad cast — iterate squad composition via PR/issue comments
• feat(gh-aw): Generate meet-the-squad.md in repo root #1618 — feat(gh-aw): Generate meet-the-squad.md in repo root
• feat(gh-aw): Auto-install copilot-setup-steps.yml when missing #1619 — feat(gh-aw): Auto-install copilot-setup-steps.yml when missing

Dependency Order

#1620 (directory structure)
  └→ #1613 (shared/squad.md bootstrap)
       ├→ #1614 (Cast mode) → #1617 (cast/retire iteration)
       ├→ #1615 (Connect mode)        ↘
       ├→ #1616 (Adopt mode)    #1618 (meet-the-squad.md)
       └→ #1619 (copilot-setup-steps.yml)

Acceptance Criteria

• All sub-issues are completed and merged
• gh aw add bradygaster/squad/workflows/squad.md@latest installs successfully
• /squad command triggers Cast mode end-to-end
• /squad from and /squad adopt modes function correctly
• /squad cast and /squad retire enable conversational iteration
• All PRs include meet-the-squad.md and conditional copilot-setup-steps.yml
• Documentation covers all modes and commands