Skip to content

docs: never mention the grug handle on GitHub - #81

Merged
quadseven merged 1 commit into
mainfrom
docs/never-at-mention-grug
Sep 23, 2026
Merged

quadseven merged 1 commit into
mainfrom
docs/never-at-mention-grug

Conversation

@quadseven

Copy link
Copy Markdown
Owner

Refs #68.

Why

Two "re-review" requests on this repository (#62 and #69) were posted as an
at-mention of the name grug. That handle belongs to a real GitHub user
unrelated to this project, so both notified them and subscribed them to the
threads, which cannot be undone. The review bot is grug-tribe[bot] and is
driven by slash commands, not mentions. Cloud sessions that see only this
repository need the rule in the repository itself.

What changed

A short paragraph near the top of AGENTS.md: never at-mention that handle
anywhere on GitHub; the bot's commands are /grug improve (re-run code
review) and /grug recheck (re-run the plan check); write grug in backticks
in prose; check text before posting.

Acceptance criteria

  • The rule sits near the top of AGENTS.md, where every reader starts
  • It names the correct slash commands and does not name the person
  • This PR's title, body and commit message contain no at-mention of the handle (checked with grep before posting)

Size: XS

Out of scope

The same rule in other repositories' agent files.

https://claude.ai/code/session_01UkWktkaYXZwdwzUvZQrN9q

The at-handle "grug" belongs to a real GitHub user unrelated to this
project, and two re-review requests (#62, #69) pinged them. AGENTS.md
now says so near the top and names the bot's real slash commands.

Claude-Session: https://claude.ai/code/session_01UkWktkaYXZwdwzUvZQrN9q
@grug-tribe

grug-tribe Bot commented Sep 23, 2026

Copy link
Copy Markdown

Walkthrough

The PR adds a warning to AGENTS.md instructing contributors never to write a bare @​grug mention on GitHub, because it refers to an unrelated real user who gets notified and auto-subscribed (happened twice in issues #62 and #69). It clarifies that the review bot is grug-tribe[bot] and responds to slash commands like /grug improve and /grug recheck, and recommends using backticks around grug in prose and double-checking any text for stray @​grug before posting.

Review effort: quick (~5 min)

Changed files (1)
File Summary Changes
AGENTS.md Added guidance warning against using the bare @​grug GitHub handle and documenting the grug-tribe[bot] slash commands. +8/-0
Shape of the change
graph TD
  subgraph "root"
    N0["AGENTS.md"]
  end
Loading

Last walked at 2931289f1d05.

@quadseven
quadseven merged commit 1bf1964 into main Sep 23, 2026
7 checks passed
@quadseven
quadseven deleted the docs/never-at-mention-grug branch September 23, 2026 12:24
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