Skip to content

Docs: Create missing .squad/templates/human-members.md template #312

Closed

Description

@diberry

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

  1. diberry commented on Mar 9, 2026

    @diberry
    ContributorAuthor

    cc @bradygaster — this is a broken reference in squad.agent.md. Companion to #313. Both need squad:pao labeling for the docs agent.

  2. added a commit that references this issue on Mar 9, 2026
    f99ce53
  3. added a commit that references this issue on Mar 10, 2026
    0d45180
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions