## Problem `squad.agent.md` references `.squad/templates/human-members.md` as an on-demand reference: > **On-demand reference:** Read `.squad/templates/human-members.md` for triggers, comparison table, adding/routing/reviewing details. **This file does not exist.** It's a broken reference — users and the coordinator are directed to a file that was never created. ## What should be in the template Based on what `squad.agent.md` promises and what the existing docs pages (`human-team-members.md`, `your-team.md`) already cover: 1. **Triggers** — when does the coordinator enter the human-member flow 2. **Comparison table** — AI agent vs. human member (capabilities, files, spawning) 3. **Adding a human** — step-by-step (roster entry format, routing updates) 4. **Routing to a human** — how the coordinator pauses, stale reminders, relay model 5. **Reviewing as a human** — rejection lockout applies, how reviews work 6. **Decision framework** — when to add someone as a human member vs. just @mention them (see #issue2 below) ## Acceptance criteria - [ ] `.squad/templates/human-members.md` exists and follows the same style as other template files - [ ] `squad.agent.md` reference resolves correctly - [ ] Content covers all 6 areas listed above
Activity
diberry commentedon Mar 9, 2026
cc @bradygaster — this is a broken reference in squad.agent.md. Companion to #313. Both need
squad:paolabeling for the docs agent.docs: create missing human-members.md template
docs(squad): log PR github#131 issue creation
feat: remote squad mode + doctor command + docs cleanup
docs: create missing human-members.md template (github#315)