Skip to content

Squad picker

{project-root} is the directory that contains _bmad/. {git-root} is the git toplevel. Each squad is [workflow.teams.<id>] with path_prefixes relative to {git-root} (for example client/ when the product folder is client/). Match cwd and git diff paths against {git-root}.

BMad’s {project-root} token still means the working directory for stock agents; run from the product folder (or use absolute paths) so menu file:{project-root}/... overlays resolve.

flowchart TD
  empty{"teams table empty?"} -->|yes| askOverlay[Ask for an org overlay]
  empty -->|no| named{"User named a team key or name?"}
  named -->|yes| use[Use that key]
  named -->|no| cwd{"cwd matches one path_prefixes?"}
  cwd -->|yes| use
  cwd -->|no| diff{"Changed files match prefixes?"}
  diff -->|one team| use
  diff -->|two teams| ask[Ask — do not pick majority]
  diff -->|none| ask

Rules in bglad-ticket-mr SKILL.md: empty teams → ask; named team wins; else current directory; else changed files; two teams → ask; no match → ask. Team values win over repo-wide ones. State the team name once.

Different reviewers or extra implement facts: Override defaults.