Repository navigation
Squad file/name best practices #1997
Description
If we intend to have more than one squad and intend to use it in GH CP app or VSCode, where we want each squad to have a unique name, should we update the name for ./github/agents/squad.agent.md. Or should we copy that file into a new filename and then change the name so that the file name isn't checked during an upgrade.
Activity
bradygaster commentedon Sep 24, 2026
Closing — this is a support/design question rather than a backlog item, and it's already answered by current design:
.github/agents/squad.agent.mdis a fixed path at the git root (one per repo), and per-squad differentiation happens throughteam.md/roster/state content, not by renaming or copying the agent file. Renaming it would break the upgrade path's file-based detection. If multiple distinct squads per single repo/app becomes a real requirement, that's better scoped as its own design issue (possibly folding into #2069, the new Squad specification RFC) rather than left as an open question here.