IrredenEngine: Skill for Claude Code

increase-complexity

Additive only: no existing system or entity is removed or restructured, and no line outside the addition changes. Does not create demos (create-creation), engine systems (ecs-prefab-creator), or optimise (optimize — note a frame-rate drop in the report and let the user decide). In a gitignored private creation, read its CLAUDE.md first and stop before any git operation — the creation has its own git.

1. Target

Argument (/increase-complexity shape_debug), else the creation containing the cwd (creations/demos/<name>/, creations/editors/<name>/), else one named by the branch, else ask and offer the creations/demos/ list.

2. Inventory

Read main.cpp / main_lua.cpp (system registration and initEntities()) and main.lua (systems table, entity creation). Record the registered SystemName set, the entity shapes and counts, and existing motion / animation / colour / interactivity, in one sentence.

3. Candidates

Diff engine/system/include/irreden/system/ir_system_types.hpp (grouped by its comment headers) against the registered set. For each unused candidate read engine/prefabs/irreden/<domain>/systems/system_<snake_name>.hpp for the components it requires, its create() arguments, and its visual effect.

Priority by visual impact:

1. Motion / animation — PERIODIC_IDLE, PERIODIC_IDLE_POSITION_OFFSET, AUTO_YAW_ROTATE, VELOCITY_3D, GRAVITY_3D, ANIMATION_COLOR.
2. Particles — PARTICLE_SPAWNER, SPAWN_GLOW, RENDER_STATELESS_PARTICLES_TO_TRIXEL.
3. Lighting — extra light sources, fog variation.
4. More entities — scale the count in initEntities().
5. Interactivity — HITBOX_MOUSE_TEST, SPRING_PLATFORM.

Skip systems whose prerequisites the demo lacks (MIDI_* without a MIDI device, CHUNK_RESIDENCY_* in a single-chunk demo, GPU-compute systems without the matching SSBO pipeline).

4. Propose

A numbered menu of 1–4 options, each one line with an estimated line count, plus all:

Proposals for <demo-name>:
  1. Idle bounce — register PERIODIC_IDLE + PERIODIC_IDLE_POSITION_OFFSET
     on existing shape entities; shapes bob at a sine frequency. ~6 lines.
  2. Auto-rotation — register AUTO_YAW_ROTATE on the camera. 1 line.
  all — apply all of the above.