Mentionsy Mentionsy
Patoarchitekci
Patoarchitekci

Sześć plików do jednego buga? - Spec Kit pod lupą

09.10.2026 ·37 min 9 s · 5 rozdziałów

"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

5:31 · GitHub Spec Kit - narzędzie do Spec Driven Development 1

To pierwszą komendą, którą... I będziemy mówić o fullu, o pełnej instalacji. Czyli zrobiliście sobie tam specify init project, integration np. cloud. I zaczynamy pierwszym skillem, który jest, to jest Spec Kits Constitution, czyli tworzy plik konstytucji, to są zasady projektu, czyli obowiązkowe testy, biblioteki, inne takie elementy, czyli jak wygląda stos i zasady. Tak, zwane inaczej wishlistą, żeby się trochę ponabijać. Nie, ale tak poważnie mówiąc, to pamiętaj, że mieliśmy rozmowę, że ty znowu nie jesteś fanem Konstytucji. Ja uważam, że ona jest jedną z tych bardziej wartościowych, o ile tam właśnie to się nie zamieni w wishlistę, czyli chciałabym mieć duże pokrycie kodu i tak dalej, takie twarde rzeczy, które mają być przestrzegane. Wiesz co, Szymon, odeśle też jak to robimy z klientami do Powered by Potopia, bo był taki odcinek, gdzie to opowiadam.

11:17 · Krytyka i propozycje dotyczące Spec Kit 2

Bo to jest takie wypchnięcie nogą, oby było w miarę okej. To nie tak, nie ta opcja. Dobrze. Więc to jest taki tak, to znowu jest krytyk. Tam są jeszcze jakieś checklisty inne, że takie bardzo, bardzo dodatkowe elementy. Żeby to usolidaryzować, żeby było jako i szósty githubowe, żeby z tego zrobić taki trochę flow, potencjalnie na większe zrównolegle. Tak i teraz są tak, że jak popatrzymy, są wersje proste, czyli po prostu odpal spec plan implement. I to jest ten najprostszy workflow. Który w tym? Jak popatrzymy... A jeżeli mówimy o pełnym, to jest to, że odpalamy i zaczynamy od inicjalizacji tego Constitution, żeby zdefiniować, co jest w ogóle w projekcie, jak on działa.

A jeżeli mówimy o bootstrapie Brownfieldu, to że bierzemy, odpalamy ten Constitution i weźmie i sprawdź, co ja w ogóle w tym projekcie mam. Ale ja już wiem, że jak nowe rzeczy będę robił, to powinieneś tego nie robić. I tutaj elementy. Tak można byłoby to nazwać. Jakoś w Brownfielda w tym roku nie wierzę, bo on zrobi grepa po kilku rzeczach i wyciągnie ci jakieś informacje. Niekoniecznie te, które byś chciał, ogólnie rzecz biorąc. No ale niech będzie. Dobrze. Tak. I jedna rzecz od Antropica, którą bym dorzucił, takie fajne wtrącenie, z którym ja się w tym miejscu zgadzam, że te Constitution to powinny być najczęściej ClothMD, AgentsMD. Że nie oddzielny plik, tylko jest to sobie powiedzenie, ewentualnie część oddzielnych plików, ale główne reguły siedzą w głównej specyfikacji.

Pokazano wszystkie 3 dopasowania. Transkrypcja generowana automatycznie i niesprawdzana ręcznie — może zawierać błędy.