Narzędzie własne, licencja MIT
Agentic dev workflow: tiller
tiller to zestaw procedur (skilli) dla agentów AI w wytwarzaniu oprogramowania. Procedury są wspólne dla wszystkich projektów, fakty projektu żyją w jego profilu, a decyzje w rejestrze, który czytają kolejne kroki.
Problem
Agent AI w repozytorium szybko pisze kod. Bez procesu wokół niego zespół dostaje jednak zmiany, których nikt nie zaplanował, testy dopisane po fakcie i review, które sprawdza styl, a nie to, czy zmiana robi to, co miała.
Braki są zwykle cztery. Brak specyfikacji, od której agent zaczyna. Brak review, które oddziela zgodność z konwencjami od zgodności z ticketem. Brak granic: czego agent nie robi sam, np. nie scala, nie wysyła wiadomości, nie dotyka cudzego PR-a. Brak pamięci decyzji, więc każda sesja zaczyna od zera, a review zgłasza uzgodnione wcześniej odstępstwa jako błędy.
Do tego instrukcje dla agentów, które rosną w jednym projekcie, wchłaniają jego fakty: zasady scalania, komendy testów, adresy środowisk. W drugim projekcie trzeba je kopiować i poprawiać, a agent może zastosować reguły jednego projektu w innym.
Rozwiązanie
tiller oddziela procedurę od faktów. Procedura to sposób, w jaki ticket jest otwierany, planowany, testowany, przeglądany i scalany. Fakty to wszystko, czym różnią się projekty: tracker, konwencja gałęzi, komendy testów, bramki CI, kto może scalić. Każdy skill, który pracuje na tickecie, zaczyna od rozpoznania profilu projektu (krok −1) i zatrzymuje się, jeśli go nie znajdzie.
Na tym szkielecie stoją kroki, które pilnują jakości. Plan sprawdza założenia ticketu w kodzie. TDD zaczyna od testu, który pada z powodu opisanego w tickecie. Review idzie w dwóch niezależnych osiach. Werdykt wydaje świeża sesja, która nie pisała kodu.
- skille flow-*: od otwarcia ticketu, planu i TDD przez review, commit i PR po werdykt, diagnozę błędów i ręczne QA; żaden nie zawiera faktów konkretnego projektu
- profil projektu: lokalny plik z faktami (tracker, gałęzie, komendy testów, bramki, zasady scalania, granice), sprawdzany skryptem przed przebiegiem bez nadzoru
- brainy: prywatne repozytoria wiedzy o projekcie z rejestrem decyzji D-nnn i pytań Q-nnn; decyzja staje się „agreed” dopiero po potwierdzeniu przez człowieka
- rejestr decyzji gałęzi: świadome odstępstwo zapisane w chwili decyzji, czytane przez review i werdykt
- review dwuosiowe: Standards (konwencje repozytorium) i Spec (ticket plus późniejsze ustalenia), raportowane obok siebie, bez łączenia w jedną ocenę
- confidence check: werdykt high-confidence albo needs-review wyliczany z warunków, w tym z dowodu, że testy przechodzą na konkretnym SHA (CI albo ponowne uruchomienie lokalnie)
- przebieg bez nadzoru: ticket w czternastu fazach z punktami kontrolnymi i limitami; decyzja, która dotyka granicy z listy inviolables, zatrzymuje przebieg i czeka na człowieka
- helm: prywatny przegląd wszystkich projektów (etap, terminy, obietnice); doradza, nigdy sam nie zaczyna pracy
- strażnik wycieku i hook dostępu: commit z nazwą projektu, osoby albo kluczem jest odrzucany, a sesja jednego projektu nie czyta profilu innego projektu ani braina, do którego nie dostała dostępu
Przebieg ticketu
Profil
Skill rozpoznaje projekt po zmiennej środowiskowej, pliku .tiller-profile albo ścieżce repozytorium. Brak profilu oznacza stop, nie zgadywanie.
Start
Ticket sprawdzony (status, blokady, kryteria akceptacji), gałąź z aktualnego main, krótki plan uzgodniony przed kodem.
Plan
Założenia ticketu sprawdzone w repozytorium, tabela seamów z poziomem testów i tym, co celowo zostaje bez testów. Decyzje trafiają do rejestru.
TDD
Test najpierw pada z powodu opisanego w tickecie, potem przechodzi. Zielony oznacza przejście bramek repozytorium na konkretnym SHA, a nie samą asercję.
Review
Dwie osie równolegle, w osobnych subagentach: Standards i Spec. Każde znalezisko ma lokalizację w pliku i dostaje rozstrzygnięcie.
Commit i PR
Commit w formacie z profilu, PR zawsze jako szkic, z wynikiem testów i zrzutami ekranu, gdy zmiana dotyczy interfejsu.
Werdykt
Confidence check w świeżej sesji: high-confidence albo needs-review. Kto scala, agent czy człowiek, określa profil.
Przykładowy przebieg
Przykład ilustracyjny
Fikcyjny mini-projekt bookshelf-api (REST API w TypeScript) i ticket SHELF-12: filtrowanie listy książek po autorze. Log pokazuje, co robi każdy skill według jego opisu w repozytorium; nazwy, liczby i wyniki są wymyślone na potrzeby przykładu.
/flow-start-ticket SHELF-12- profil: bookshelf (plik .tiller-profile w repozytorium)
- SHELF-12 · Filtrowanie książek po autorze · Backlog, bez blokad, 2 kryteria akceptacji
- gałąź SHELF-12-filter-by-author z origin/main · status: In Progress
- plan w 3 krokach uzgodniony przed kodem
/flow-plan-ticket SHELF-12- założenie potwierdzone: GET /books istnieje (src/routes/books.ts), parametru author brak
- rodzaj: code · seam: filterBooks(books, query) · unit · przypadki spisane z góry
- celowo nie testowane tu: warstwa HTTP poza jednym testem request
- decyzja (self, do zmiany): pusty ?author= zwraca całą listę → rejestr decyzji
/flow-tdd- ✗ filterBooks › filters by author, ignoring case: expected 2 books, received 5
- czerwony z powodu z ticketu, nie z błędu uruchomienia
- ✓ 6 passed · lint ok · typecheck ok
- pin: bez parametru lista się nie zmienia (zielony z założenia)
- po cofnięciu implementacji test znów pada z tego samego powodu
/flow-code-review- Standards · 1 znalezisko · src/routes/books.ts:18 · nazwa parametru niezgodna z konwencją z README
- Spec · 0 znalezisk · AC1 i AC2 pokryte, decyzja z rejestru uwzględniona
- znalezisko przyjęte i poprawione · ✓ 6 passed
/flow-create-commit- feat(books): filter the list by author
/flow-create-pull-request- szkic PR #7 · opis: zakres, wynik testów, link do ticketu
/flow-confidence-check SHELF-12- nowa sesja; na wejściu tylko ticket
- CI na head SHA: zielone
- AC1 covered · AC2 covered · 0 blocker / high / medium
- werdykt: high-confidence
- scalanie według merge authority z profilu: tutaj podpis człowieka
Wyniki i lekcje
Liczby z repozytorium tillera, bez danych o wdrożeniach. Przy każdej podano ścieżkę, z której pochodzi.
- 23 skille flow-*
skills/flow-*/SKILL.md - 1011 testów zadeklarowanych w 89 plikach testów Node
wiersze zaczynające się od test( (także z wcięciem) w *.test.mjs - 168 commitów na main od pierwszego, 12 października 2026
git rev-list --count d536250 - 14 faz przebiegu bez nadzoru, każda z punktem kontrolnym
lib/driver/phases.mjs - 6 mandatów, w których rola owner proxy może działać za właścicielkę
README.md - MIT licencja
LICENSE
Stan: 22 października 2026, gałąź main repozytorium tillera (commit d536250).
Lekcje
- Procedura osobno, fakty osobno. Skill bez faktów projektu przenosi się do kolejnego repozytorium przez napisanie profilu, a nie przez kopiowanie instrukcji. Skill ticketu, który nie rozpozna profilu, zatrzymuje się zamiast zgadywać.
- Dwie osie review, nie jedna ocena. Kod może trzymać się wszystkich konwencji i robić nie to, co trzeba, albo odwrotnie. W połączonym raporcie jedna oś przykrywa drugą, dlatego Standards i Spec idą w osobnych subagentach.
- Decyzje zapisane od razu. Odstępstwo, którego nie ma w rejestrze, review zgłasza jako błąd albo rozszerzenie zakresu. Zapisane w chwili decyzji staje się czymś, co review ocenia, a nie odkrywa.
- Zielony to pomiar. Test jest zielony, gdy bramki przeszły na konkretnym SHA; bez tego werdykt nie będzie high-confidence. Sesja, która pisała kod, nie wydaje mu werdyktu.
- Granice jako kod. Zasady scalania, bramki i lista inviolables są w profilu, a sprawdza je skrypt. Decyzja, która dotyka granicy, zatrzymuje przebieg i czeka na człowieka. Podpisu nie przejmuje żadna rola agenta.
Stack
Repozytorium
Repozytorium jest na razie prywatne; kod jest dostępny na życzenie.
Podobny problem u Ciebie?
Opowiedz o nim w kilku kliknięciach. Nie musisz mieć gotowej specyfikacji.
Zwykle odpowiadamy w ciągu jednego dnia roboczego. Wolisz e-mail? Napisz na joanna@kokot.it.