IrredenEngine: Skill for Claude Code

ECS Prefab Creator

Prefabs are header-only files under engine/prefabs/irreden/<domain>/ (common/, update/, voxel/, render/, input/, audio/, video/, ...), compiled only when a creation includes them. File paths and conventions: engine/prefabs/CLAUDE.md §"File pattern" and §"Conventions"; naming: docs/agents/CLAUDE-BASELINE.md §Naming.

Component

engine/prefabs/irreden/<domain>/components/component_<name>.hpp, include guard COMPONENT_<NAME>_H, namespace IRComponents, struct C_<PascalName>, public members with trailing _, a default constructor plus at least one parameterised constructor:

#ifndef COMPONENT_MOVE_ORDER_H
#define COMPONENT_MOVE_ORDER_H

#include <irreden/ir_math.hpp>

using namespace IRMath;

namespace IRComponents {

struct C_MoveOrder {
    ivec3 targetCell_;

    C_MoveOrder()
        : targetCell_{0, 0, 0} {}

    C_MoveOrder(ivec3 targetCell)
        : targetCell_{targetCell} {}
};

} // namespace IRComponents

#endif /* COMPONENT_MOVE_ORDER_H */

Method tiers a component may carry: .claude/rules/cpp-ecs.md §"Component method tiers".

System

1. Add a SCREAMING_SNAKE_CASE entry to the SystemName enum in engine/system/include/irreden/system/ir_system_types.hpp under the matching comment group (Input, Update, Render).
2. engine/prefabs/irreden/<domain>/systems/system_<name>.hpp: specialise IRSystem::System<SYSTEM_NAME> with a static create() that calls createSystem<Components...>().

#ifndef SYSTEM_VELOCITY_DRAG_H
#define SYSTEM_VELOCITY_DRAG_H

#include <irreden/ir_system.hpp>
#include <irreden/update/components/component_velocity_3d.hpp>
#include <irreden/update/components/component_velocity_drag.hpp>

using namespace IRComponents;

namespace IRSystem {

template <> struct System<VELOCITY_DRAG> {
    static SystemId create() {
        return createSystem<C_Velocity3D, C_VelocityDrag>(
            "VelocityDrag",
            [](C_Velocity3D &velocity, const C_VelocityDrag &drag) {
                velocity.velocity_ *= (1.0f - drag.drag_ * IRTime::deltaTime(IRTime::UPDATE));
            }
        );
    }
};

} // namespace IRSystem

#endif /* SYSTEM_VELOCITY_DRAG_H */