Skip to content

fix(squad): warn leader against label/UUID mismatch in delegations#64

Merged
furtherref merged 1 commit into
mainfrom
fix/squad-briefing-label-uuid-decoupling
May 19, 2026
Merged

fix(squad): warn leader against label/UUID mismatch in delegations#64
furtherref merged 1 commit into
mainfrom
fix/squad-briefing-label-uuid-decoupling

Conversation

@furtherref
Copy link
Copy Markdown
Owner

Summary

@mention routing is decided by the UUID inside (mention://agent/<UUID>); the [Label] part is decorative — only ever rendered for humans. A squad-leader LLM that pairs one Squad Roster row's label with another row's UUID produces a delegation that looks addressed to A in the UI but silently triggers B (concrete incident: a comment that read @阚美荣-代码审查-GPT actually dispatched 代码审查-张桐-AI).

The existing Squad Operating Protocol already required leaders to use the full [@Name](mention://<type>/<UUID>) markdown, but it never stated that the two halves are decoupled, so the LLM had no reason to treat the link as a single indivisible string when copying from the Roster.

Add a hard rule with a worked counter-example. Lowest-cost layer of defense — pure prompt change, no code or data touched.

Test plan

  • go test ./server/internal/handler -run TestBuildSquadLeader — the existing briefing tests assert on substring presence, so the new text passes through without breaking them
  • Manual: trigger a squad with two agents whose names differ only in role suffix; observe that the leader's delegation comments no longer cross-pair Label and UUID

🤖 Generated with Claude Code

…ther's UUID

The Squad Operating Protocol already required leaders to use the
full `[@name](mention://<type>/<UUID>)` markdown, but it never
called out that the `[Label]` and `(UUID)` parts are decoupled —
only the UUID routes, the label is decorative. An LLM leader could
(and did) Frankenstein a delegation by pairing one roster row's
label with another row's UUID, producing a comment that looked
addressed to A but actually triggered B.

Add a hard rule + worked counter-example so the leader prompt
states the decoupling explicitly.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
multica-web Ready Ready Preview, Comment May 19, 2026 0:59am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
multica-docs Ignored Ignored May 19, 2026 0:59am

@furtherref furtherref merged commit b308083 into main May 19, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant