Skip to content

Claude member subagent descriptions are written before routing exists and stay vague #2456

Open

Description

@bradygaster

Found in the Claude Code end-to-end test for epic #2438 (fresh repo, dev build, 2026-11-10).

What happens: squad cast --name Inky --role game-developer writes .claude/agents/inky.md right away, with description: "Inky, Game Developer. Owns: Game Developer. …". In Init Mode, the coordinator fills in routing.md after casting, so the member files keep this placeholder description, which just repeats the role, until someone runs squad upgrade.

Why it matters: Claude Code uses the subagent description to decide when to delegate, and a description that repeats the role says nothing about what the member owns.

Suggested fix: refresh the Claude member projection when routing.md changes, for example from the coordinator's Init Mode step or a squad routing write path. Or have Init Mode run squad upgrade --client claude after routing is written.

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

    enhancementNew feature or improvement

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions