This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Sign in to like and favorite skills
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
A 2D side-scrolling action-adventure game inspired by Castlevania and Altered Beast, featuring retro pixel art graphics with a dark gothic aesthetic. The game follows Gabriel Thorne, a monster hunter with beast transformation abilities, on his quest to defeat Count Vladok.
This project uses the CoralCollective framework for AI-driven development. ALWAYS use the specialized agents through the Task tool for different aspects of game development.
# Create virtual environment (ALWAYS DO THIS FIRST) python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies (when package.json/requirements.txt exist) pip install -r requirements.txt # Python dependencies npm install # Node dependencies for web build # Game engine setup (to be determined - Phaser.js recommended for web/mobile) npm install phaser # If using Phaser.js
# Development server (once implemented) npm run dev # Start development server npm run build # Build for production npm run test # Run tests # Mobile builds (future) npm run build:ios # Build for iOS npm run build:android # Build for Android
# Access agent system python .coral/agent_runner.py list # List available agents python .coral/agent_runner.py run # Run specific agent python .coral/agent_runner.py workflow # Run workflow # Use subagent invocation in Claude @backend_developer "Create game server API" @frontend_developer "Build game UI" @ai_ml_specialist "Implement enemy AI"
src/ āāā game/ # Core game code ā āāā scenes/ # Game scenes/levels ā ā āāā MainMenu.ts ā ā āāā Level1_HauntedVillage.ts ā ā āāā Level2_ForbiddenForest.ts ā ā āāā Level3_Catacombs.ts ā ā āāā Level4_ClockTower.ts ā ā āāā Level5_CastleKeep.ts ā āāā entities/ # Game entities ā ā āāā player/ # Player character ā ā ā āāā Gabriel.ts ā ā ā āāā transformations/ ā ā āāā enemies/ # Enemy types ā ā āāā bosses/ # Boss enemies ā ā āāā npcs/ # Non-player characters ā āāā systems/ # Game systems ā ā āāā combat/ # Combat mechanics ā ā āāā transformation/# Beast transformation system ā ā āāā progression/ # RPG elements ā ā āāā inventory/ # Items and weapons ā āāā ui/ # Game UI components ā ā āāā hud/ # Heads-up display ā ā āāā menus/ # Game menus ā ā āāā dialogs/ # Dialog system ā āāā assets/ # Game assets ā āāā sprites/ # Pixel art sprites ā āāā audio/ # Music and SFX ā āāā levels/ # Level data āāā server/ # Backend API ā āāā routes/ # API endpoints ā āāā models/ # Data models ā āāā services/ # Business logic āāā mobile/ # Mobile-specific code
@project_architect "Design architecture for 2D side-scrolling game with Phaser.js, supporting web and mobile platforms with free-to-play monetization" @technical_writer_phase1 "Document game requirements from concept PDF including gameplay, levels, monetization, and technical specifications"
@backend_developer "Create Node.js API for user authentication, save games, leaderboards, and subscription management" @database_specialist "Design database schema for user profiles, game progress, purchases, and analytics"
@frontend_developer "Implement core game loop, player controls, and level structure using Phaser.js" @ai_ml_specialist "Create enemy AI behaviors, pathfinding, and boss battle patterns"
@full_stack_engineer "Implement RPG progression system with experience, skills, and inventory" @backend_developer "Create transformation system with rage meter and beast forms"
@backend_developer "Implement subscription system, IAP handling, and ad serving integration" @security_specialist "Secure payment processing and user data protection"
@performance_engineer "Optimize game performance for mobile devices" @qa_testing "Test gameplay, progression, monetization flows" @devops_deployment "Deploy to web, iOS App Store, and Google Play" @technical_writer_phase2 "Create player guides and documentation"
When invoking agents, provide this game context:
# Unit Tests - Game mechanics (combat, movement) - Transformation system - Progression calculations - Inventory management # Integration Tests - Level transitions - Save/load functionality - API integrations - Payment processing # E2E Tests - Complete gameplay flow - Tutorial completion - Boss battles - Monetization flows # Performance Tests - Frame rate on target devices - Load times - Memory usage - Battery consumption (mobile)
game.config.jslevels.jsonenemies.jsonitems.jsonsubscription.config.jsiap.config.jsads.config.js.coral/agents/.coral/INTEGRATION.md.coral/agent_runner.pyRemember: This is a passion project bringing classic gaming nostalgia to modern platforms. Focus on fun gameplay, respectful monetization, and that gothic atmosphere that made games like Castlevania legendary.