rpg-api-development

What problem does it solve?

This Skill provides comprehensive guidance for developing on the rpg-api codebase, ensuring all contributions adhere to established architectural patterns, development workflows, and integration standards. It helps developers avoid common pitfalls, maintain code quality, and build robust, scalable API features that seamlessly interact with the rpg-toolkit game engine.

Core Features & Use Cases

• Layered Architecture Enforcement: Clearly defines responsibilities for handlers, orchestrators, and repositories, promoting clean separation of concerns.
• Outside-In Development Workflow: Guides developers through a test-driven, contract-first approach, ensuring each layer is validated before proceeding.
• RPG-Toolkit Integration Patterns: Details how to correctly interact with the rpg-toolkit game engine, including EventBus lifecycle and character data loading.
• Use Case: A new developer needs to implement a "character attack" endpoint. This Skill walks them through the entire process, from defining the service interface and writing handler tests with mocks, to implementing the orchestrator and integrating with rpg-toolkit's combat resolution, ensuring all architectural principles are followed.

Quick Start

Explain the core principles of the rpg-api layered architecture and how to apply the 'Outside-In' development workflow for a new feature like 'casting a spell'.