Kod gotowy na agentów (agent-ready codebase)
Repozytorium, w którym agent kodujący pracuje niezawodnie: jedna szybka komenda sprawdzająca wszystko, typy, jasne granice modułów, przykłady do skopiowania i spisane reguły.
Ten sam agent i model wykonują bardzo różną pracę w różnych repozytoriach. Pomaga głównie to, co pomaga nowemu programiście, tylko spisane: jedna komenda, która w kilka sekund uruchamia testy, typy i lint (pętla walidacji); ścisłe typy i czytelne błędy; jeden oczywisty sposób robienia typowych rzeczy z przykładem do skopiowania; małe moduły z nazwami zgodnymi z biznesem; i AGENTS.md z regułami i komendami.
Szkodzi też to, co znane: niestabilne albo wolne testy, trzy konkurujące wzorce na to samo, magiczna konfiguracja i wiedza, która żyje tylko w głowach. Przygotowanie kodu dla agentów to spłata długu technicznego z mierzalnym zwrotem w first-pass success rate i część harnessu agenta, którą zespół kontroluje.
Powiązane hasła
- Pętla walidacji (backpressure dla agenta): Komendy, które agent kodujący uruchamia po każdej zmianie (testy, typy, lint, build) i poprawia kod, aż przejdą, więc sprawdza się sam, zanim spojrzy człowiek.
- AGENTS.md i CLAUDE.md: Pliki w repozytorium z regułami, które agent kodujący czyta na początku każdej sesji.
- Harness agenta (uprząż agenta): Wszystko wokół modelu, co robi z niego agenta: pętla, narzędzia, uprawnienia, instrukcje, zapisany stan, sprawdzenia i przekazanie sesji.
- Dług techniczny: Skróty w kodzie i projekcie, które przyspieszają dostarczenie teraz, a spowalniają każdą późniejszą zmianę, dopóki ich nie spłacisz.
- First-pass success rate (skuteczność za pierwszym razem): Odsetek zadań, które agent kończy w jednym przebiegu i które przechodzą sprawdzenia i przegląd bez przepisywania przez człowieka; główna metryka pracy z agentami.
