romfast/roafacturare
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9b2a895aa4b03a013588bae26f17dce2cc229a65
roafacturare/docs/handoff_skills_agenti.md
Marius Mutu 9b2a895aa4 sync SVN r18125
2026-09-16 12:20:02 +03:00

5.9 KiB
Raw Blame History

Handoff: skill-uri de agent ROA + backstop de rutare

Data: 2026-09-16. Sesiune oprita la limita de context. Acesta e fisier de stare, nu documentatie.

Ce s-a livrat (in COMUN, versionat git + SVN)

  • 9 skill-uri, cate un SKILL.md per folder (COMUN\skills\<nume>\), frontmatter doar name+description, corp auto-suficient (skill = proprietarul procedurii): roa-vfp-text-edit, roa-vfp-headless-test, roa-git-svn-commit, roa-oracle-migration, roa-oracle-diagnostic, roa-oracle-production-access, roa-vfp-null-guards, roa-vfp-go-recno, roa-oracle-sqlexec-no-data.
  • COMUN\utile\leaga_skills.ps1 - creeaza symlink-uri in %USERPROFILE%\.claude\skills\ catre COMUN\skills\<nume> (fara copiere; citit de Claude Code SI de opencode). Idempotent, -DryRun.
  • COMUN\utile\backstop_skills.txt (sursa canonica a rutarii) + COMUN\utile\scrie_backstop_skills.ps1 (-Root, -Proiecte, -DryRun; scrie AGENTS.md + bloc marcat in CLAUDE.md; garda anti-duplicare: sare fisierele care contin deja roa- fara markers).
  • COMUN\docs\reguli_lucru.md pct. 7 + COMUN\docs\README.md - ruteaza fiecare zona la skill-ul care o detine (nu la doc).
  • COMUN\docs\cercetare\rec_skills.md - decizia, inventarul, cum se adauga un skill nou.
  • AGENTS.md (radoacina ROAFACTURARE, backstop pentru opencode) + CLAUDE.md (2 rute + ancora).
  • Backstop aplicat pe 10 proiecte: ROAACNPRO, ROAAUTO, ROACONT, ROACONTRACTE, ROADEF, ROAFACTURARE, ROAGEST, ROAIMOB, ROAPRETURI, ROAREGISTRATURA (verificat idempotent).

Ce NU e terminat (de continuat)

  1. 2 fisiere de onboarding modificate, NEcomise in SVN (singura stare nefinalizata de cod):
    • COMUN\docs\onboarding\inrolare-calculator-nou.md - secțiune noua "Pasul 8 - skill-uri de agent ROA" (+22 linii; pastreaza diacriticele).
    • COMUN\docs\onboarding\inrolare-proiect-git-text.md - secțiune noua "### 8. Skill-uri de agent (backstop de rutare)" (+7 linii; ASCII).
    • Ambele: LF, fara BOM. NU au fost testate mai departe (sunt doar text).
  2. 8 proiecte au commit SVN dar mirror-ul git nu a rulat roa_sync (ROAACNPRO, ROAAUTO, ROACONT, ROACONTRACTE, ROADEF, ROAGEST, ROAIMOB, ROAPRETURI, ROAREGISTRATURA). Fisierele sunt active pe disc; git-ul lor se aliniaza la urmatorul roa_sync.bat local.
  3. Optional nefacut: skill roa-onboarding (Nivel D din plan). Nu s-a creat intentionat: vfp-ui-test NU se creeaza (e acoperit de roa-vfp-headless-test).

Stare depozite

  • SVN: COMUN r18116; ROAFACTURARE r18118; proiecte r18114/18115/18117/18119/18120/18121/18122/ 18123/18124.
  • git: COMUN 4756dc0, ROAFACTURARE 50274b8, ambele ahead=0 (push facut, main).
  • svn status COMUN = 2 x M (cele doua onboarding-uri de mai sus).
  • svn status ROAFACTURARE (in afara COMUN) = reziduri PRE-EXISTENTE, neale noastre: .claude (?), Clase\ofundal_facturare.vc2.pre_runda1.bak (?), Utile\Teste\test_catalog_articole_s1.FXP (?), docs\diff_runda3_vanzare_ui.patch (?).
  • Branch claude/skills-agenti: sters in ambele repo-uri.

