The Claude Code plugin runs the installed gem through ruby

Status: accepted

The repository is a Claude Code plugin marketplace with one plugin, plugins/rails-ai-context. A plugin is a folder Claude Code copies and starts commands from; it cannot run Bundler or install a gem, and its .mcp.json and hooks are one command line for every platform.

Decision

Consequences

The plugin ships from main on every commit, not from a release tag. It must keep working with the release its requirement names, which CI checks; a release that changes what the plugin relies on raises the requirement only once it is published. The server name rails-ai-context and the script paths are what users' Claude Code configs and permission rules hold on to; renaming either breaks them. The plugin serves the session target AppRoot.target gives for where Claude Code started: one app, or each app of a folder of several through ADR-0012's router. ClaudeCodeSettings models what Claude Code 2.1.308 does where its docs are silent, so a Claude Code release that changes it can make doctor's verdicts wrong until the model follows.

Alternatives not taken