Cum lucrez cu agenți AI
Agenții lucrează alături de mine. Dovezile decid când ceva este gata.
Îmi construiesc produsele cu agenți AI care lucrează alături de mine. Asta face construcția rapidă, dar nu o face și corectă. De aceea metoda pornește de la o întrebare la care trebuie să răspundă fiecare schimbare: ce dovadă arată că este gata?
Regulile vin din felul în care organizațiile de inginerie separă și verifică deja munca, adaptate pentru un singur om responsabil care lucrează cu agenți. Sunt scrise, impuse prin controale automate acolo unde contează și adoptate produs cu produs.
Viața unei schimbări
- intenție
Cine are nevoie de ce și de ce acum.
- context
Ce există azi, citit din sursă, și ce limitează schimbarea.
- așteptări
Ce vom observa când funcționează și ce eșecuri contează.
- specificație
Ce ar trebui să se întâmple, scris înaintea codului și ținut la zi odată cu el.
- plan
Cea mai mică bucată completă, împreună cu testele care o vor dovedi.
- cod
Întâi un test care eșuează din motivul corect, apoi implementarea.
- teste
Testele rulează exact pe versiunea candidată, iar rezultatul lor se păstrează.
- verificare
Fiecare schimbare se închide pe baza dovezilor ei. O schimbare într-o zonă sensibilă este citită și de un agent separat, care nu a scris-o.
Apoi lansarea, pe care o decid eu. Ce este live este ce raportează producția, nu ce spune codul.
Cine decide ce
- Eu
- Numesc rezultatele urmărite și stabilesc regulile. Decid ce intră live, ce se cheltuiește și tot ce ține de partea juridică sau de clienți. Citesc rezultatele pe loturi, în loc să aprob fiecare lucru în parte.
- Agentul care construiește
- Dă formă lucrului și ține în pas specificația, designul, testele și documentația. Dovedește comportamentul cu un test care eșuează întâi și consemnează exact ce a rulat și ce a returnat.
- Un verificator separat
- Un agent care nu a scris schimbarea. O citește față de criteriile de acceptare inițiale, nu față de un rezumat, și caută defecte, nu probleme de stil.
- Controalele automate
- Acolo unde un produs le-a adoptat, refuză o schimbare fără plan sau fără dovezi, refuză publicarea unei schimbări într-o zonă sensibilă fără verificarea ei și generează planurile și notele de lansare, în loc să fie scrise de mână.
Cinci cuvinte pentru „gata”
„Gata” înseamnă cinci stadii diferite, fiecare cu dovezile lui.
- implementată
Schimbarea există, iar testele ei au rulat.
- verificată
Un verificator care nu a scris-o a citit-o și nu a rămas nimic deschis.
- publicată
Este în istoricul comun, după ce a trecut de toate controalele.
- lansată
Producția raportează exact această versiune.
- acceptată
Rezultatul pentru care a fost făcută este confirmat, atunci când acest lucru face parte din scopul ei.
Un status spune la care dintre cele cinci stadii a ajuns. Un succes local nu este raportat niciodată drept livrat.
Patru practici, o singură buclă
Specificația, designul, testele și documentația sunt o singură buclă, nu patru documente. Specificația spune ce ar trebui să se întâmple; designul stabilește cum funcționează, inclusiv stările și eșecurile; un test care eșuează întâi arată că testul poate deosebi corectul de greșit; documentația este schițată devreme și urmată la final.
Când realitatea contrazice specificația, avem un defect sau o decizie explicită, niciodată un motiv să rescriem pe tăcute ce am convenit.
Dacă lucrăm împreună
- Îți arăt specificația înaintea codului.
- Schimbările din zonele sensibile sunt verificate de un agent separat înainte să fie publicate.
- Îți spun în care dintre cele cinci stadii se află fiecare lucru.
- Decid fiecare lansare în mod deliberat și citesc ce este live direct din producție.
- Schimb documentația odată cu comportamentul pe care îl descrie.
Brief-ul de proiect pune aceleași trei întrebări de la care pornește metoda.
Începe cu intenția, contextul și așteptărileMai multe despre metodă
Un singur om, mulți agenți, nicio coadă de aprobări
Agenții fac construcția rapidă, așa că așteptarea se mută la verificare. Cum preiau separarea responsabilităților din organizațiile de inginerie, în loc să aprob singur fiecare schimbare.
Cinci cuvinte pentru „gata”
Implementată, verificată, publicată, lansată, acceptată. Cinci stadii diferite, fiecare cu dovezile lui, și de ce apar surprize când le strângem într-un singur cuvânt.