From 211b7ea8a04144a4421ef3b4d345c325cf9f0f05 Mon Sep 17 00:00:00 2001 From: Marius Mutu Date: Fri, 10 Jul 2026 16:32:32 +0300 Subject: [PATCH] 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 | 6 ++++++ docs/README.md | 16 ++++++++++++++++ 2 files changed, 22 insertions(+) create mode 100644 docs/README.md diff --git a/CLAUDE.md b/CLAUDE.md index 8428322..2b8baae 100644 --- a/CLAUDE.md +++ b/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. diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..6243a1e --- /dev/null +++ b/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-.md`, `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)