Claude member subagent description repeats itself when name equals role ("QA Engineer, QA Engineer.")

Open Beginner friendly
#2,528 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
84/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
github, node.js, typescript

Research direction

Start with renderClaudeMember in packages/squad-sdk/src/client/adapters/claude-members.ts and trace how it builds the description and Owns: text from the member and routing row. Check nearby tests for Claude member rendering, then verify the output for a name equal to its role and for routed work types equal to the role. Done means those repetitions are omitted while distinct names and work types remain.

Written by the indexing model from the issue text.

Description

bug

Version: CLI built from release/prepare-2.0.0-preview.5 @ 38d45d02 (package version 2.0.0-preview.6).

What happens

.claude/agents/<id>.md builds its description as "<name>, <role>.". Members named after their role, which is common with init --roles and plain-role teams, get a stuttering description:

D=$(mktemp -d); cd "$D"; git init -q
node <squad-cli>/dist/cli-entry.js init --roles --client copilot,claude
node <squad-cli>/dist/cli-entry.js cast --name "QA Engineer" --role "QA Engineer"
node <squad-cli>/dist/cli-entry.js cast --name Quinn --role "Security Engineer"
grep -h '^description' .claude/agents/qa-engineer.md .claude/agents/quinn.md
description: "QA Engineer, QA Engineer. Spawned by the Squad coordinator."
description: "Quinn, Security Engineer. Owns: Security Engineer. Spawned by the Squad coordinator."

The second line shows a related repetition. Right after a cast, the only routing.md row for a member has the role as its work type, so Owns: repeats the role too.

Claude Code chooses which subagent to delegate to from this text, so the repeated words carry no information. Claude Code's /agents list shows these strings verbatim.

Expected

  • When the name equals the role (case-insensitive, after trimming), use just "<role>.".
  • Drop Owns: work types that equal the role, and omit Owns: when nothing is left.

Source

  • packages/squad-sdk/src/client/adapters/claude-members.ts, renderClaudeMember, lines 148–152: summary = purpose ?? \${name}, ${role}.`andOwns: ${routed.join('; ')}`.

Related: #2456 (closed; vague descriptions written before routing exists). This is the remaining cosmetic part.

🤖 Generated with Claude Code

Dominant language
TypeScript
Stars
3.4k
Forks
516
Avg merge
1d 15h
Merged PRs (30d)
116

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from github/squad

All issues in github/squad

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.