How bradygaster/squad works
Squad is a human-led multi-agent development product for GitHub Copilot. The documented path is to initialize a project team, propose and confirm agents, then direct work through Copilot, where requests are routed to specialists whose knowledge and decisions persist in project state. The repository also includes issue triage, platform integrations, plugins, team sharing, remote control, and a .NET adapter. The README establishes the user workflow; sampled source confirms casting and storage behavior, but does not expose enough call sites to assert all subsystem wiring.
Main entry points: cli-entry.ts Squad CLI · coordinator.ts Request coordinator · lifecycle.ts Agent lifecycle · index.ts Issue watch
Components 22
Team setup
- Squad CLI
packages/squad-cli/src/cli-entry.ts - CLI commands
packages/squad-cli/src/cli/commands - Team initialization
packages/squad-sdk/src/config/init.ts - Agent casting
packages/squad-sdk/src/casting/casting-engine.ts - Role catalog
packages/squad-sdk/src/roles/catalog.ts - Team configuration
packages/squad-sdk/src/config/routing.ts
Agent runtime
- Request coordinator
packages/squad-sdk/src/coordinator/coordinator.ts - Agent lifecycle
packages/squad-sdk/src/agents/lifecycle.ts - Agent memory
packages/squad-sdk/src/memory/index.ts - Squad state
packages/squad-sdk/src/state/squad-state.ts - Storage providers
packages/squad-sdk/src/storage/storage-provider.ts
Operations
- Issue watch
packages/squad-cli/src/cli/commands/watch/index.ts - Triage capabilities
packages/squad-sdk/src/ralph/capabilities.ts
Integrations
- Platform connectors
packages/squad-sdk/src/platform/index.ts - Plugin marketplace
packages/squad-sdk/src/marketplace/index.ts - Team sharing
packages/squad-sdk/src/sharing/index.ts - Remote control
packages/squad-sdk/src/remote/index.ts - .NET agent adapter
src/Squad.Agents.AI/SquadServiceCollectionExtensions.cs
Other components
- Human operator
- GitHub Copilot
- GitHub services
- Project team files
Connections 19
- Human operator → Squad CLI: runs commands
- Squad CLI → CLI commands: dispatches
- CLI commands → Team initialization: initializes team
- Team initialization → Project team files: creates team files
- Human operator → GitHub Copilot: directs work
- GitHub Copilot → Request coordinator: submits requests
- Request coordinator → Team configuration: routes requests
- Request coordinator → Agent lifecycle: coordinates agents
- Agent lifecycle → Agent memory: uses knowledge
- Agent lifecycle → Squad state: persists learnings
- Squad state → Storage providers: stores state
- Squad CLI → Issue watch: starts triage
- Issue watch → Triage capabilities: loads capabilities
- Issue watch → Platform connectors: checks work items
- Platform connectors → GitHub services: integrates with
- Squad CLI → Plugin marketplace: manages plugins
- Squad CLI → Team sharing: exports or imports
- GitHub Copilot → Remote control: remote access
- .NET agent adapter → Project team files: reads squad folder