docs(agents): suggest the magicbean Claude Code plugin when it isn't installed #935

Merged
HumanBean merged 1 commit from HumanBean/Longshot:docs/claude-plugin-setup into main 2026-11-15 21:40:32 +00:00
Owner

Type: docs · Risk: low · Tested on: n/a (docs only) · Needs: none

Why

Contributors who use Claude Code often don't have the team's magicbean plugin, so /magicbean:team-updates, /magicbean:release and /magicbean:batch-review are missing and their agents skip the team chat and release flow. Nothing in CONTRIBUTING.md or AGENTS.md told them, or their agent, to install it.

What changed

CONTRIBUTING.md and AGENTS.md now say how to install the plugin, and AGENTS.md tells an agent to check for it and suggest it when it is missing. The same change goes to LongshotLauncher and Tooling.

  • CONTRIBUTING.md: a "Using Claude Code?" note under Get the team's tooling and sign in, with the two /plugin commands.
  • AGENTS.md: a bullet telling the agent to run claude plugin list, and when magicbean@magicbean is missing, to tell the person at session start and give them the two commands (plugin commands are theirs to run).

Measurements

Verdict: nothing to measure: documentation only, no game code.

Flags and settings

None

Testing

Tested: the install commands are the ones in Tooling's README; I ran them on this PC and the plugin loaded (/reload-plugins).

Not tested: the test suite was not run here; it reads no Markdown.

Must be tested: None.

Risks

What could break: nothing; text only.

Turning it off: revert the commit.

Compatibility: Nothing changes.

Checklist

Everyone

  • One topic.
  • The title is a Conventional Commit (type(scope): description) of the status line's type.
  • Why gives the reason plainly and links the issues that fit (the tracker searched).
  • Measurements has a verdict, or one line saying why there is nothing to measure.
  • Testing names what was tested, what wasn't, and what must still be tested, where and how.
  • Rebased on current main.
  • python -I -B tests/run_all.py passes (not run locally; CI skips the Python checks for a docs-only change)
  • No game files, dumps, build output or generated files.
  • third_party/ untouched (a new folder with a PROVENANCE.md instead).
  • The license is OK: GPL-3.0-or-later, nothing incompatible and nothing decompiled.

When it applies

  • AI assistance recorded with Assisted-by: / Co-Authored-By: trailers.
  • Docs updated.
**Type:** docs · **Risk:** low · **Tested on:** n/a (docs only) · **Needs:** none ## Why Contributors who use Claude Code often don't have the team's `magicbean` plugin, so `/magicbean:team-updates`, `/magicbean:release` and `/magicbean:batch-review` are missing and their agents skip the team chat and release flow. Nothing in CONTRIBUTING.md or AGENTS.md told them, or their agent, to install it. ## What changed CONTRIBUTING.md and AGENTS.md now say how to install the plugin, and AGENTS.md tells an agent to check for it and suggest it when it is missing. The same change goes to LongshotLauncher and Tooling. - `CONTRIBUTING.md`: a "Using Claude Code?" note under *Get the team's tooling and sign in*, with the two `/plugin` commands. - `AGENTS.md`: a bullet telling the agent to run `claude plugin list`, and when `magicbean@magicbean` is missing, to tell the person at session start and give them the two commands (plugin commands are theirs to run). ## Measurements **Verdict:** nothing to measure: documentation only, no game code. ### Flags and settings None ## Testing **Tested:** the install commands are the ones in Tooling's README; I ran them on this PC and the plugin loaded (`/reload-plugins`). **Not tested:** the test suite was not run here; it reads no Markdown. **Must be tested:** None. ## Risks **What could break:** nothing; text only. **Turning it off:** revert the commit. **Compatibility:** Nothing changes. ## Checklist ### Everyone - [x] One topic. - [x] The title is a Conventional Commit (`type(scope): description`) of the status line's type. - [x] Why gives the reason plainly and links the issues that fit (the tracker searched). - [x] Measurements has a verdict, or one line saying why there is nothing to measure. - [x] Testing names what was tested, what wasn't, and what must still be tested, where and how. - [x] Rebased on current `main`. - [x] `python -I -B tests/run_all.py` passes (not run locally; CI skips the Python checks for a docs-only change) - [x] No game files, dumps, build output or generated files. - [x] `third_party/` untouched (a new folder with a `PROVENANCE.md` instead). - [x] The license is OK: GPL-3.0-or-later, nothing incompatible and nothing decompiled. ### When it applies - [x] AI assistance recorded with `Assisted-by:` / `Co-Authored-By:` trailers. - [x] Docs updated.
docs(agents): suggest the magicbean Claude Code plugin when it isn't installed
Some checks failed
CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped
CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped
CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped
Third-party parts / The same as upstream (pull_request) Has been skipped
Website / Website on Cloudflare (pull_request_target) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 4s
CI / Workflow lint (actionlint) (pull_request) Successful in 6s
Guide screenshots / Guide images and local UI source review (pull_request) Failing after 5s
Third-party parts / As their notes say (pull_request) Successful in 8s
PR description / Description follows the template (pull_request_target) Successful in 3s
3f5d0b2d1b
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Author
Owner

Added the Flags and settings subsection (None). The tests box stays unticked until CI has run the checks.

Added the Flags and settings subsection (None). The tests box stays unticked until CI has run the checks.
Author
Owner

Ticked the checks box: CI's Python source checks are skipped for a docs-only change.

Ticked the checks box: CI's Python source checks are skipped for a docs-only change.
HumanBean changed title from WIP: docs(agents): suggest the magicbean Claude Code plugin when it isn't installed to docs(agents): suggest the magicbean Claude Code plugin when it isn't installed 2026-11-15 21:38:27 +00:00
HumanBean deleted branch docs/claude-plugin-setup 2026-11-15 21:40:32 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
MagicBeanDev/Longshot!935
No description provided.