← Wszystkie projekty

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.

  • zespoły dev
  • agenci AI

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

Przebieg ticketu w tillerzeSchemat od góry do dołu. Skill rozpoznaje profil projektu i bez niego się zatrzymuje. Potem start ticketu, plan, TDD, review w dwóch równoległych osiach (Standards i Spec), commit i szkic PR, werdykt confidence check w świeżej sesji. Na końcu scalenie przez agenta, jeśli profil na to pozwala, albo PR czekający na podpis człowieka. Z boku rejestr decyzji gałęzi: zapisują go plan i TDD, czytają review i werdykt.rejestr decyzji gałęzi → czytają go review i werdyktProfil projektukrok −1brak profilu = stopStartflow-start-ticketticket, gałąź, krótki planPlanflow-plan-ticketzałożenia, seamy, decyzjeTDDflow-tddczerwony → zielony, bramki repoStandardsflow-code-reviewkonwencje repoSpecflow-code-reviewticket i ustaleniaCommit i PRflow-create-pull-requestPR zawsze jako szkicWerdyktflow-confidence-checkświeża sesja, testy na SHAScala agentmerge authoritygdy profil pozwalaPodpis człowiekaready-to-signPR czeka otwarty
Przebieg interaktywny, jeden skill na krok; ostatni wiersz to zasada scalania z profilu. Przebieg bez nadzoru przechodzi te same kroki w czternastu fazach sterownika.
  1. Profil

    Skill rozpoznaje projekt po zmiennej środowiskowej, pliku .tiller-profile albo ścieżce repozytorium. Brak profilu oznacza stop, nie zgadywanie.

  2. Start

    Ticket sprawdzony (status, blokady, kryteria akceptacji), gałąź z aktualnego main, krótki plan uzgodniony przed kodem.

  3. 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.

  4. TDD

    Test najpierw pada z powodu opisanego w tickecie, potem przechodzi. Zielony oznacza przejście bramek repozytorium na konkretnym SHA, a nie samą asercję.

  5. Review

    Dwie osie równolegle, w osobnych subagentach: Standards i Spec. Każde znalezisko ma lokalizację w pliku i dostaje rozstrzygnięcie.

  6. Commit i PR

    Commit w formacie z profilu, PR zawsze jako szkic, z wynikiem testów i zrzutami ekranu, gdy zmiana dotyczy interfejsu.

  7. 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.

  1. /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
  2. /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
  3. /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
  4. /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
  5. /flow-create-commit

    • feat(books): filter the list by author
  6. /flow-create-pull-request

    • szkic PR #7 · opis: zakres, wynik testów, link do ticketu
  7. /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
Sesja na fikcyjnym projekcie bookshelf-api, od otwarcia ticketu po werdykt. To nie jest nagranie prawdziwego projektu. Kroki i ich kolejność odpowiadają opisom skilli w repozytorium tillera; nic tu nie wywołuje API.

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

  • Claude Code
  • Codex
  • Bash
  • Node.js
  • GitHub CLI

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.

Opowiedz, o czym marzysz

Zwykle odpowiadamy w ciągu jednego dnia roboczego. Wolisz e-mail? Napisz na joanna@kokot.it.