# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview
This is a Godot 4.3 idle game project. The game uses Godot's Forward Plus rendering method and is configured for 1280x720 resolution.

## Commands

### Running the Game
- Open the project in Godot 4.3 Editor
- Press F5 or click the Play button to run the main scene
- Press F6 to run the current scene

### Development Workflow
Since this is a Godot project, most development happens through:
1. The Godot Editor for scene editing and visual work
2. External text editor/IDE for GDScript files in `scripts/`
3. Asset pipeline through `assets/` subdirectories

## Architecture

### Scene Structure
- **Main.tscn**: Root scene that instantiates all game elements
- **Player.tscn**: CharacterBody2D-based player with movement controls
- Scenes reference scripts via `res://scripts/` paths
- Scene UIDs are auto-generated by Godot (e.g., `uid://b4ncr5x8y7kmt`)

### Script Organization
- All GDScript files go in `scripts/`
- Scripts extend appropriate Godot node types (Node2D, CharacterBody2D, etc.)
- Player movement uses built-in input actions (ui_left, ui_right, ui_up, ui_down)

### Asset Organization
```
assets/
├── sprites/  # 2D graphics and textures
├── sounds/   # Audio files (music, SFX)
└── fonts/    # Font files
```

## Important Notes
- The project uses placeholder graphics (PlaceholderTexture2D) for prototyping
- Movement speed is defined as a constant in Player.gd (SPEED = 300.0)
- The `.godot/` directory is auto-generated and should never be edited manually
- Scene files (.tscn) use Godot's text format and can be edited manually if needed, but prefer using the Godot Editor