Problema
Să fim sinceri: nu mai vrem să citim cod. Nu vrem să verificăm tot ce fac agenții, nici să ținem minte fiecare detaliu tehnic al proiectului.
Dar dacă nimeni nu controlează agenții, ei vor transforma orice proiect într-un haos imposibil de întreținut, pe care nici omul, nici agentul nu-l va mai putea descâlci. E doar o chestiune de timp.
Ideea
HUMAN-INTENT.md este un fișier în rădăcina repository-ului tău. El poartă intenția ta: arhitectura proiectului, regulile de dezvoltare și deciziile de produs.
Nu este documentația codului. Este legea căreia codul trebuie să i se supună.
Regulile
-
Scris de tine — și doar de tine
Agenții nu editează niciodată acest fișier. Fiecare rând din el este o decizie luată de un om.
-
Instrucțiunile lui sunt lege pentru agent
Ce spune HUMAN-INTENT.md primează asupra oricărui alt lucru. Dacă codul contrazice fișierul, codul greșește.
-
Definește arhitectura, regulile și produsul
Intenție, nu rețete. Agentul cunoaște deja toate tiparele; treaba ta este să fixezi ce trebuie să fie adevărat — și de ce.
De ce funcționează
E imposibil să ții pasul cu agenții: se scrie mai mult cod decât e dispus cineva să citească. Să controlezi fiecare rând e fără speranță. Să controlezi intenția — nu.
HUMAN-INTENT.md ridică controlul cu un nivel: urmărești un singur fișier cu deciziile tale în loc de mii de rânduri de cod. Cât timp fișierul e lege, proiectul urmează intenția ta — chiar dacă nimeni nu citește codul.
Cum începi
- Creează HUMAN-INTENT.md în rădăcina repository-ului tău.
- Notează deciziile pe care le-ai luat deja: arhitectură, reguli de dezvoltare, produs.
- Spune-i agentului să citească fișierul și să-l trateze ca lege — fă referire la el din AGENTS.md sau CLAUDE.md.
- De fiecare dată când iei o decizie nouă, adaug-o în fișier. Nu lăsa niciodată un agent să scrie în el.
- Fă review acestui fișier, nu codului.