# Reguli de lucru agent (comune proiectelor ROA VFP)

1. Modificari de cod: livreaza FISIER de diff `docs\diff_runda<N>_<subiect>.patch`
   (`git diff --no-index <baseline.bak> <editat>`), nu diff in terminal.
   Write-back in binar (txt2vcx) si commit DOAR dupa aprobarea patch-ului de catre utilizator.
   Patch-urile sunt intermediare de review: NU se comit NICIODATA in git (sunt in
   .gitignore ca `docs/diff_runda*.patch`); raman doar local, pe disc.
2. Comentarii in cod: NU se pun comentarii in corpul codului (nici la functionalitati noi).
   In ANTETUL fisierului se tine o singura intrare CUMULATIVA per functionalitate, in stilul
   existent (`*!* DD.MM.YYYY` / `*!* autor` / `*!* ce face, 1-2 fraze`): la revenirea pe aceeasi
   lucrare se rescrie intrarea, nu se adauga alta. Autorul e persoana care semneaza livrarea
   (ex. `marius.mutu`) - niciodata "claude" sau alt nume de agent.
   Se descrie doar comportamentul final, fara referinte la revizii, runde, patch-uri sau la
   corectii facute pe parcurs. La rezolvari de erori NU se adauga comentarii deloc.
   Explicatiile merg in docs/ sau in mesajul de commit, nu in cod.
   Changelog (`changelog_<aplicatie>.txt`): text minimal, pe limba utilizatorului, nu tehnic,
   o fraza scurta per intrare. Cat timp lucrarea nu a ajuns la utilizatori (fara deploy),
   erorile introduse si corectate in interiorul ei NU se pomenesc - intrarea descrie
   functionalitatea asa cum ajunge la utilizator, `:nou:`/`:modificare:`; `:eroare:` ramane
   doar pentru erori care au fost in productie.
3. Modificari minime: doar ce s-a cerut; fara refactorizari sau curatenie din oficiu.
4. Testare headless (fara IDE): `vfp9.exe -A -T "<script.prg>" <param>` din PowerShell.
   Mediu, sabloane, capcane si metoda de depanare: `depanare_testare_vfp.md`.
5. Editare .vcx/.scx pe text (cache, cp1252 byte-safe, fidelity-check): `flux-editare-vfp-text.md`.
   Cautare in binare: `cautare_vcx_vct.md`.
6. Misiuni lungi (teste, investigatii, sarcini inlantuite): NU un singur subagent cu context
   acumulat — orchestrator + subagenti proaspeti per sarcina (max ~200-250k tokens/subagent),
   handoff compact pe disc: `orchestrare-subagenti.md`.
7. Conventii obligatorii, de citit cand atingi zona respectiva:
   - editezi `.vc2`/`.sc2` pe text (orice write, chiar pe o linie) -> `conventie_encoding_cp1252.md`
     (tool care nu scrie cp1252 nativ corupe TOATE diacriticele din fisier);
   - adaugi/rearanjezi controale pe formulare sau coloane in grid -> `conventie_ux_formulare.md`;
   - scrii cod cu `GO` pe un `Recno()` capturat sau primit ca parametru -> `conventie_go_recno.md`;
   - `ALTER TABLE` pe cursorul intors de `goExecutor.oExecute()` -> `conventie_goexecutor_alter_table.md`;
   - testare UI / prin MCP -> `testare-ui-vfp.md`, `testare-vfp-mcp.md`;
   - export date din Oracle -> `oracle_export.md`;
   - modifici schema Oracle (tabele/view-uri/pachete) -> `scripturi-migrare-db.md`
     (unde stau scripturile de migrare si modelele pentru scripturi noi).