diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..1e77633
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,41 @@
+# Manual ROA
+
+Manualele de utilizare ale aplicatiilor ROA. Remote: `git@gitea.romfast.ro:romfast/manual-roa.git` (branch `main`).
+Manualele vechi (`.doc`/`.odt` + `poze*`) sunt doar arhiva; cel intretinut activ e **ROAAUTO**.
+
+## Manual ROAAUTO — 4 formate, mereu sincronizate
+
+| Fisier | Rol |
+|---|---|
+| `manual_ROAAUTO.docx` | sursa pentru PDF |
+| `manual_ROAAUTO.pdf` | generat din docx, livrat clientilor |
+| `manual_ROAAUTO.md` | acelasi continut, cu diacritice |
+| `manual_ROAAUTO.txt` | acelasi continut, fara diacritice, latime 80, separatori `=`/`-` |
+
+Orice modificare de continut se face in **toate 4**.
+
+## Versiune si istoric (obligatoriu la fiecare modificare)
+
+- Sub titlu: `v. DD.MM.YYYY` (data zilei modificarii); in docx e paragraf italic, 10pt.
+- La sfarsit, sectiunea **Istoric versiuni**, inainte de subsolul „Manual generat…”: un rand per versiune,
+  cea mai noua sus, scurt: `v. DD.MM.YYYY — ce s-a adaugat/schimbat`.
+
+## Flux de lucru
+
+1. Editeaza docx cu `python-docx`: cloneaza (`copy.deepcopy(p._p)`) un paragraf existent cu stilul dorit
+   (titlu de sectiune, rand cu run bold + run normal) si schimba doar textul — docx-ul nu foloseste stiluri
+   Word, formatarea e pe run-uri.
+2. Editeaza md si txt.
+3. Regenereaza PDF-ul:
+   `"/c/Program Files/LibreOffice/program/soffice.exe" --headless --convert-to pdf manual_ROAAUTO.docx --outdir .`
+4. Verifica vizual: `pdftoppm -f N -l N -r 60 -png manual_ROAAUTO.pdf <scratchpad>/pN`, apoi citeste imaginea.
+5. Commit + push, apoi copiaza PDF-ul in aplicatie: `cp manual_ROAAUTO.pdf /d/ROA/ROAAUTO/Help/manual_ROAAUTO.pdf`.
+
+## Capcane de mediu
+
+- Scripturile Python se scriu intr-un fisier in scratchpad si se ruleaza cu `python fisier.py`. `python - <<EOF`
+  poate esua tacut (shim pyenv), iar `python -` fara stdin blocheaza shell-ul.
+- Consola e cp1252: `print` cu diacritice da `UnicodeEncodeError`. Nu afisa textul cu diacritice sau
+  foloseste `.encode('ascii','replace')`.
+- `pdftotext` pierde diacriticele la afisare. E doar o problema de afisare, PDF-ul e corect.
+- Versiunea anterioara a PDF-ului (pentru diff la istoric) e cea din `D:\ROA\ROAAUTO\Help\` inainte de copiere.