# CLAUDE.md

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

## Project Overview

Accessible tabletop RPG gaming engine for the Alien RPG space station USCSS CETORHINA. Designed for blind/visually impaired players. Czech UI, English skill names. Runs as Emacs Lisp package within Doom Emacs — minibuffer completion, no file navigation.

## Architecture

**alien-rpg.el** (main engine, ~900 lines, lexical-binding):

- **Data**: `alien-rpg-rooms` (131 rooms as connection graph), `alien-rpg-decks` (10 decks A-J), `alien-rpg-character` (static), `alien-rpg-state` (mutable). Station name in `alien-rpg-station-name`.
- **Room IDs**: ASCII slugs (e.g., `B-ridici-stredisko`). Display names use Czech diacritics (`Řídící středisko`).
- **Navigation**: Graph-based. `alien-rpg-move` (adjacent), `alien-rpg-teleport` (any). `alien-rpg-find-path` uses BFS to find ALL shortest paths.
- **No dice rolling**: Player rolls physical dice. Engine tracks state only.
- **Weapons/Armor**: Structured plists — weapons: `(:name :bonus :damage :range :ammo :weight)`, armor: `(:name :rating :weight)`.
- **State**: Health, stress, injuries, conditions, weapons, armor, gear, notes. Auto-saves via `alien-rpg--autosave`.
- **Keybindings**: `SPC G` prefix (Doom Emacs). No `r` (roll removed). `a` = armor, `c` = condition.

**Reference docs** (org-mode, Czech):
- `paluby/paluba-{A..J}.org` + `paluba-GH.org` — deck descriptions
- `stanice.org` — station overview, průlezy, communication tower
- `herni_karta.org` — character card
- `workflow.org` — gameplay tutorial, keybindings

## Key Design Constraints

- **Concise output**: 3-5 lines per command. No emoji, no decorative borders. Room codes everywhere.
- **Screen reader friendly**: All interactions via minibuffer completion or short buffer output.
- **Zero dependencies**: All data embedded in Elisp. No external files at runtime.
- **Doom Emacs required**: `map!` macro, `SPC` leader.
- **PDF-verified data**: Room names and connections verified against `reference_pdf/` maps. Thick red lines on maps = doors. Centrální šachta = round room with upside-down person icon.

## Map Structure

- Decks A (top) to J (bottom), vertical station
- Central shaft: B-J (A is isolated, access from B only)
- Průlezy F↔G: F1↔G1, F2↔G2, F5↔G5, F6↔G6, F7↔G7, F8↔G8
- Průlezy G↔H: G3↔H3, G4↔H4, G7↔H7, G8↔H8, G9↔H9 (communication tower)
- G9 connects via Nouzové shromaždiště (top of G), NOT centrální šachta
- F centrální šachta is at TOP of deck F, connects to Zbrojnice via corridor

## Development

No build system, tests, or CI. Load via `(load! "~/alienrpg/alien-rpg")` in `~/.doom.d/config.el`. Internal helpers use `alien-rpg--` double-dash prefix.
