comun/docs/README.md

COMUN\docs — index

Documentatie comuna tuturor produselor ROA. Cititorul e un agent: fiecare fisier tine regula + strictul de context care o face aplicabila + comanda de verificare. Fara "de ce", fara istoric, fara studii de caz.

Se citeste primul: reguli_lucru.md — regulile de livrare + lista de declansatoare ("cand atingi zona X, citeste fisierul Y"). Restul se deschid doar la declansator.

Cand citesti fiecare

Fisier	Cand
reguli_lucru.md	intotdeauna, la inceput de sesiune
stil_interactiune_cautare.md	cum interactionezi, cum livrezi si cum cauti (valabil si pentru subagenti)
orchestrare-subagenti.md	cand delegi, cand verifici ce intoarce un subagent, la predarea contextului
monitorizare-context.md	instalarea hook-urilor de prag de context si de revizie a docs
masini-dezvoltare-testare.md	ai nevoie de o masina separata pentru probe UI/rulari lungi care nu trebuie sa blocheze statia principala
fluxul_svn_git.md	orice commit / svn update / roa_sync -> skill roa-git-svn-commit
opencode_agenti_orchestrare.md	delegi executie/review la agenti opencode DeepSeek (server HTTP, port per proiect)
archon_capcane.md	rulezi/depanezi workflow-ul Archon roa-fix (run mort, Pi 128k, conditii when)
scripturi-uzuale.md	exista deja un script pentru sarcina asta? (roa_sync, curatenie, livrare, diagnostice)
VFP
cautare_vcx_vct.md	cauti cod in .vcx/.scx/.frx/.mnx -> skill roa-vfp-text-edit
flux-editare-vfp-text.md	editezi .vc2/.sc2 + write-back; invariantele si *p:/*m: -> skill roa-vfp-text-edit
creare-editare-rapoarte-frx.md	creezi/editezi un raport .frx/.frt sau verifici unul nou (structura DBF, band-uri, grupare, totaluri) -> skill roa-vfp-frx-report
conventie_encoding_cp1252.md	fisierul editat are diacritice (cp1250, nu cp1252) -> skill roa-vfp-text-edit
inventar-comun.md	inainte de cod nou: exista deja o functie/clasa comuna?
conventie_ux_formulare.md	adaugi/rearanjezi controale pe formular
capcana_grid_controlsource.md	grid needitabil pe formular cu 2+ grid-uri
capcana_grid_preferinte_utilizator.md	adaugi o coloana intr-un grid deja livrat
conventie_go_recno.md	GO pe un Recno() capturat -> skill roa-vfp-go-recno
conventie_null_vfp.md	garzi pe valori NULL din Oracle -> skill roa-vfp-null-guards
conventie_goexecutor_alter_table.md	ALTER TABLE pe cursorul de la oExecute()
Testare
depanare_testare_vfp.md	rulare headless, depanare bug runtime, capcane VFP -> skill roa-vfp-headless-test
testare-ui-vfp.md	test cu formular real + screenshots (harness UI) -> skill roa-vfp-headless-test
Oracle
conventie_mediu_oracle.md	te conectezi la dev/test, alegi schema, rulezi un script de pachet
conexiuni-tunel-ssh-odbc.md	ajungi la un Oracle de PRODUCTIE prin tunel SSH (Bitvise) + alias TNS + DSN ODBC -> skill roa-oracle-production-access
scripturi-migrare-db.md	modifici schema (tabele/view-uri/pachete); compatibilitate 10.2 -> skill roa-oracle-migration
publicare-scripturi-db.md	publici scripturile catre clienti -> skill roa-oracle-migration
oracle_export.md	reexporti sursa unui pachet PL/SQL -> skill roa-oracle-migration
depanare-pack-update.md	actualizarea ROA nu se finalizeaza la un client -> skill roa-oracle-diagnostic
depanare-spatiu-oracle.md	spatiu plin la un client -> skill roa-oracle-diagnostic
Domeniu
flux-modificare-stergere-nota-jurnal.md	modificare/stergere nota; ce face PACK_CONTAFIN
tipuri_documente_facturare.md	VANZARI.TIP si seturile de contare ID_SET
sold-neexigibil-reportat-jc2007-jv2007.md	interogari pe sold TVA neexigibil
view-uri-efactura.md	view-urile ANAF_VEFACTURA_* si potrivirea eFacturilor cu registrul de TVA
machete-note-xrequest-explicatii.md	schimbi ce campuri cere o operatie la introducere (XREQUEST/XITEMS/XNOTE); explicatie, explicatia4, explicatia5
incasari-plati-valuta-diferita.md	incasare/plata in alta valuta decat a facturii (seturile 10600-10603); ce se pune la valute si cursuri
email-thunderbird.md	citirea mailurilor de pe conturile romfast
http_romfast_user_agent.md	scrii/depanezi o cerere HTTP din VFP catre romfast.ro (User-Agent obligatoriu, altfel IP blocat)

onboarding\ — proceduri rulate o singura data per proiect (inrolare in fluxul git-text, prompturi de configurare) -> skill roa-onboarding pentru executie. Nu se citesc in sesiunile de lucru.

*.pck — exporturi de referinta ale pachetelor PL/SQL, pentru grep tintit; nu se citesc intregi. cercetare\ — note de cercetare pe subiecte incheiate.

Cand adaugi ceva aici

Doar reutilizabil (80/20): flux ascuns, capcana platita, procedura/tabela cheie. Cateva randuri. Un subiect are un singur proprietar — celelalte fisiere primesc o trimitere de un rand, nu o copie. Scrie ASCII, fara diacritice. Adauga si randul in tabelul de mai sus, plus declansatorul in reguli_lucru.md punctul 7 daca regula se aplica la atingerea unei zone de cod — fara declansator, regula nu e gasita la timp.