Claude member subagent description repeats itself when name equals role ("QA Engineer, QA Engineer.")
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
- Domain
- cli, developer-experience
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
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 omitOwns: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
- Ships a Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from github/squad
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
In-app coordinator/Ralph never reads .squad/ralph-instructions.md; only `squad watch --execute` doesOpenwave:2-soon
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
ilan-pinto/roaring-lions#1552 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
bug: [React Native/Android] KeepAliveService never starts when CAMERA is not granted (Android 14+)Open
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
cloudflare/realtimekit-ui#208 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
usebruno/bruno-vscode#235 ·
Maintainers usually reply within 3 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day