Subchapter 12.16
copilot-instructions.mdMarkdown3 KBView on GitHub
You are working on a project that uses Squad, an AI team framework. When picking up issues autonomously or using Squad, follow these guidelines.
IMPORTANT — run this check only when the session is expected to use Squad Coordinator behavior, before doing any Squad work:
Look for the exact token SQUAD_COORDINATOR_CANARY_a8f3 in your agent_instructions. This token is placed at the end of squad.agent.md. If it is missing, the coordinator file is missing or truncated.
Do not run this check for ordinary Copilot Coding Agent work, or when the user explicitly asks not to use Squad. In that case, proceed without Squad routing, spawning, PR, or branch-protection behavior.
When the token is missing and Squad Coordinator behavior is required, you MUST:
⚠️ Squad coordinator (squad.agent.md) appears to be missing or truncated. The canary token was not found. Do NOT proceed with standard Squad behavior — Squad's safety rails are not loaded. Please restart your session.Before starting work on any issue:
.squad/team.md for the team roster, member roles, and your capability profile..squad/routing.md for work routing rules.squad:{member} label, read that member’s charter at .squad/agents/{member}/charter.md to understand their domain expertise and coding style — work in their voice.Before starting work, check your capability profile in .squad/team.md under the Coding Agent → Capabilities section.
🤖 This issue doesn't match my capability profile (reason: {why}). Suggesting reassignment to a squad member.Use the squad branch convention:
squad/{issue-number}-{kebab-case-slug}Example: squad/42-fix-login-validation
When opening a PR:
Closes #{issue-number}squad:{member} label, mention the member: Working as {member} ({role})⚠️ This task was flagged as "needs review" — please have a squad member review before merging..squad/decisions.mdIf you make a decision that affects other team members, write it to:
.squad/decisions/inbox/copilot-{brief-slug}.mdThe Scribe will merge it into the shared decisions file.