Sześć plików do jednego buga? - Spec Kit pod lupą
"Czekaj, otrzymujesz 6 plików." 🎯 Tyle kosztuje jedna poprawka buga w GitHub Spec Kit, jeśli bierzesz go dosłownie. Bierzemy na warsztat spec-driven development, czyli generowanie kodu z UML-a w nowym wydaniu: agenci AI zamiast generatorów, Markdown zamiast diagramów. Idziemy krok po kroku. Constitution: zasady projektu czy lista życzeń? Clarify to według Szymona "chomąto na człowieka w postaci speckita". Pliki tasków w repo mają wartość "okrągłe zero. Nawet może przepraszam, pomyliłem się ujemna". Łukasz dorzuca swoje: zbiór Markdownów bez hooków i skryptów to nie jest harness dla agentów. ⚠️ Potem robi się gęsto. Łukasz traktuje specyfikacje jak ADR-y i chce "wychłostać agenta za próbę zmiany czegoś w starych specyfikacjach". Szymon ripostuje o projekcie żyjącym 5 lat: "Dosłownie umrzesz od nich." Do tego spór o C4, waterfall jako spychologia i model Fable, który chciał wyciąć 70% skilli. 🤖 Czy specyfikacja jako źródło prawdy to mit, skoro na końcu i tak wygrywa kod? A teraz nie ma co się obijać! 👉 Wpadajcie na naszego Discorda: https://discord.gg/78zPcEaP22 ! 🔥Tam możecie się z nami pokłócić o przyspieszanie SQL-a, podyskutować o naiwnych nadziejach na AI albo po prostu podzielić się swoimi IT-owymi przemyśleniami. Słuchasz Patoarchitektów dzięki PROTOPII – firmie, w której Łukasz i Szymon działają na co dzień, wspierając zespoły IT na każdym etapie: od projektowania, przez wdrożenia i migracje, aż po optymalizację i zabezpieczenia. Oferujemy też mentoring i szkolenia dostosowane do potrzeb każdej firmy, niezależnie od wielkości. Sprawdź nas: 👉 protopia.tech - Nasze sociale i linki - Materiały do odcinka - Pato szkolenia 00:00:00 Intro00:02:01 Geneza i założenia Spec Driven Development oraz przegląd podejść00:06:18 GitHub Spec Kit: instalacja, konstytucja i brak hooków00:09:00 Kroki Specify i Clarify: kontekst zadania i doprecyzowanie00:10:45 Kroki Plan, Tasks i Analyze: planowanie, testy i review00:16:28 Implementacja, warianty workflow i podejście Anthropic00:19:18 Kiedy SDD ma sens: zespół, human in the loop i rozmiar zadania00:23:28 Specyfikacje a dokumentacja: ADR-y, C4, źródła prawdy i harnessy00:28:33 Czy SDD to powrót do Waterfalla i sprzątanie artefaktów00:32:51 Przyszłość specyfikacji przy coraz mądrzejszych modelach00:35:23 Podsumowanie: Spec Kit jako narzędzie do strukturyzacji myślenia00:35:38 Polecane materiały i odcinek o Open Mercato00:36:31 Zakończenie i zaproszenie do komentarzy
To jest takie jedno z ważnych. I założenie jest jeszcze inne, które miało być sensowne i to nie zawsze wychodzi, że spec opisuje co i dlaczego, a wynikiem ma być kod, czyli jak. To samo jak ADR. Albo User Store. Tak. I jedna rzecz, która jest ważna. Założenie było koniec z vibe codingiem, czyli zamiast promptu zrób mi x, masz ładny proces i artefakt tego myślenia. Tak, tylko że dobrze wiemy, że w Spec Kicie ten cały taki twardy harness, który po prostu uniemożliwia, jest opcjonalny. Więc mając sobie Spec Kita, dalej możemy sobie śmiało... I przejdźmy w takim razie bardzo płynnie, czym jest Github Spec Kit.
Uważam, dlaczego ja mam z tym problem. Okej, założenie jest dobre, bo też robimy to w bardzo podobny sposób, ale to, co robimy np. w naszym podejściu firmowym, to jest to, że generujemy skrypty i harness. I to jest bardzo ważna różnica, że np. te testy, czy pokrycie kodu, testami w niektórych miejscach, lintery, inne tego typu zabawki, Sonar Cuby, one są wymuszone w konfigu agenta. I są w jakiś sposób odpalane i przekazywane agentowi, a nie, że ja chciałbym. Ustalmy. Są dwie rzeczy generalnie. Jeden to mówisz, że byś chciał, a drugie to mówisz, że sprawdzam. Więc to jedno i drugie jest ważne. Specify... Znaczy patrz, instrukcja jest po to ważna, żeby on ze startu szedł w dobrym kierunku, a potem go tam najwyżej...
W Sadamie Cloth MT jest takim ogólnie jeszcze informacją co gdzie siedzi, pokrywają się ze sobą, zostawiłbym od zielone, ale to jest kłócenie się o nazwę, które jest ważne. Ważne na przykład przy Antropiku, jak pójdziemy sobie do tego ich podejścia, to ważne tam oni naciskają właśnie na to, żeby wykorzystywać hooki gdzie się da, Przygotować sobie setup, który będzie jakkolwiek deterministycznie odpalany i będzie pomagał weryfikować. Oczywiście, ponownie, spec Driven Development nie wyklucza, absolutnie nie wyklucza i nie jest zastępstwem dla tego, żeby mieć twarde harnessy. Po prostu. Dobrze, Łukaszu. No to teraz tak sobie pogadajmy. Kiedy to ma sens, a kiedy nie ma sensu?
Są od tego Verify'e, które też są deterministyczne, czego brakuje w Spec Kicie. Czyli zrozumienie, że Harness to jest twój lokalny CI, po prostu. I co trzeba zrobić? Następnie reviewujemy i potem jest delivery, czyli ktoś się to współpodpisał i zmerge'ował. I tam jest taka ładna rzecz, sentencja, która idealnie podsumowuje. One task, one agent session, one PR. I okej, to teraz dochodzimy do jednego rzeczy, która... Nie mówimy o subagentach tutaj, tylko że jest jedna główna sesja. Poczekaj, poczekaj, poczekaj. W takim razie, rozmiar zadania i rozmiar projektu, bo to jest problem Spec Kita. Inicjalnie jak zaczynasz robić feature'y, to jest wszystko super, bo to jest takie mniej więcej, tak jak mówisz, robisz feature po prostu, spoko.
Jestem strasznym fanem tego kroku trzeciego, który właśnie jest ten krok krytyka. To jest świetne homonto na człowieka i tu jest jego wartość. Ale te bajki, które są takie, że a, to będziemy utrzymywali teraz to i będzie wszystko fajnie i tak dalej. Nie, budujemy sobie backlog rzeczy. Sorry, nie ma to żadnego sensu. Jeszcze próbkę naszej rozmowy wewnętrznej. Tak, ja mam totalnie nie. Uważam, że to trzeba będzie jakoś zaopiekować po czasie wzrostu. O tak. Czyli usunąć. Raczej nie. Mam na to inne przemyślenia, ale jeszcze nie rzucę. Na razie patrzę w tym. Może inaczej. Ja bardzo ciepło wierzę, że patrzę na to, co dzieje się w OpenCode akurat i na dynamiczne harnessy w tej skrypcie.
Jest tak, że Fable faktycznie chciał mi ściąć w niektórych miejscach 70%, wywalić w ogóle, z tego wywalić i zaproponował w jednym miejscu, że skrypt napiszę zamiast tego, bo da się to skryptem robić. Tak jak opus, na przykład tam opusy zaczyna to spadać i widać to w ogóle pomiędzy modelami. Fajnie widać jak wypuszczam sobie subagentów, czyli pójść w subagenta Fable, opus i w tym i Sonnet i powie co usunąć. Sonnet nic nie chce usuwać. Bo on tego potrzebuje. Tak, te 5,5 teraz już tam powiedziało dość sporo, ale nadal mniej niż Fable i będzie coś takiego, Jan Tropik też o tym mówi, jak pójdziemy w jego playbook, który jest. Były wpisy, mówili, że oni sami z siebie pousuwali masę harnessów. Tak, że masę, raczej inaczej, nie harnessów, MDeków.
Oni mieszają te pojęcia, że u nich harness to jest MDeki plus te twarde. Tak, to mówią o tych miękkich, mówią o usuwaniu miękkich, nie twardych, o miękkich. I jak przeczytacie sobie tego playbooka, to tam jest właśnie informacja o tym, Żeby też przy nowych modelach sprawdzić i sprzątać to. I ona ma sens w tym razie. Ale to jest proste myk. Znowu, porównując do ludzi. Junior potrzebuje dużo pokierowania. Mit mniej. Senior jeszcze mniej. Architekt to w ogóle zostaw go w spokoju i on ci wykombinuje lepiej niż... Powinien. Powinien. To teraz powiedzmy, osoby, które mają hands-on i chcą na tym pracować, nie będą narzekały, zmienią swoje myślenie, będą wypracowywali swój workflow. Po co mówiąc? Spec Kit, spróbujcie, daje fajny sposób myślenia, ustrukturyzuje proces myślowy i proces planowania.
A czy użyjecie go do kodowania i czy już będziecie trzymali go w repo i te wszystkie inne rzeczy? To są inne rzeczy. Zupełnie inna bajka. Tak, ja też podrzucam do tego Afirma, żeby zobaczyć sobie jak to wygląda i z naszych rzeczy, które nagrywaliśmy, czyli firmowy podcast, jak i wziąłbym jedna taka rzecz na temat, mieliśmy odcinek na temat Open Marekato. Tam jest przerośnięty harness, więc nie patrzcie na to pod względem, co jest w tym repozytorium, ale wyciągnijcie wnioski od Piotrka właśnie Karwatki o tym, co mówi. Tam dla mnie też było parę rzeczy, które sobie potem z tamtej rozmowy wziąłem i zmieniłem. Jakbym miał powiedzieć jedną rzecz, którą trzeba wyciągnąć z tamtego odcinka, wrzućcie taska i zminimalizujcie konsolę.
Pokazano wszystkie 8 dopasowań. Transkrypcja generowana automatycznie i niesprawdzana ręcznie — może zawierać błędy.
Rozmowa o Spec Driven Development i jego zastosowaniu w GitHub Spec Kit.
Analiza specyfikacji i jej roli w procesie Spec Driven Development.
Opis narzędzia GitHub Spec Kit i jego zastosowania w praktyce.
Krytyka i propozycje dotyczące narzędzia Spec Kit oraz dyskusja na jego temat.
Podsumowanie dyskusji i refleksje na temat przyszłości Spec Driven Development.
Rozdziały i streszczenia generowane automatycznie. Pełna transkrypcja nie jest publikowana — wyszukaj frazę, aby zobaczyć dopasowane fragmenty.
Kliknij, aby znaleźć fragmenty, w których pada.
Intro
Geneza i założenia Spec Driven Development oraz przegląd podejść
GitHub Spec Kit: instalacja, konstytucja i brak hooków
Kroki Specify i Clarify: kontekst zadania i doprecyzowanie
Kroki Plan, Tasks i Analyze: planowanie, testy i review
Implementacja, warianty workflow i podejście Anthropic
Kiedy SDD ma sens: zespół, human in the loop i rozmiar zadania
Specyfikacje a dokumentacja: ADR-y, C4, źródła prawdy i harnessy
Czy SDD to powrót do Waterfalla i sprzątanie artefaktów
Przyszłość specyfikacji przy coraz mądrzejszych modelach
Podsumowanie: Spec Kit jako narzędzie do strukturyzacji myślenia
Polecane materiały i odcinek o Open Mercato
Zakończenie i zaproszenie do komentarzy