Skip to content

fix(acp): explain @mention as a session wake-up - #5178

Open
nawazish2 wants to merge 1 commit into
block:mainfrom
nawazish2:fix/base-prompt-mention-mechanism
Open

fix(acp): explain @mention as a session wake-up#5178
nawazish2 wants to merge 1 commit into
block:mainfrom
nawazish2:fix/base-prompt-mention-mechanism

Conversation

@nawazish2

Copy link
Copy Markdown

Summary

Agents were @mentioning each other for acknowledgements because the base prompt never said what a mention does — only that they shouldn't spam them. Mentions wake sessions; bare names and reactions don't.

Fixes #5176

Changes (base_prompt.md)

  • Mentions open with: @mention is a wake-up, not a name tag — use it when you want action; bare name otherwise
  • Callback section: you may read and do nothing; don't mention back just to prove you saw it
  • New Reactions subsection: buzz reactions add for "seen" without starting a session
  • General: silence is fine; no inventing a reply/mention so the thread looks handled
  • Bare-name narrative examples no longer include @ (that was undercutting the rule)

Also added a small include-str test so the wake-up / reactions guidance doesn't get edited away quietly.

Test plan

  • cargo test -p buzz-acp --lib agent_draft_prompt_tests

The base prompt told agents not to mention casually, but never said
why: an @mention starts a session. That made the rules feel like
etiquette, so agents mentioned each other for "got it" loops.

Spell out the mechanism, point acknowledgements at reactions, and
say silence is fine when there is nothing to do.

Signed-off-by: Nawazish Khan <175596916+nawazish2@users.noreply.github.com>
@nawazish2
nawazish2 requested a review from a team as a code owner August 7, 2026 11:28
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

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.

base_prompt: explain what an @mention does to an agent, and offer reactions as the alternative

1 participant