Convenciones de código GDScript y commits en Stewart

## Recurso base para todos los personajes del juego.
## Contiene los datos compartidos entre el jugador y los NPCs.
class_name Character
extends Resource

# Distancia mínima entre personajes en fila
const CHARA_DISTANCE: float = 30.0

## Estado base abstracto para la máquina de estados.
@abstract class_name BaseState extends Node

@export_group("Movimiento")
@export var move_speed: float = 120.0
@export var run_speed: float = 200.0

@export_group("Personaje")
@export var character_data: Character

@onready var animation_player: AnimationPlayer = $AnimationPlayer
@onready var state_machine: StateMachine = $StateMachine

animation_player.play(&"idle")
animation_player.play(&"run_right")

signal movement_started
signal character_reached_target(character: Character)

#region Movimiento

func move_toward_target() -> void:
    pass

func stop_movement() -> void:
    pass

#endregion

## Doc-comment de la clase.
class_name NombreDeClase
extends NodoPadre

# Constantes
const EPSILON: float = 0.001

# Señales
signal state_changed(new_state: BaseState)

# Propiedades exportadas
@export_group("Configuración")
@export var config_value: float = 1.0

# Variables privadas
var _current_state: BaseState

# Nodos
@onready var _animation_player: AnimationPlayer = $AnimationPlayer

#region Ciclo de vida

func _ready() -> void:
    pass

func _process(delta: float) -> void:
    pass

#endregion

## Mueve al personaje hacia su objetivo en la fila.
## Retorna true si el personaje llegó al destino.
func move_to_target(delta: float) -> bool:
    # Verificar si ya estamos suficientemente cerca
    if position.distance_to(target_position) < EPSILON:
        return true

    # Calcular dirección y aplicar velocidad
    var direction := position.direction_to(target_position)
    position += direction * move_speed * delta
    return false

<tipo>(<ámbito opcional>): <descripción en español>

feat(movement): agregar sistema de movimiento en fila
fix(character): corregir animaciones direccionales
docs: actualizar README con requisitos de desarrollo
chore: configurar addons y fuentes del proyecto
refactor(state-machine): simplificar transiciones de estado
art(player): agregar sprites de animación de correr