#+TITLE: Workflow — Jak hrát Alien RPG jako nevidomý hráč
#+STARTUP: overview

* Přehled systému

Tento repozitář obsahuje dva systémy:
1. *alien-rpg.el* — Elisp herní engine pro Doom Emacs (PRIMÁRNÍ)
2. *org soubory* — referenční texty palub (pro studium před hrou)

Během hry používej VÝHRADNĚ =alien-rpg.el= přes =SPC G= prefix.
Org soubory slouží jen pro klidné prostudování před hrou.

* Instalace

Přidej do =~/.doom.d/config.el=:

#+begin_src emacs-lisp
(load! "~/alienrpg/alien-rpg")
#+end_src

Po restartu Emacsu (nebo =M-x load-file RET ~/alienrpg/alien-rpg.el=)
budou dostupné všechny příkazy pod =SPC G=.

* Klávesové zkratky — SPC G (Alien RPG prefix)

** Navigace (kde jsem, kam jdu)

| Klávesa  | Příkaz              | Co udělá                                     |
|----------+---------------------+----------------------------------------------|
| =SPC G w= | Kde jsem            | Zobrazí palubu, místnost, okolí, přístupy   |
| =SPC G m= | Přesun              | Completion seznam propojených místností      |
| =SPC G t= | Teleport            | Přesun kamkoliv (když GM řekne novou pozici) |
| =SPC G f= | Najít místnost      | Info o libovolné místnosti na stanici        |
| =SPC G p= | Najít cestu         | BFS nejkratší cesta z aktuální pozice do cíle |
| =SPC G d= | Přehled paluby      | Všechny místnosti na zvolené palubě          |
| =SPC G o= | Přehled stanice     | Vertikální boční pohled (A nahoře, J dole)   |
| =SPC G k= | Klíčová místa       | Kam pro zbraně, léky, únik, počítač          |

** Postava a kostky

| Klávesa  | Příkaz              | Co udělá                                     |
|----------+---------------------+----------------------------------------------|
| =SPC G s= | Stav postavy        | Health, Stress, výbava, pozice, zranění      |
| =SPC G i= | Dovednosti          | Seřazené od nejsilnějších, s počtem kostek   |
| =SPC G r= | Hodit kostkou       | Vybere dovednost → hodí → úspěchy + panika   |

** Úprava stavu během hry

| Klávesa  | Příkaz              | Co udělá                                     |
|----------+---------------------+----------------------------------------------|
| =SPC G h= | Nastavit Health     | Zadej číslo 0–4                              |
| =SPC G S= | Nastavit Stress     | Zadej číslo 0+                               |
| =SPC G j= | Přidat zranění      | Textový popis zranění                        |
| =SPC G g= | Přidat výbavu       | Nový předmět                                 |
| =SPC G W= | Přidat zbraň        | Nová zbraň                                   |
| =SPC G b= | Nastavit Buddy      | Jméno spoluhráče                              |
| =SPC G R= | Nastavit Rival      | Jméno rivala                                 |

** Poznámky a uložení

| Klávesa  | Příkaz              | Co udělá                                     |
|----------+---------------------+----------------------------------------------|
| =SPC G n= | Přidat poznámku     | Timestampovaná poznámka                      |
| =SPC G N= | Zobrazit poznámky   | Všechny poznámky z hry                       |
| =SPC G q= | Uložit stav         | Uloží do alien-rpg-save.el                   |
| =SPC G Q= | Načíst stav         | Načte uložený stav                           |

* Před hrou — příprava

** 1. Nastudovat mentální model

Stanice je *vertikální věž* s 10 palubami (A nahoře, J dole):
- Patro 1 (A) = střecha s dalekohledem (izolovaná, jen z B)
- Patra 2–5 (B–E) = velení, medicína, věda, bydlení
- Patra 6–8 (F–H) = vězení, hangáry, průmysl (propojené průlezy)
- Patra 9–10 (I–J) = únik a reaktor

Centrální šachta prochází palubami B–J (střed každé paluby).

** 2. Nastudovat klíčové paluby

Nemusíš znát vše nazpaměť. Zaměř se na:
1. Palubu kde hra začíná (zeptej se GM)
2. Zbrojnici: =SPC G f= → "Zbrojnice" (paluba F, sever-střed)
3. Únikové cesty: =SPC G k= zobrazí vše
4. Ošetřovnu: paluba C, sever-západ

** 3. Nastudovat svou postavu

=SPC G i= (dovednosti) a =SPC G s= (stav). Tvé silné stránky:
- Ranged Combat: 7 kostek (střelba)
- Manipulation: 7 kostek (přesvědčování)
- Observation: 5 kostek + talent Analýza

** 4. Doplnit Buddy a Rivala

Před začátkem hry: =SPC G b= a =SPC G R=.

* Během hry — workflow

** Typický herní cyklus

1. GM popíše situaci
2. =SPC G w= → ověříš co víš o pozici
3. Rozhodneš se co uděláš
4. =SPC G m= → přesuneš se NEBO =SPC G r= → hodíš na dovednost
5. Když se změní Health/Stress: =SPC G h= / =SPC G S=
6. Důležitá informace? =SPC G n= → poznámka

** Když GM řekne "jsi na palubě X v místnosti Y"

1. =SPC G t= → teleport na správnou místnost
2. =SPC G w= → ověříš okolí

** Když potřebuješ utéct

1. =SPC G p= → najdi cestu do bezpečí (vybereš cíl, engine najde cestu)
2. =SPC G k= → klíčová místa (zbrojnice, hangáry, kapsle)

** Když GM řekne "hoď si na X"

1. =SPC G r= → vyber dovednost → automatický hod
2. Výsledek zobrazí úspěchy a paniku okamžitě

** Na konci sezení

=SPC G q= → uloží vše (pozice, health, stress, výbava, poznámky)

Příští sezení: =SPC G Q= → načte stav

* Principy přístupnosti

** Proč NE org soubory během hry

- Org soubory jsou *dlouhé* — hledání v nich je pomalé
- Screen reader čte celý buffer — příliš mnoho textu
- Jeden příkaz v alien-rpg.el = jedna informace. Žádné scrollování.

** Proč completion (SPC G m)

- Completion funguje s VoiceOverem
- Fuzzy search — stačí napsat "zbro" a najde "Zbrojnice"
- Zobrazí jen relevantní možnosti (propojené místnosti)

** Proč nulové nároky na GM

- Vše je v Elispu, nic se neptáš GM
- GM jen řekne "jsi v místnosti X" → ty stiskneš =SPC G t=
- Hod kostkou je tvůj — =SPC G r= → výsledek za sekundu

* Komunikace s GM — minimální

Doporučená konvence (řekni GM jednou, na začátku):
1. "Vždy řekni název paluby a místnosti, když se přesuneme."
2. "Kolik nepřátel a kde, když začne souboj."

To je vše. Zbytek řeší alien-rpg.el.