Repository navigation
Richer squad.agent.md generation for AW coordinator awareness #1608
Description
Scenario
An AW coordinator needs to delegate "review this PR for security issues" to the Squad team. But squad.agent.md is a generic coordinator prompt — it doesn't advertise that Squad has a security specialist, or that Rai does RAI reviews, or what the team's routing rules are.
The AW coordinator ends up sending generic requests that Squad's internal router then re-triages, adding latency and sometimes misrouting because the outer coordinator lacked context about available specialists.
Proposal
squad init generates a squad.agent.md that includes:
- Available specialist roles — enumerated with one-line capability descriptions
- Supported task types — triage, review, docs, planning, security audit, etc.
- Routing hints — "for security concerns, prefer agent X; for TypeScript issues, prefer agent Y"
- Capability summary — what the team can and cannot do (e.g. "can review PRs but cannot deploy")
- Regenerated on
squad castchanges so it stays in sync with the actual team composition
Value
AW + Squad integration works better because the outer coordinator knows what Squad can do without guessing.
Activity
github-actions commentedon Aug 20, 2026
📋 Assigned to Procedures (Prompt Engineer)
Issue: #1608 — Richer squad.agent.md generation for AW coordinator awareness
Procedures will pick this up in the next Copilot session.
fix(agent-context): address CONTROL+FIDO blocking review for #1608
fix(agent-context): correct extractBlockTimestamp regex and strengthe…
fix: sanitize member names and routing fields at embedding point in c…
fix(agent-context): address Copilot review threads for #1608
fix(sdk): harden team capability generation
fix(sdk): handle malformed capability inputs
feat(sdk): advertise real team capabilities in squad.agent.md (github…