Comenzi de rulare (exacte)

  • Backstop, pe proiecte: powershell -ExecutionPolicy Bypass -File D:\ROA\<PROJ>\COMUN\utile\scrie_backstop_skills.ps1 -Root D:\ROA -Proiecte ROAACNPRO,ROAAUTO,ROACONT,ROACONTRACTE,ROADEF,ROAFACTURARE,ROAGEST,ROAIMOB,ROAPRETURI,ROAREGISTRATURA (intai -DryRun). Fara -Proiecte = toate proiectele detectate (53 - NU rula asa fara acord).
  • Legare pe masina: powershell -ExecutionPolicy Bypass -File <PROJ>\COMUN\utile\leaga_skills.ps1 [-DryRun].
  • Sync: D:\ROA\ROAFACTURARE\roa_sync.bat (svn update -> git_sync -> commit "sync SVN rN" -> reconciliere; push DOAR daca tot ahead-ul e commit-uri de sync).
  • Verificare ASCII: ([IO.File]::ReadAllBytes($p) | Where-Object {$_ -gt 127}).Count -> 0.

Decizii luate (nu re-investiga)

  • Skill = proprietarul procedurii; docurile din COMUN\docs = referinta CONDITIONATA (cel mult 1 pointer per skill). Motiv: sa nu se incarce contextul de doua ori.
  • Un singur loc de rutare per host: AGENTS.md (opencode) + reguli_lucru.md pct. 7 (Claude, citit mereu) + ancora in CLAUDE.md.
  • Skill-urile traiesc in COMUN\skills, expuse prin symlink in ~/.claude/skills (fara copie). opencode citeste nativ .claude/skills (confirmat in sursa: SkillV2.load -> glob(...,{symlink:true})).
  • Sursa canonica a rutarii = COMUN\utile\backstop_skills.txt (regenerata in proiecte de script).
  • NU se foloseste plugin marketplace: opencode nu citeste cache-ul de pluginuri.
  • Declansare: automata din description in ambele host-uri; backstop-ul always-on prinde cazurile in care descrierea nu se potriveste. paths NU se foloseste (doar restrange, nu forteaza).

Interzis

  • Nu copia manual fisiere de skill in ~/.claude/skills (se pierde legatura cu sursa; doar leaga_skills.ps1).
  • Nu git commit/push/merge pe main in COMUN in afara fluxului; commit-urile de lucru pe branch claude/<subiect>, apoi svn commit + roa_sync.
  • Nu rula roa_sync pe un branch cu fisiere noi inainte de svn commit (pe branch face checkout main si scoate fisierele de pe disc).
  • Nu rescrie COMUN\docs\ din proprie initiativa (regula 11/12) - propune.
  • Nu rula scrie_backstop_skills.ps1 fara -Proiecte (atinge 53 de proiecte).

Capcane platite

  • PowerShell 5.1 New-Item -ItemType SymbolicLink cere privilegii; mklink /D merge cu Developer Mode activ (scriptul are fallback).
  • COMUN\docs sunt LF, nu CRLF; fisierele noi create (AGENTS.md, skill-uri) sunt CRLF.
  • reguli_lucru.md si CLAUDE.md au em-dash (non-ASCII) PRE-EXISTENTE - nu se "repara" din oficiu.
  • inrolare-proiect-git-text.md are 5 en-dash pre-existente (15 octeti non-ASCII); adaugarea noastra e ASCII pur.

Urmatorul pas recomandat

  1. svn commit pentru cele doua onboarding-uri + roa_sync.bat + push.
  2. roa_sync.bat in cele 8 proiecte ramase (apoi push, la alegere).
  3. (Optional) skill roa-onboarding.