Files
reliquary/plugins/bevy/README.md
T
g4borg 325e278af1 Scaffold bevy plugin with bevy-0.19 and bevy-upgrade skills
Add plugin skeleton with versioned skill directories, TODO SKILL.md
scaffolds with goals for skill-creator, and copy over bevy-skill-research
reports from spacecraft into docs/workpad/research/.
2026-07-07 17:52:00 +02:00

3.1 KiB

bevy

Skills for developing with the Bevy game engine in Rust.

Bevy's rapid release cycle (0.16 through 0.19 in ~18 months) introduces fundamental API renames and semantic shifts between versions. LLMs confidently generate code against outdated patterns — Parent instead of ChildOf, Event instead of Message, use_state idioms that no longer exist. These skills exist to correct that.

Skills

  • bevy-0.19 — Implementation helper for writing correct, idiomatic Bevy 0.19 code. Covers plugins, ECS, hierarchy, events/observers, input, camera, and production gotchas. Triggers on Bevy 0.19 Rust code. Contains a compact always-loaded cheat sheet plus a references/ folder for deeper topic dives.
  • bevy-upgrade — Version migration guide for upgrading between Bevy releases. Covers the breaking-change chain (0.16 through 0.19+) with rename tables, semantic shifts, and step-by-step migration patterns. Invoked by the bevy skill when an upgrade task is detected, or directly when the user asks to migrate.

Research

The research that informed this plugin's design lives in docs/workpad/research/bevy-skill-research/. Key reports:

Report Topic
01-plugins Plugin trait lifecycle, dependencies, states, schedules
02-ecs-core Components, resources, systems, queries, commands
03-hierarchy ChildOf relationships, spawning/querying children
04-events-observers Message/Event split (0.18), observers, lifecycle triggers
05-input Keyboard, mouse, gamepad, touch input patterns
06-camera-gotchas Camera setup, rendering, coordinates
07-lessons-from-production 15 gotchas from a production Bevy 0.18 multiplayer game
08-landscape-and-design-sketch Ecosystem survey, architecture options

Architecture

This plugin follows Approach A from the design research: a compact always-loaded skill (~500 lines) for the critical patterns agents get wrong, with a references/ folder for deeper topic material. Skills are versioned by Bevy minor version (like dioxus-0.7). The bevy-upgrade skill is a companion that handles version migration specifically.

Install

/plugin marketplace add git@git.g4b.org:dirigence/reliquary.git
/plugin install bevy@reliquary

Or in .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "reliquary": {
      "source": { "source": "git", "url": "git@git.g4b.org:dirigence/reliquary.git" }
    }
  },
  "enabledPlugins": { "bevy@reliquary": true }
}