diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..845ddc7
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,19 @@
+# AGENTS.md
+
+<!-- roa-skills:start -->
+Regulile complete de lucru ROA (livrare, comentarii, modificari minime, testare, delegare): `COMUN\docs\reguli_lucru.md`. Punctul 7 ruteaza fiecare zona atinsa.
+
+Backstop de rutare: cand atingi o zona de mai jos, incarca skill-ul care o detine (el are
+procedura si criteriile care blocheaza "gata"); docurile sunt doar referinta conditionata a
+skill-ului.
+
+- editezi `.vc2`/`.sc2`/`.prg` cu diacritice, cauti in `.vcx`/`.scx`, adaugi membri de clasa -> skill `roa-vfp-text-edit`
+- rulezi sau depanezi teste headless ori UI -> skill `roa-vfp-headless-test`
+- commit / `svn update` / `roa_sync` in COMUN -> skill `roa-git-svn-commit`
+- scrii sau publici scripturi de migrare Oracle, reexporti un pachet -> skill `roa-oracle-migration`
+- actualizarea ROA nu se termina sau tablespace plin -> skill `roa-oracle-diagnostic`
+- acces la un Oracle de productie (tunel SSH + TNS + DSN) -> skill `roa-oracle-production-access`
+- garzi pe valori NULL din Oracle in VFP -> skill `roa-vfp-null-guards`
+- `GO` pe un `Recno()` capturat sau primit ca parametru -> skill `roa-vfp-go-recno`
+- procedura PL/SQL cu `SELECT ... INTO` apelata din VFP (randuri pierdute tacut) -> skill `roa-oracle-sqlexec-no-data`
+<!-- roa-skills:end -->
diff --git a/CLAUDE.md b/CLAUDE.md
index 53bd9f1..2434c9f 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -183,3 +183,21 @@ Key routing rules:
 ## Project insights (docs/)
 
 `docs/` holds short, concrete notes discovered while working on real tasks — hidden flows, gotchas, key procedures/packages, relevant tables — that go beyond what this file covers. See `docs/README.md` for the index. **Proactively offer to update `docs/` whenever you uncover a non-obvious project insight while fixing a bug or investigating a flow** (don't wait to be asked), so future sessions can reuse it instead of re-investigating from scratch. Keep entries concise and factual — no restating what's obvious from reading the code.
+
+<!-- roa-skills:start -->
+Regulile complete de lucru ROA (livrare, comentarii, modificari minime, testare, delegare): `COMUN\docs\reguli_lucru.md`. Punctul 7 ruteaza fiecare zona atinsa.
+
+Backstop de rutare: cand atingi o zona de mai jos, incarca skill-ul care o detine (el are
+procedura si criteriile care blocheaza "gata"); docurile sunt doar referinta conditionata a
+skill-ului.
+
+- editezi `.vc2`/`.sc2`/`.prg` cu diacritice, cauti in `.vcx`/`.scx`, adaugi membri de clasa -> skill `roa-vfp-text-edit`
+- rulezi sau depanezi teste headless ori UI -> skill `roa-vfp-headless-test`
+- commit / `svn update` / `roa_sync` in COMUN -> skill `roa-git-svn-commit`
+- scrii sau publici scripturi de migrare Oracle, reexporti un pachet -> skill `roa-oracle-migration`
+- actualizarea ROA nu se termina sau tablespace plin -> skill `roa-oracle-diagnostic`
+- acces la un Oracle de productie (tunel SSH + TNS + DSN) -> skill `roa-oracle-production-access`
+- garzi pe valori NULL din Oracle in VFP -> skill `roa-vfp-null-guards`
+- `GO` pe un `Recno()` capturat sau primit ca parametru -> skill `roa-vfp-go-recno`
+- procedura PL/SQL cu `SELECT ... INTO` apelata din VFP (randuri pierdute tacut) -> skill `roa-oracle-sqlexec-no-data`
+<!-- roa-skills:end -->