docs: adauga conventia docs/ (index README + sectiune in CLAUDE.md)

Initializeaza conventia partajata ROA* pentru insight-uri de proiect: docs/README.md
listeaza doar notite structurale permanente (nu PRD-uri, spike-uri sau diff-uri de
review, care sunt legate de sarcini punctuale).

CLAUDE.md

@@ -62,3 +62,9 @@ Preferințele lui Marius pentru sesiunile pe acest proiect:
 - **Delegare**: modificările de cod de volum/rutină (aplicarea unei propuneri din `docs/propuneri_*.md`, editări pe cache-ul text + write-back, actualizări de documentație, rulări de teste) se deleagă către **subagenți Sonnet care lucrează în background** (team agents — Agent tool cu `model: sonnet`, lane-uri paralele unde e posibil), iar sesiunea principală doar orchestrează și monitorizează: împarte planul pe lane-uri, transmite constatările între agenți, verifică rezultatele (diff, teste, fidelity) și intervine direct doar la deblocări (procese agățate), decizii și verificări.
 - **Fără commit fără review**: nu da commit din proprie inițiativă pe modificări de cod — Marius vrea întâi să **vadă diff-ul**. Pentru binarele VFP (`.vcx`/`.scx`), diff-ul lizibil se face pe forma text: regenerează textul din binarul vechi (HEAD din git) cu `vcx2txt.ps1 -Source` și compară-l cu textul editat din cache (`git diff --no-index`). Commit doar după ce Marius confirmă pe diff.
 - **Arată diff-ul complet după orice modificare**: după ce agenții (proprii sau subagenți) termină o rundă de editări — inclusiv la asamblarea rezultatelor din lane-uri paralele — afișează-i lui Marius diff-ul complet (`git diff`, nu doar rezumat/`--stat`) înainte de a continua la pasul următor sau de a cere aprobare, nu doar un sumar descriptiv al schimbărilor.
+
+## Project insights (docs/)
+
+Vezi indexul din [`docs/README.md`](docs/README.md). Oferă-mi proactiv actualizarea `docs/`
+ori de câte ori descoperi un insight nou și ne-evident despre acest proiect (flux ascuns,
+capcană, convenție, procedură/pachet cheie, tabel relevant) — nu aștepta să fii întrebat.

docs/README.md

@@ -0,0 +1,16 @@
+# docs/ — insight-uri de proiect ROAAUTO
+
+Documentație tehnică concisă, minimalistă, descoperită în timp ce lucrăm la sarcini reale
+(nu documentație generică, nu ce e deja evident din cod).
+
+**Regulă**: adaugă sau actualizează o notiță aici ori de câte ori descoperi ceva nou și
+ne-evident despre structura proiectului (flux ascuns, capcană, convenție, procedură/pachet
+cheie, tabel relevant) în timpul rezolvării unei sarcini. Nu re-documenta ce oricine ar afla
+citind codul în 30 de secunde.
+
+Notițele sunt organizate pe fișiere separate, câte un subiect pe fișier (ex.
+`flux-<nume-flux>.md`, `pachet-<nume-pachet>.md`, `tabele.md`), nu un singur fișier uriaș.
+
+## Fișiere
+
+- [cautare_vcx_vct.md](cautare_vcx_vct.md) — cum se caută cod în binarele `.vcx`/`.scx` (conversie text + grep pe cache)