Files
reliquary/plugins/bevy
g4borg c661027d19 🤖 Flesh out bevy-0.19 and bevy-upgrade skills from research
Replace scaffold placeholders with full skill content:
- bevy-0.19: ECS cheat sheet, critical traps table, architecture guide, and 7 reference files
- bevy-upgrade: version migration workflow, transition references for 0.15→0.19, and 3 per-bump reference files
2026-07-07 17:52:10 +02:00
..

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-0.19 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 }
}