[{"data":1,"prerenderedAt":1661},["ShallowReactive",2],{"\u002Fblog\u002Fai-driven-development-workflow":3,"\u002Fblog\u002Fai-driven-development-workflow-surround":1650},{"id":4,"title":5,"author":6,"body":7,"date":1638,"description":1639,"draft":1640,"extension":1641,"image":1642,"meta":1643,"minRead":1644,"navigation":193,"path":1645,"seo":1646,"sitemap":1647,"stem":1648,"__hash__":1649},"blog\u002Fblog\u002Fai-driven-development-workflow.md","AI-Driven Development Workflow","Artur Wilczek",{"type":8,"value":9,"toc":1609},"minimark",[10,15,41,51,70,74,89,115,121,125,136,158,175,178,543,550,554,574,586,590,603,610,617,620,683,686,695,699,710,784,802,809,824,827,836,872,879,892,898,907,910,917,930,939,943,946,992,999,1079,1090,1097,1114,1123,1133,1136,1143,1150,1159,1170,1177,1191,1219,1222,1231,1254,1261,1268,1277,1280,1309,1320,1324,1331,1340,1354,1358,1368,1373,1429,1434,1442,1460,1473,1477,1480,1516,1543,1547,1553,1598,1605],[11,12,14],"h2",{"id":13},"wstęp","Wstęp",[16,17,18,22,23,32,33,40],"p",{},[19,20,21],"strong",{},"AI-Driven Development"," to podejście do wytwarzania oprogramowania, w którym duża część pracy programistycznej — od projektowania, przez implementację, po dokumentację — jest delegowana do agentów AI, a rola człowieka koncentruje się na architekturze, definiowaniu wymagań i weryfikacji wyników. W poprzednich artykułach pokazałem, jak działa to w trybie ",[19,24,25],{},[26,27,31],"a",{"href":28,"rel":29},"https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot",[30],"nofollow","GitHub Copilot"," w ",[19,34,35],{},[26,36,39],{"href":37,"rel":38},"https:\u002F\u002Fcode.visualstudio.com\u002F",[30],"VS Code"," — tym razem chcę pójść krok dalej.",[16,42,43,45,46,50],{},[19,44,5],{}," to dla mnie powtarzalny proces, w którym agenci AI nie są tylko narzędziem do pojedynczych zadań, lecz pełnią rolę wyspecjalizowanych członków zespołu. Każdy z nich odpowiada za konkretny etap cyklu życia projektu: planowanie zadań, ich realizację, aktualizację specyfikacji, dokumentację, ",[47,48,49],"em",{},"commit message-e",". Ja pełnię rolę architekta i recenzenta, agenci wykonują pracę zgodnie z wytycznymi.",[16,52,53,54,61,62,69],{},"Ten artykuł jest raportem z budowy takiego workflow przy okazji realnego projektu, w którym moim agentem był ",[19,55,56],{},[26,57,60],{"href":58,"rel":59},"https:\u002F\u002Fwww.claude.com\u002Fproduct\u002Fclaude-code",[30],"Claude Code"," od ",[19,63,64],{},[26,65,68],{"href":66,"rel":67},"https:\u002F\u002Fwww.anthropic.com\u002F",[30],"Anthropic",".",[11,71,73],{"id":72},"po-co-kolejna-aplikacja-do-pomiarów","Po co kolejna aplikacja do pomiarów?",[16,75,76,77,80,81,84,85,88],{},"Od dłuższego czasu szukałem aplikacji do regularnej rejestracji ",[19,78,79],{},"ciśnienia tętniczego",", ",[19,82,83],{},"pulsu"," i ",[19,86,87],{},"wagi",". Na rynku jest tego sporo, ale każda z aplikacji, na które trafiłem, miała przynajmniej jedną z trzech wad:",[90,91,92,103,109],"ul",{},[93,94,95,98,99,102],"li",{},[47,96,97],{},"natrętne reklamy"," albo model ",[47,100,101],{},"freemium",", w którym kluczowe funkcje są płatne,",[93,104,105,108],{},[47,106,107],{},"nadmiar funkcji"," niepotrzebnych mi do mojego celu,",[93,110,111,114],{},[47,112,113],{},"brak konkretnej funkcji",", na której mi zależało (np. odczyt wartości ze zdjęcia ekranu ciśnieniomierza).",[16,116,117,118,120],{},"Stwierdziłem, że to dobra okazja, żeby napisać własną aplikację — niedużą, dostosowaną do moich potrzeb — i jednocześnie przetestować pełny ",[19,119,5],{}," na realnym, niekomercyjnym projekcie.",[11,122,124],{"id":123},"specmd-zamiast-openspec","SPEC.md zamiast openspec",[16,126,127,128,135],{},"Początkowo planowałem oprzeć cały proces o ",[19,129,130],{},[26,131,134],{"href":132,"rel":133},"https:\u002F\u002Fgithub.com\u002FFission-AI\u002FOpenSpec",[30],"openspec"," — narzędzie, które wymusza rygorystyczne podejście do specyfikacji oraz zarządzania zmianami w projekcie. Bardzo szybko stwierdziłem jednak, że dla małej, prywatnej aplikacji jest to przerost formy nad treścią — sporo plików, sporo konwencji, sporo pracy administracyjnej, a ja chciałem skupić się na samym kodzie.",[16,137,138,139,142,143,146,147,149,150,157],{},"Decyzja była prosta: w pustym folderze tworzę pojedynczy plik ",[19,140,141],{},"SPEC.md",", w którym będę utrzymywał specyfikację projektu. Piszę ją „na kolanie”, bez idealnego formatowania, bez kompletu szczegółów — bardziej jak notatkę z głośnego myślenia. Resztę roboty zlecam ",[19,144,145],{},"Claude Chat"," (jeszcze nie ",[19,148,60],{},", czyli wersji webowej ",[19,151,152],{},[26,153,156],{"href":154,"rel":155},"https:\u002F\u002Fclaude.ai",[30],"claude.ai","):",[159,160,165],"pre",{"className":161,"code":162,"language":163,"meta":164,"style":164},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Przed uruchomienie \u002Finit chciałbym mieć dobrej jakości plik SPEC.md projektu. Mam taki napisany \"na kolanie\" i chciałbym, żebyś przekształcił go po względem formy i treści na bardzo profesjonalny. Jeśli potrzebujesz dodatkowych informacji, które powinny się znaleźć w SPEC.md, zadawaj pytania.\n","markdown","",[166,167,168],"code",{"__ignoreMap":164},[169,170,173],"span",{"class":171,"line":172},"line",1,[169,174,162],{},[16,176,177],{},"i wklejam mój wstępny SPEC.md:",[159,179,181],{"className":161,"code":180,"language":163,"meta":164,"style":164},"Aplikacja web do rejestrowania wyników pomiaru ciśnienia tętniczego krwi, pulsu oraz wagi zalogowanego użytkownika.\n\nStack technologiczny:\n\n- **SQLite** jako baza danych.\n- **Prisma ORM** jako warstwa abstrakcji pomiędzy bazą danych, a _REST API backend_, narzędzie do definiowania schematów tabel oraz zarządzania migracjami w bazie danych.\n- **Nuxt** serwer jako _REST API backend_.\n- **Nuxt** + **Nuxt UI** (wspomagany przez **Tailwind CSS**) jako frontend użytkownika (SSR: false).\n- Moduł **nuxt-auth-utils** wspomagający realizację autentykacji i autoryzacji użytkowników.\n- Biblioteka **zod** do walidacji danych na formularzach frontend oraz dannych przekazywanych do endpoint-ów REST API.\n- Biblioteki **unovis** do prezentacji danych w formie wykresów i grafów.\n\nWzorce projektowe:\n\n- **Język interfejsu i komunikatów**: polski\n- **Walidacja request body** — Zod schema w endpoincie API (`safeParse`)\n- **Komunikaty błędów** — `useAppMessages()` store → `AppMessages.vue` → `useToast()`\n- **Endpoint-y chronione** — `requireUserSession(event)`\n- **Store pattern** — Pinia setup stores (`defineStore` z composition API)\n- **Okna dialogowe (Modal\u002FSlideover)** — sterowane przez `useOverlay` (nie `v-model:open`). Dialogi potwierdzenia przez composable `useConfirmDialog` oparty na `useOverlay`\n- **If bez klamer**: jeśli po `if` występuje tylko jedno polecenie, nie używaj nawiasów `{ }` (np. `if (!x) return`)\n- **Handler-y API (server\u002Fapi\u002F)**: minimum kodu — tylko kontrola autentykacji\u002Fautoryzacji (`requireUserSession`, `checkUserHasAnyRole`) i walidacja wejścia (Zod). Cała logika biznesowa i dostęp do bazy danych należą do serwisów w `server\u002Fservices\u002F`\n\nInterfejs użytkownika:\n\n- Prosty, w układzie pionowym dla urządzeń mobilnych.\n- Wspólnych layout dla wszystkich ekranów: top nav bar z guzikiem powrotu na stronę domową, nazwa aplikacji CPW oraz hamburger menu (Mój profil, Wyloguj) oraz główna przestrzeń aplikacji.\n- Strona domowa to 3 duże guziki: Ciśnienie \u002F puls, Waga, Statystyki.\n- Strony dodatkowe:\n  - logowania uzytkownika\n  - mój profil, na której można zmienić sobie hasło.\n\nPlanowanie funkcjonalności:\n\n- Rejestrowanie wagi - po wybraniu Waga z ekranu głównego -> strona z formularzem:\n  - Pole na wagę\n  - Pole na date wykonania pomiaru, domyślnie _now_ z możliwością ręcznego ustawienia daty i czasu\n- Rejestrowanie ciśnienie i pulsu - po wybraniu Ciśnienie \u002F puls z ekranu głównego -> strona z formularzem:\n  - Pole na ciśnienie skurczowe\n  - Pole na ciśnienie rozkurczowe\n  - Pole na puls\n  - Pole na date wykonania pomiaru, domyślnie _now_ z możliwością ręcznego ustawienia daty i czasu\n  - Możliwość przekazania wartości dla pierwszych trzech pól poprzez flow:\n    - aktywacja aparatu fotograficznego z podglądem co widzi obiektyw\n    - użytkownik robi zdjęcia ekranu ciśnieniomierza, na którym widać wartości zmierzone\n    - zdjęcie przekazane na serwer, który następnie wysyła je do analizy AI, np. z pośrednictwem OpenRouter\n    - AI zwraca w formacie JSON 3 wyłuskane ze zdjęcia wartości\n- Statystyki - po wybraniu Statystyki ekranu głównego -> strona z formularzem:\n  - Formularz ustalania zakresu analizowanych danych: 7 dni, 2 tygodnie, miesiąc, kwartał, rok.\n  - Wykresy:\n    - Ciśnienie - dwie linie: skurczowe i rozkurczowe\n    - Puls\n    - Waga\n\nAutentykacja:\n\n- Oprócz strony \u002Flogin i endpoint \u002Fapi\u002Flogin, wszystkie pozostały strony i endpoint-y wymagają aktywnej sesji zalogowanego użytkownika. Jej brak kieruje na stronę \u002Flogin.\n- Aplikacja nie daje możliwości rejestracji nowego użytkownika. Administrator systemu ma do dyspozycji specjalnych skrypt _typescript_, którym może dodać nowego do aplikacji.\n\nAutoryzacja:\n\n- Użytkownik ma dostęp tylko i wyłączenie do pomiarów zarejestrowanych przez siebie.\n",[166,182,183,188,195,201,206,212,218,224,230,236,242,248,253,259,264,270,276,282,288,294,300,306,312,317,323,328,334,340,346,352,358,364,369,375,380,386,392,398,404,410,416,422,427,433,439,445,451,457,463,469,475,481,487,493,498,504,509,515,521,526,532,537],{"__ignoreMap":164},[169,184,185],{"class":171,"line":172},[169,186,187],{},"Aplikacja web do rejestrowania wyników pomiaru ciśnienia tętniczego krwi, pulsu oraz wagi zalogowanego użytkownika.\n",[169,189,191],{"class":171,"line":190},2,[169,192,194],{"emptyLinePlaceholder":193},true,"\n",[169,196,198],{"class":171,"line":197},3,[169,199,200],{},"Stack technologiczny:\n",[169,202,204],{"class":171,"line":203},4,[169,205,194],{"emptyLinePlaceholder":193},[169,207,209],{"class":171,"line":208},5,[169,210,211],{},"- **SQLite** jako baza danych.\n",[169,213,215],{"class":171,"line":214},6,[169,216,217],{},"- **Prisma ORM** jako warstwa abstrakcji pomiędzy bazą danych, a _REST API backend_, narzędzie do definiowania schematów tabel oraz zarządzania migracjami w bazie danych.\n",[169,219,221],{"class":171,"line":220},7,[169,222,223],{},"- **Nuxt** serwer jako _REST API backend_.\n",[169,225,227],{"class":171,"line":226},8,[169,228,229],{},"- **Nuxt** + **Nuxt UI** (wspomagany przez **Tailwind CSS**) jako frontend użytkownika (SSR: false).\n",[169,231,233],{"class":171,"line":232},9,[169,234,235],{},"- Moduł **nuxt-auth-utils** wspomagający realizację autentykacji i autoryzacji użytkowników.\n",[169,237,239],{"class":171,"line":238},10,[169,240,241],{},"- Biblioteka **zod** do walidacji danych na formularzach frontend oraz dannych przekazywanych do endpoint-ów REST API.\n",[169,243,245],{"class":171,"line":244},11,[169,246,247],{},"- Biblioteki **unovis** do prezentacji danych w formie wykresów i grafów.\n",[169,249,251],{"class":171,"line":250},12,[169,252,194],{"emptyLinePlaceholder":193},[169,254,256],{"class":171,"line":255},13,[169,257,258],{},"Wzorce projektowe:\n",[169,260,262],{"class":171,"line":261},14,[169,263,194],{"emptyLinePlaceholder":193},[169,265,267],{"class":171,"line":266},15,[169,268,269],{},"- **Język interfejsu i komunikatów**: polski\n",[169,271,273],{"class":171,"line":272},16,[169,274,275],{},"- **Walidacja request body** — Zod schema w endpoincie API (`safeParse`)\n",[169,277,279],{"class":171,"line":278},17,[169,280,281],{},"- **Komunikaty błędów** — `useAppMessages()` store → `AppMessages.vue` → `useToast()`\n",[169,283,285],{"class":171,"line":284},18,[169,286,287],{},"- **Endpoint-y chronione** — `requireUserSession(event)`\n",[169,289,291],{"class":171,"line":290},19,[169,292,293],{},"- **Store pattern** — Pinia setup stores (`defineStore` z composition API)\n",[169,295,297],{"class":171,"line":296},20,[169,298,299],{},"- **Okna dialogowe (Modal\u002FSlideover)** — sterowane przez `useOverlay` (nie `v-model:open`). Dialogi potwierdzenia przez composable `useConfirmDialog` oparty na `useOverlay`\n",[169,301,303],{"class":171,"line":302},21,[169,304,305],{},"- **If bez klamer**: jeśli po `if` występuje tylko jedno polecenie, nie używaj nawiasów `{ }` (np. `if (!x) return`)\n",[169,307,309],{"class":171,"line":308},22,[169,310,311],{},"- **Handler-y API (server\u002Fapi\u002F)**: minimum kodu — tylko kontrola autentykacji\u002Fautoryzacji (`requireUserSession`, `checkUserHasAnyRole`) i walidacja wejścia (Zod). Cała logika biznesowa i dostęp do bazy danych należą do serwisów w `server\u002Fservices\u002F`\n",[169,313,315],{"class":171,"line":314},23,[169,316,194],{"emptyLinePlaceholder":193},[169,318,320],{"class":171,"line":319},24,[169,321,322],{},"Interfejs użytkownika:\n",[169,324,326],{"class":171,"line":325},25,[169,327,194],{"emptyLinePlaceholder":193},[169,329,331],{"class":171,"line":330},26,[169,332,333],{},"- Prosty, w układzie pionowym dla urządzeń mobilnych.\n",[169,335,337],{"class":171,"line":336},27,[169,338,339],{},"- Wspólnych layout dla wszystkich ekranów: top nav bar z guzikiem powrotu na stronę domową, nazwa aplikacji CPW oraz hamburger menu (Mój profil, Wyloguj) oraz główna przestrzeń aplikacji.\n",[169,341,343],{"class":171,"line":342},28,[169,344,345],{},"- Strona domowa to 3 duże guziki: Ciśnienie \u002F puls, Waga, Statystyki.\n",[169,347,349],{"class":171,"line":348},29,[169,350,351],{},"- Strony dodatkowe:\n",[169,353,355],{"class":171,"line":354},30,[169,356,357],{},"  - logowania uzytkownika\n",[169,359,361],{"class":171,"line":360},31,[169,362,363],{},"  - mój profil, na której można zmienić sobie hasło.\n",[169,365,367],{"class":171,"line":366},32,[169,368,194],{"emptyLinePlaceholder":193},[169,370,372],{"class":171,"line":371},33,[169,373,374],{},"Planowanie funkcjonalności:\n",[169,376,378],{"class":171,"line":377},34,[169,379,194],{"emptyLinePlaceholder":193},[169,381,383],{"class":171,"line":382},35,[169,384,385],{},"- Rejestrowanie wagi - po wybraniu Waga z ekranu głównego -> strona z formularzem:\n",[169,387,389],{"class":171,"line":388},36,[169,390,391],{},"  - Pole na wagę\n",[169,393,395],{"class":171,"line":394},37,[169,396,397],{},"  - Pole na date wykonania pomiaru, domyślnie _now_ z możliwością ręcznego ustawienia daty i czasu\n",[169,399,401],{"class":171,"line":400},38,[169,402,403],{},"- Rejestrowanie ciśnienie i pulsu - po wybraniu Ciśnienie \u002F puls z ekranu głównego -> strona z formularzem:\n",[169,405,407],{"class":171,"line":406},39,[169,408,409],{},"  - Pole na ciśnienie skurczowe\n",[169,411,413],{"class":171,"line":412},40,[169,414,415],{},"  - Pole na ciśnienie rozkurczowe\n",[169,417,419],{"class":171,"line":418},41,[169,420,421],{},"  - Pole na puls\n",[169,423,425],{"class":171,"line":424},42,[169,426,397],{},[169,428,430],{"class":171,"line":429},43,[169,431,432],{},"  - Możliwość przekazania wartości dla pierwszych trzech pól poprzez flow:\n",[169,434,436],{"class":171,"line":435},44,[169,437,438],{},"    - aktywacja aparatu fotograficznego z podglądem co widzi obiektyw\n",[169,440,442],{"class":171,"line":441},45,[169,443,444],{},"    - użytkownik robi zdjęcia ekranu ciśnieniomierza, na którym widać wartości zmierzone\n",[169,446,448],{"class":171,"line":447},46,[169,449,450],{},"    - zdjęcie przekazane na serwer, który następnie wysyła je do analizy AI, np. z pośrednictwem OpenRouter\n",[169,452,454],{"class":171,"line":453},47,[169,455,456],{},"    - AI zwraca w formacie JSON 3 wyłuskane ze zdjęcia wartości\n",[169,458,460],{"class":171,"line":459},48,[169,461,462],{},"- Statystyki - po wybraniu Statystyki ekranu głównego -> strona z formularzem:\n",[169,464,466],{"class":171,"line":465},49,[169,467,468],{},"  - Formularz ustalania zakresu analizowanych danych: 7 dni, 2 tygodnie, miesiąc, kwartał, rok.\n",[169,470,472],{"class":171,"line":471},50,[169,473,474],{},"  - Wykresy:\n",[169,476,478],{"class":171,"line":477},51,[169,479,480],{},"    - Ciśnienie - dwie linie: skurczowe i rozkurczowe\n",[169,482,484],{"class":171,"line":483},52,[169,485,486],{},"    - Puls\n",[169,488,490],{"class":171,"line":489},53,[169,491,492],{},"    - Waga\n",[169,494,496],{"class":171,"line":495},54,[169,497,194],{"emptyLinePlaceholder":193},[169,499,501],{"class":171,"line":500},55,[169,502,503],{},"Autentykacja:\n",[169,505,507],{"class":171,"line":506},56,[169,508,194],{"emptyLinePlaceholder":193},[169,510,512],{"class":171,"line":511},57,[169,513,514],{},"- Oprócz strony \u002Flogin i endpoint \u002Fapi\u002Flogin, wszystkie pozostały strony i endpoint-y wymagają aktywnej sesji zalogowanego użytkownika. Jej brak kieruje na stronę \u002Flogin.\n",[169,516,518],{"class":171,"line":517},58,[169,519,520],{},"- Aplikacja nie daje możliwości rejestracji nowego użytkownika. Administrator systemu ma do dyspozycji specjalnych skrypt _typescript_, którym może dodać nowego do aplikacji.\n",[169,522,524],{"class":171,"line":523},59,[169,525,194],{"emptyLinePlaceholder":193},[169,527,529],{"class":171,"line":528},60,[169,530,531],{},"Autoryzacja:\n",[169,533,535],{"class":171,"line":534},61,[169,536,194],{"emptyLinePlaceholder":193},[169,538,540],{"class":171,"line":539},62,[169,541,542],{},"- Użytkownik ma dostęp tylko i wyłączenie do pomiarów zarejestrowanych przez siebie.\n",[16,544,545,546,549],{},"Chat zadał mi ",[19,547,548],{},"11 pytań"," doprecyzowujących (m.in. o politykę haseł, format dat, jednostki, obsługę stref czasowych, sposób przechowywania zdjęć), a następnie przygotował naprawdę porządną specyfikację — uporządkowaną logicznie, z rozdziałami, jednolitym formatowaniem i kompletem informacji, na których mógł oprzeć się dalszy proces.",[11,551,553],{"id":552},"claude-code-init-i-claudemd","Claude Code, \u002Finit i CLAUDE.md",[16,555,556,557,559,560,562,563,566,567,569,570,573],{},"Mając gotowy plik ",[19,558,141],{},", do gry wchodzi ",[19,561,60],{}," — wersja agenta uruchamiana lokalnie z konsoli, w katalogu projektu. Pierwsze polecenie to wbudowany ",[166,564,565],{},"\u002Finit",", który analizuje zawartość katalogu (a w moim przypadku — istniejący już ",[19,568,141],{},") i generuje plik ",[19,571,572],{},"CLAUDE.md"," z instrukcjami dla samego siebie.",[16,575,576,578,579,581,582,585],{},[19,577,572],{}," jest tym, co odróżnia ",[19,580,60],{}," od „zwykłego” asystenta — plik ten automatycznie ląduje w kontekście ",[19,583,584],{},"każdej"," sesji w tym katalogu. To jest projektowa pamięć agenta: wzorce, konwencje, polecenia npm, struktura folderów, ograniczenia. Każde nowe uruchomienie zaczyna się od tej samej, spójnej wiedzy o projekcie.",[11,587,589],{"id":588},"skill-e-claude-code","SKILL-e Claude Code",[16,591,592,593,595,596,599,600,69],{},"Drugim mechanizmem, który zdecydował o całym workflow, są ",[19,594,589],{}," — wyspecjalizowane „role” agenta, każda z własnym opisem, parametrami i instrukcjami postępowania. Tworzy się je jako pliki w katalogu ",[166,597,598],{},".claude\u002Fskills\u002F\u003Cnazwa-skilla>\u002FSKILL.md"," i wywołuje z poziomu CLI poprzez polecenia ",[166,601,602],{},"\u002F\u003Cnazwa-skilla>",[16,604,605,606,609],{},"Samodzielne pisanie dobrych SKILL-i jest trudne — wymaga znajomości konwencji i sporej dyscypliny. Sztuka jest jednak prostsza, niż się wydaje: opisuję agentowi co chcę osiągnąć i to ",[19,607,608],{},"on"," przygotowuje mi gotowego SKILL-a. Każdy kolejny w tym artykule powstał właśnie w ten sposób.",[11,611,613,614],{"id":612},"skill-1-planista-zadań-update-tasks-list","SKILL #1: planista zadań — ",[166,615,616],{},"update-tasks-list",[16,618,619],{},"Pierwsza decyzja dotycząca workflow: potrzebuję wyspecjalizowanego planisty, który na podstawie specyfikacji rozpisze listę zadań do realizacji. Proszę agenta o przygotowanie pierwszego SKILL-a:",[159,621,623],{"className":161,"code":622,"language":163,"meta":164,"style":164},"Przygotuj SKILL-a o nazwie **update-tasks-list**, który przejrzy specyfikację w `.\u002FSPEC.md` i `.\u002FCLAUDE.md` i w pliku `.\u002FTASKS.md` dopisze zadania, które nie były jeszcze realizowane (wynikają z nowo dodanej specyfikacji).\nLista zadań to tabela MD z kolumnami:\n\n- Numer zadania w formacie NNNN, np. 0001, 0204, w formie linku do pliku `NNNN.md`\n- Status - wartości Planowane, Zrealizowane\n- Tytuł - ogólny, skrócony opis zadania\n\nSKILL musi logicznie układać zadania, czyli zawsze na początku musi być praca w bazie danych, modelach danych, potem REST API, a na końcu frontend.\nJedno zadanie może być przekrojowe przez warstwy aplikacji i raczej nie rozbijamy się na bardzo małe zadania, tylko zadania realizujące konkretne funkcjonalności aplikacji, np: zarządzanie użytkownikami, które będzie realizowało utworzenie tabeli, modeli danych, DTOs, endpoint-ów.\nLogiczny plan realizacji każdego zadania musi znaleźć się osobnym pliku o nazwie `NNNN.md` w folderze `.\u002F_TASKS\u002F`.\nJeśli SKILL pierwszy raz uruchomiony, musi utworzyć plik `.\u002FTASKS.md` oraz folder `.\u002F_TASKS\u002F` z wszystkimi zadaniami, które wymagają realizacji w ramach specyfikacji.\nPrzy kolejnych uruchomieniach, dodaje nowe zadania, które wynikają z dodanej specyfikacji.\n",[166,624,625,630,635,639,644,649,654,658,663,668,673,678],{"__ignoreMap":164},[169,626,627],{"class":171,"line":172},[169,628,629],{},"Przygotuj SKILL-a o nazwie **update-tasks-list**, który przejrzy specyfikację w `.\u002FSPEC.md` i `.\u002FCLAUDE.md` i w pliku `.\u002FTASKS.md` dopisze zadania, które nie były jeszcze realizowane (wynikają z nowo dodanej specyfikacji).\n",[169,631,632],{"class":171,"line":190},[169,633,634],{},"Lista zadań to tabela MD z kolumnami:\n",[169,636,637],{"class":171,"line":197},[169,638,194],{"emptyLinePlaceholder":193},[169,640,641],{"class":171,"line":203},[169,642,643],{},"- Numer zadania w formacie NNNN, np. 0001, 0204, w formie linku do pliku `NNNN.md`\n",[169,645,646],{"class":171,"line":208},[169,647,648],{},"- Status - wartości Planowane, Zrealizowane\n",[169,650,651],{"class":171,"line":214},[169,652,653],{},"- Tytuł - ogólny, skrócony opis zadania\n",[169,655,656],{"class":171,"line":220},[169,657,194],{"emptyLinePlaceholder":193},[169,659,660],{"class":171,"line":226},[169,661,662],{},"SKILL musi logicznie układać zadania, czyli zawsze na początku musi być praca w bazie danych, modelach danych, potem REST API, a na końcu frontend.\n",[169,664,665],{"class":171,"line":232},[169,666,667],{},"Jedno zadanie może być przekrojowe przez warstwy aplikacji i raczej nie rozbijamy się na bardzo małe zadania, tylko zadania realizujące konkretne funkcjonalności aplikacji, np: zarządzanie użytkownikami, które będzie realizowało utworzenie tabeli, modeli danych, DTOs, endpoint-ów.\n",[169,669,670],{"class":171,"line":238},[169,671,672],{},"Logiczny plan realizacji każdego zadania musi znaleźć się osobnym pliku o nazwie `NNNN.md` w folderze `.\u002F_TASKS\u002F`.\n",[169,674,675],{"class":171,"line":244},[169,676,677],{},"Jeśli SKILL pierwszy raz uruchomiony, musi utworzyć plik `.\u002FTASKS.md` oraz folder `.\u002F_TASKS\u002F` z wszystkimi zadaniami, które wymagają realizacji w ramach specyfikacji.\n",[169,679,680],{"class":171,"line":250},[169,681,682],{},"Przy kolejnych uruchomieniach, dodaje nowe zadania, które wynikają z dodanej specyfikacji.\n",[16,684,685],{},"Agent przygotował kompletny plik SKILL-a wraz z opisem, parametrami i procedurą.",[687,688,689],"note",{},[16,690,691,692,69],{},"Na końcu artykułu udostępniam link do pobrania wszystkich SKILL-i użytych w tym projekcie — ",[19,693,694],{},"bezpłatnie!",[11,696,698],{"id":697},"pierwsze-uruchomienie-planisty","Pierwsze uruchomienie planisty",[16,700,701,702,705,706,709],{},"Wywołuję ",[166,703,704],{},"\u002Fupdate-tasks-list"," i otrzymuję plik ",[19,707,708],{},"TASKS.md"," z listą zadań ułożonych logicznie od bazy danych, przez API, po frontend:",[159,711,713],{"className":161,"code":712,"language":163,"meta":164,"style":164},"# Zadania projektu CPW\n\n| Nr                       | Status       | Tytuł                                               |\n| ------------------------ | ------------ | --------------------------------------------------- |\n| [0001](.\u002F_TASKS\u002F0001.md) | Zrealizowane | Inicjalizacja projektu i konfiguracja               |\n| [0002](.\u002F_TASKS\u002F0002.md) | Zrealizowane | Model danych i migracje bazy danych                 |\n| [0003](.\u002F_TASKS\u002F0003.md) | Zrealizowane | Skrypt CLI dodawania użytkowników                   |\n| [0004](.\u002F_TASKS\u002F0004.md) | Zrealizowane | Autentykacja i autoryzacja                          |\n| [0005](.\u002F_TASKS\u002F0005.md) | Zrealizowane | Wspólny layout, nawigacja i infrastruktura frontend |\n| [0006](.\u002F_TASKS\u002F0006.md) | Zrealizowane | Pomiary ciśnienia i pulsu                           |\n| [0007](.\u002F_TASKS\u002F0007.md) | Zrealizowane | Pomiary wagi                                        |\n| [0008](.\u002F_TASKS\u002F0008.md) | Zrealizowane | Statystyki i wykresy                                |\n| [0009](.\u002F_TASKS\u002F0009.md) | Zrealizowane | Profil użytkownika — zmiana hasła                   |\n| [0010](.\u002F_TASKS\u002F0010.md) | Zrealizowane | Analiza zdjęcia ciśnieniomierza przez AI            |\n",[166,714,715,720,724,729,734,739,744,749,754,759,764,769,774,779],{"__ignoreMap":164},[169,716,717],{"class":171,"line":172},[169,718,719],{},"# Zadania projektu CPW\n",[169,721,722],{"class":171,"line":190},[169,723,194],{"emptyLinePlaceholder":193},[169,725,726],{"class":171,"line":197},[169,727,728],{},"| Nr                       | Status       | Tytuł                                               |\n",[169,730,731],{"class":171,"line":203},[169,732,733],{},"| ------------------------ | ------------ | --------------------------------------------------- |\n",[169,735,736],{"class":171,"line":208},[169,737,738],{},"| [0001](.\u002F_TASKS\u002F0001.md) | Zrealizowane | Inicjalizacja projektu i konfiguracja               |\n",[169,740,741],{"class":171,"line":214},[169,742,743],{},"| [0002](.\u002F_TASKS\u002F0002.md) | Zrealizowane | Model danych i migracje bazy danych                 |\n",[169,745,746],{"class":171,"line":220},[169,747,748],{},"| [0003](.\u002F_TASKS\u002F0003.md) | Zrealizowane | Skrypt CLI dodawania użytkowników                   |\n",[169,750,751],{"class":171,"line":226},[169,752,753],{},"| [0004](.\u002F_TASKS\u002F0004.md) | Zrealizowane | Autentykacja i autoryzacja                          |\n",[169,755,756],{"class":171,"line":232},[169,757,758],{},"| [0005](.\u002F_TASKS\u002F0005.md) | Zrealizowane | Wspólny layout, nawigacja i infrastruktura frontend |\n",[169,760,761],{"class":171,"line":238},[169,762,763],{},"| [0006](.\u002F_TASKS\u002F0006.md) | Zrealizowane | Pomiary ciśnienia i pulsu                           |\n",[169,765,766],{"class":171,"line":244},[169,767,768],{},"| [0007](.\u002F_TASKS\u002F0007.md) | Zrealizowane | Pomiary wagi                                        |\n",[169,770,771],{"class":171,"line":250},[169,772,773],{},"| [0008](.\u002F_TASKS\u002F0008.md) | Zrealizowane | Statystyki i wykresy                                |\n",[169,775,776],{"class":171,"line":255},[169,777,778],{},"| [0009](.\u002F_TASKS\u002F0009.md) | Zrealizowane | Profil użytkownika — zmiana hasła                   |\n",[169,780,781],{"class":171,"line":261},[169,782,783],{},"| [0010](.\u002F_TASKS\u002F0010.md) | Zrealizowane | Analiza zdjęcia ciśnieniomierza przez AI            |\n",[16,785,786,787,790,791,794,795,798,799,69],{},"Równocześnie powstał folder ",[166,788,789],{},"_TASKS\u002F"," z dziesięcioma plikami ",[166,792,793],{},"NNNN.md",", w których agent rozpisał szczegółowe kroki realizacji każdego z zadań — od migracji ",[19,796,797],{},"Prisma",", przez DTO, po komponenty ",[19,800,801],{},"Vue",[11,803,805,806],{"id":804},"skill-2-wykonawca-do-task","SKILL #2: wykonawca — ",[166,807,808],{},"do-task",[16,810,811,812,815,816,819,820,823],{},"Mogłem teraz puścić agenta luzem i poprosić go o realizację ",[19,813,814],{},"wszystkich"," zadań naraz. Wolę jednak inne podejście: zadanie po zadaniu, weryfikacja przez ",[166,817,818],{},"git diff",", świadomy ",[166,821,822],{},"git commit",", dopiero potem kolejne. Po pierwsze — zachowuję kontrolę nad jakością. Po drugie — historia commit-ów ma sens i da się ją po latach czytać.",[16,825,826],{},"Zlecam agentowi przygotowanie kolejnego SKILL-a:",[159,828,830],{"className":161,"code":829,"language":163,"meta":164,"style":164},"Przygotuj SKILL-a o nazwie **do-task**, który zrealizuje zadania o podany numerze. Numer podajemy jako parametr wywołania SKILL-a. Po zakończeniu realizacji zadania zmiana status zadania w pliku `.\u002FTASKS.md`.\n",[166,831,832],{"__ignoreMap":164},[169,833,834],{"class":171,"line":172},[169,835,829],{},[16,837,838,839,842,843,846,847,80,850,80,853,80,856,859,860,84,862,864,865,868,869,871],{},"Uruchamiam pierwsze prace poleceniem ",[166,840,841],{},"\u002Fdo-task 1"," i czekam, aż agent przygotuje strukturę projektu. Po kilku minutach mam zainicjowany projekt ",[19,844,845],{},"Nuxt"," ze skonfigurowanym ",[19,848,849],{},"TypeScript",[19,851,852],{},"ESLint",[19,854,855],{},"Prettier",[19,857,858],{},"Vitest",". Po ",[166,861,818],{},[166,863,822],{}," przechodzę do ",[166,866,867],{},"\u002Fdo-task 2"," — modele bazy danych, schemat ",[19,870,797],{},", pierwsza migracja. I tak dalej.",[11,873,875,876],{"id":874},"skill-3-korygujący-update-task","SKILL #3: korygujący — ",[166,877,878],{},"update-task",[16,880,881,882,885,886,888,889,69],{},"Po pierwszych implementacjach szybko okazało się, że niezależnie od jakości wyjściowej, zawsze coś trzeba poprawić — kosmetycznie, koncepcyjnie lub funkcjonalnie. Można poprawki zlecać agentowi w tej samej sesji (dopóki nie wyczyścimy kontekstu poleceniem ",[166,883,884],{},"\u002Fclear","), ale wtedy ślad po decyzji znika — plik ",[166,887,793],{}," z opisem zadania pozostaje nieaktualny, a zmiany są tylko w kodzie i ",[166,890,891],{},"git log",[16,893,894,895,897],{},"Potrzebny był osobny SKILL, który zaktualizuje plik zadania w folderze ",[166,896,789],{},", a następnie od razu przeprowadzi zmianę w kodzie:",[159,899,901],{"className":161,"code":900,"language":163,"meta":164,"style":164},"Przygotuj SKILL-a o nazwie **update-task**, który przyjmuje dwa parametry: nr zadania oraz nowe wymagania związane z zadaniem (nowa funkcja, rozbudowa, poprawka). SKILL aktualizuje plik `NNNN.md` w folderze `.\u002F_TASKS\u002F` zgodnie z podanymi oczekiwaniami i od razu przystępuje do realizacji w kodzie, jeśli jest taka potrzeba.\n",[166,902,903],{"__ignoreMap":164},[169,904,905],{"class":171,"line":172},[169,906,900],{},[16,908,909],{},"Od tego momentu każda poprawka jest udokumentowana w pliku zadania — opis aktualnego stanu wymagania i opis zmiany żyją razem z kodem.",[11,911,913,914],{"id":912},"skill-4-aktualizacja-specyfikacji-update-spec","SKILL #4: aktualizacja specyfikacji — ",[166,915,916],{},"update-spec",[16,918,919,920,923,924,926,927,929],{},"Po realizacji pierwszych dziesięciu zadań, w trakcie codziennego korzystania z aplikacji, zaczęły pojawiać się pomysły na nowe funkcje i usprawnienia. Każdy taki pomysł powinien najpierw trafić do ",[19,921,922],{},"specyfikacji"," (czyli plików ",[19,925,141],{}," i ewentualnie ",[19,928,572],{},"), a dopiero potem wpływać na listę zadań. Robienie tego ręcznie mijałoby się z celem całego workflow — zlecam agentowi czwartego SKILL-a:",[159,931,933],{"className":161,"code":932,"language":163,"meta":164,"style":164},"Przygotuj SKILL-a o nazwie **update-spec**, który przyjmuje jeden parametr - opis planowanej zmiany koncepcyjnej, nowej funkcjonalności, nowego procesu, który ma być obsługiwany przez aplikację. SKILL aktualizuje plik `.\u002FSPEC.md` i jeśli jest taka potrzeba pliki `.\u002FCLAUDE.md`.\n",[166,934,935],{"__ignoreMap":164},[169,936,937],{"class":171,"line":172},[169,938,932],{},[11,940,942],{"id":941},"pętla-rozwojowa","Pętla rozwojowa",[16,944,945],{},"W tym momencie mam już komplet ról potrzebnych do utrzymania projektu i wpadam w wyraźnie powtarzalną pętlę:",[90,947,948,957,965,973,981],{},[93,949,950,953,954],{},[47,951,952],{},"nowy pomysł \u002F funkcja"," → aktualizacja specyfikacji: ",[166,955,956],{},"\u002Fupdate-spec",[93,958,959,962,963],{},[47,960,961],{},"nowe zadania wynikające ze specyfikacji"," → ",[166,964,704],{},[93,966,967,962,970],{},[47,968,969],{},"realizacja zadań",[166,971,972],{},"\u002Fdo-task \u003Cnr>",[93,974,975,962,978],{},[47,976,977],{},"ewentualne poprawki",[166,979,980],{},"\u002Fupdate-task \u003Cnr> \u003Copis zmiany>",[93,982,983,962,986,988,989],{},[47,984,985],{},"zatwierdzenie",[166,987,822],{}," + ",[166,990,991],{},"git push",[16,993,994,995,998],{},"W ten sposób dołożyłem do projektu dodatkowych ",[19,996,997],{},"13 zadań",", które przeszły przez tę samą ścieżkę co pierwsza dziesiątka:",[159,1000,1002],{"className":161,"code":1001,"language":163,"meta":164,"style":164},"| Nr                       | Status       | Tytuł                                                 |\n| ------------------------ | ------------ | ----------------------------------------------------- |\n| [0011](.\u002F_TASKS\u002F0011.md) | Zrealizowane | Ikony aplikacji i metadane web app                    |\n| [0012](.\u002F_TASKS\u002F0012.md) | Zrealizowane | Resetowanie stanu Pinia store'ów przy wylogowaniu     |\n| [0013](.\u002F_TASKS\u002F0013.md) | Zrealizowane | Konfigurowalna długość sesji (NUXT_SESSION_VALIDITY)  |\n| [0014](.\u002F_TASKS\u002F0014.md) | Zrealizowane | Refaktor walidacji wejścia API (DTOs + helper-y)      |\n| [0015](.\u002F_TASKS\u002F0015.md) | Zrealizowane | Warstwa bezpieczeństwa (nuxt-security)                |\n| [0016](.\u002F_TASKS\u002F0016.md) | Zrealizowane | Centralna funkcja apiCall dla wywołań API frontend-u  |\n| [0017](.\u002F_TASKS\u002F0017.md) | Zrealizowane | Globalny wskaźnik ładowania (appStatus + AppLoader)   |\n| [0018](.\u002F_TASKS\u002F0018.md) | Zrealizowane | Refaktor systemu komunikatów (appStatus + AppToaster) |\n| [0019](.\u002F_TASKS\u002F0019.md) | Zrealizowane | Testy integracyjne REST API                           |\n| [0020](.\u002F_TASKS\u002F0020.md) | Zrealizowane | Profil — data urodzenia i wzrost                      |\n| [0021](.\u002F_TASKS\u002F0021.md) | Zrealizowane | Statystyki — wskaźnik BMI w sekcji Waga               |\n| [0022](.\u002F_TASKS\u002F0022.md) | Zrealizowane | Konfiguracja SMTP i serwis wysyłki e-mail             |\n| [0023](.\u002F_TASKS\u002F0023.md) | Zrealizowane | Agent przypomnień e-mail                              |\n",[166,1003,1004,1009,1014,1019,1024,1029,1034,1039,1044,1049,1054,1059,1064,1069,1074],{"__ignoreMap":164},[169,1005,1006],{"class":171,"line":172},[169,1007,1008],{},"| Nr                       | Status       | Tytuł                                                 |\n",[169,1010,1011],{"class":171,"line":190},[169,1012,1013],{},"| ------------------------ | ------------ | ----------------------------------------------------- |\n",[169,1015,1016],{"class":171,"line":197},[169,1017,1018],{},"| [0011](.\u002F_TASKS\u002F0011.md) | Zrealizowane | Ikony aplikacji i metadane web app                    |\n",[169,1020,1021],{"class":171,"line":203},[169,1022,1023],{},"| [0012](.\u002F_TASKS\u002F0012.md) | Zrealizowane | Resetowanie stanu Pinia store'ów przy wylogowaniu     |\n",[169,1025,1026],{"class":171,"line":208},[169,1027,1028],{},"| [0013](.\u002F_TASKS\u002F0013.md) | Zrealizowane | Konfigurowalna długość sesji (NUXT_SESSION_VALIDITY)  |\n",[169,1030,1031],{"class":171,"line":214},[169,1032,1033],{},"| [0014](.\u002F_TASKS\u002F0014.md) | Zrealizowane | Refaktor walidacji wejścia API (DTOs + helper-y)      |\n",[169,1035,1036],{"class":171,"line":220},[169,1037,1038],{},"| [0015](.\u002F_TASKS\u002F0015.md) | Zrealizowane | Warstwa bezpieczeństwa (nuxt-security)                |\n",[169,1040,1041],{"class":171,"line":226},[169,1042,1043],{},"| [0016](.\u002F_TASKS\u002F0016.md) | Zrealizowane | Centralna funkcja apiCall dla wywołań API frontend-u  |\n",[169,1045,1046],{"class":171,"line":232},[169,1047,1048],{},"| [0017](.\u002F_TASKS\u002F0017.md) | Zrealizowane | Globalny wskaźnik ładowania (appStatus + AppLoader)   |\n",[169,1050,1051],{"class":171,"line":238},[169,1052,1053],{},"| [0018](.\u002F_TASKS\u002F0018.md) | Zrealizowane | Refaktor systemu komunikatów (appStatus + AppToaster) |\n",[169,1055,1056],{"class":171,"line":244},[169,1057,1058],{},"| [0019](.\u002F_TASKS\u002F0019.md) | Zrealizowane | Testy integracyjne REST API                           |\n",[169,1060,1061],{"class":171,"line":250},[169,1062,1063],{},"| [0020](.\u002F_TASKS\u002F0020.md) | Zrealizowane | Profil — data urodzenia i wzrost                      |\n",[169,1065,1066],{"class":171,"line":255},[169,1067,1068],{},"| [0021](.\u002F_TASKS\u002F0021.md) | Zrealizowane | Statystyki — wskaźnik BMI w sekcji Waga               |\n",[169,1070,1071],{"class":171,"line":261},[169,1072,1073],{},"| [0022](.\u002F_TASKS\u002F0022.md) | Zrealizowane | Konfiguracja SMTP i serwis wysyłki e-mail             |\n",[169,1075,1076],{"class":171,"line":266},[169,1077,1078],{},"| [0023](.\u002F_TASKS\u002F0023.md) | Zrealizowane | Agent przypomnień e-mail                              |\n",[16,1080,1081,1082,1085,1086,1089],{},"Ciekawostka: część tych zadań (np. ",[19,1083,1084],{},"0014–0018",") to czysty refaktor pojawiający się w trakcie pracy z aplikacją — kiedy zauważam powtarzający się wzorzec albo widzę, że coś jest robione na trzy różne sposoby. Wcześniej takie rzeczy odkładałem ",[47,1087,1088],{},"na kiedyś",". W tym workflow są równorzędnymi zadaniami, które przechodzą tę samą drogę co nowe funkcjonalności.",[11,1091,1093,1094],{"id":1092},"skill-pomocniczy-commit-staged","Skill pomocniczy: ",[166,1095,1096],{},"commit-staged",[16,1098,1099,1100,1103,1104,80,1107,80,1110,1113],{},"Pracując w tym tempie szybko okazuje się, że pisanie sensownych ",[47,1101,1102],{},"commit message-y"," po polsku też zajmuje wymierny czas, a jeszcze częściej pojawia się pokusa, żeby napisać byle co (",[166,1105,1106],{},"update",[166,1108,1109],{},"fix",[166,1111,1112],{},"wip","). Czas na kolejnego specjalistę:",[159,1115,1117],{"className":161,"code":1116,"language":163,"meta":164,"style":164},"Przygotuj SKILL-a o nazwie **commit-staged**, który przygotuje _commit message_ w języku polskim, dla plików, które są w statusie _staged_, wykona _commit_ z przygotowanym opisem. Na końcu ZAWSZE ma pytać, czy wykonać _git push_.\n",[166,1118,1119],{"__ignoreMap":164},[169,1120,1121],{"class":171,"line":172},[169,1122,1116],{},[16,1124,1125,1126,1129,1130,1132],{},"Od momentu powstania tego SKILL-a, jedyne polecenie zatwierdzające zmiany w repozytorium to ",[166,1127,1128],{},"\u002Fcommit-staged",". Komunikaty są spójne stylistycznie, krótkie, w jednym języku, a finalne pytanie o ",[166,1131,991],{}," chroni mnie przed nawykowym wysyłaniem niedokończonych zmian na zdalne repo.",[1134,1135],"hr",{},[11,1137,1139,1140],{"id":1138},"skill-5-dokumentacja-api-update-api-doc","SKILL #5: dokumentacja API — ",[166,1141,1142],{},"update-api-doc",[16,1144,1145,1146,1149],{},"Kolejnym eksperymentem było sprawdzenie, czy agent jest w stanie samodzielnie utrzymywać dokumentację techniczną. Zlecam przygotowanie SKILL-a do dokumentacji ",[19,1147,1148],{},"REST API",":",[159,1151,1153],{"className":161,"code":1152,"language":163,"meta":164,"style":164},"Przygotuj SKILL-a o nazwie **update-api-doc**, który utworzy (jeśli nie istnieje) lub zaktualizuje (np. po zmianach w **backend**) plik `.\u002FAPI.md`. Skill ma dbać o dobrej jakości dokumentację wszystkich punktów _REST API endpoints_, zawierającą URL, metodę HTTP, przyjmowane dane wejściowe (z podziałem na body, url params, query params), czy sprawdza autentykację\u002Fautoryzację użytkownika oraz biznesowy opis operacji, które wykonuje przy wywołaniu.\n",[166,1154,1155],{"__ignoreMap":164},[169,1156,1157],{"class":171,"line":172},[169,1158,1152],{},[16,1160,1161,1162,1165,1166,1169],{},"Uruchomienie ",[166,1163,1164],{},"\u002Fupdate-api-doc"," dało mi kompletny plik ",[19,1167,1168],{},"API.md"," ze wszystkimi endpoint-ami: URL, metoda HTTP, wymagana autentykacja, schemat wejścia, opis biznesowy. Od tego momentu wystarczy wywołać ten SKILL po wprowadzeniu zmian w warstwie API, żeby dokumentacja była zsynchronizowana z kodem.",[11,1171,1173,1174],{"id":1172},"skill-6-porządkowanie-specyfikacji-cleanup-spec","SKILL #6: porządkowanie specyfikacji — ",[166,1175,1176],{},"cleanup-spec",[16,1178,1179,1180,1182,1183,1185,1186,84,1188,1190],{},"Po kilkudziesięciu iteracjach przez ",[166,1181,956],{}," zaczęły pojawiać się ostrzeżenia w konsoli ",[19,1184,60],{},": pliki ",[19,1187,141],{},[19,1189,572],{}," rozrosły się i zaczęły zajmować nieproporcjonalnie dużą część okna kontekstowego. Po krótkim audycie tych plików stało się jasne dlaczego:",[90,1192,1193,1205,1213],{},[93,1194,1195,1198,1199,1201,1202,1204],{},[47,1196,1197],{},"powielały się"," informacje między ",[19,1200,141],{}," a ",[19,1203,572],{},",",[93,1206,1207,1209,1210,1212],{},[47,1208,1197],{}," informacje z plikami zewnętrznymi (np. ",[19,1211,1168],{},"),",[93,1214,1215,1218],{},[47,1216,1217],{},"układ rozdziałów"," przestał być logiczny — np. „Usuwanie pomiarów” (funkcja użytkownika) wcisnęło się między „Skrypty administracyjne” a „Zmienne środowiskowe”.",[16,1220,1221],{},"Potrzebny był SKILL porządkujący:",[159,1223,1225],{"className":161,"code":1224,"language":163,"meta":164,"style":164},"Przygotuj SKILL-a o nazwie **cleanup-spec**, który porządkuje pliki `.\u002FSPEC.md` oraz `.\u002FCLAUDE.md`. Pliki szybko się rozrastają i agent rzuca ostrzeżeniami, że są zbyt duże, rozdmuchują kontekst. Nie ma sensu powielać tych samych informacji w obu plikach lub informacji, które są dostępne w plikach dodatkowych jak na przykład `.\u002FAPI.md`, który stanowi pełną dokumentację endpoint-ów REST API. Wystarczy przywołać plik zewnętrzny - wstawić link do pliku. Plik `.\u002FSPEC.md` powinien koncentrować się na danych zarządzanych w aplikacji oraz na stronie funkcjonalnej i biznesowej aplikacji, zawierać opisy funkcjonalności i realizowanych procesów biznesowych, czyli zawierać specyfikację z naciskiem na biznesową, a mniej techniczną. Zawartość powinna być lepiej uporządkowana, np. w tej chwili rozdział **Usuwanie pomiarów** (funkcja użytkownika), jest nielogicznie wciśnięty pomiędzy rozdziały **Skrypty administracyjne**, a **Zmienne środowiskowe**. Plik `.\u002FCLAUDE.md` powinien mieć zawartość zalecaną przez agenta _Claude Code_, ale wg mnie powinien koncentrować się na warstwie bardziej technicznej oraz stanowić pamięć projektu, czyli przechowywać wzorce projektowe, zalecenia architektoniczne. Nie powinien powielać informacji już dostępnych w pliku `.\u002FSPEC.md` oraz innych plikach projektu (jak `.\u002FAPI.md`), ale na pewno powinien na niego wskazywać z opisem co zawiera.\n",[166,1226,1227],{"__ignoreMap":164},[169,1228,1229],{"class":171,"line":172},[169,1230,1224],{},[16,1232,1161,1233,1236,1237,1240,1241,1243,1244,1247,1248,1250,1251,1253],{},[166,1234,1235],{},"\u002Fcleanup-spec"," zredukowało rozmiar obu plików o około ",[19,1238,1239],{},"40%",", uporządkowało strukturę rozdziałów i pozbyło się duplikatów. Ważniejsze niż statystyki — zmiana ról jest teraz jasna: ",[19,1242,141],{}," mówi ",[47,1245,1246],{},"co"," robi aplikacja z perspektywy biznesowej, ",[19,1249,572],{}," to projektowa pamięć agenta i warstwa techniczna, a pliki takie jak ",[19,1252,1168],{}," są przywoływane linkami zamiast kopiowane.",[11,1255,1257,1258],{"id":1256},"skill-7-instrukcja-użytkownika-update-user-guide","SKILL #7: instrukcja użytkownika — ",[166,1259,1260],{},"update-user-guide",[16,1262,1263,1264,1267],{},"Dokumentacja deweloperska to jedno, ale ",[19,1265,1266],{},"instrukcja dla użytkownika końcowego"," to zwykle zupełnie inna jakościowo historia: musi być prosta, czytelna, ze zrzutami ekranów. W praktyce takiej instrukcji prawie nigdy nie ma — pisze się ją na końcu projektu i niespecjalnie chętnie. Aplikacja jest dla mnie, więc instrukcja nie jest konieczna, ale to ciekawy test dla całego workflow.",[159,1269,1271],{"className":161,"code":1270,"language":163,"meta":164,"style":164},"Przygotuj SKILL-a o nazwie **update-user-guide**, który utworzy (jeśli nie istnieje) lub zaktualizuje (np. po zmianach w **frontend**) plik `.\u002FGUIDE.md`. SKILL ma dbać o dobrej jakości instrukcję dla użytkownika końcowego, zawierającą opis wszystkich funkcjonalności wraz ze zrzutami ekranów. SKILL ma tworzyć i używać użytkownika testowego, wykonać _seed_ tabel bazy danych, żeby wypełnić testowymi danymi (strona statystyk musi coś pokazywać), a zrzuty ekranu wykonać za pomocą _Playwright_.\n",[166,1272,1273],{"__ignoreMap":164},[169,1274,1275],{"class":171,"line":172},[169,1276,1270],{},[16,1278,1279],{},"Wynik mile mnie zaskoczył. Agent samodzielnie:",[90,1281,1282,1285,1292,1295,1306],{},[93,1283,1284],{},"utworzył testowego użytkownika,",[93,1286,1287,1288,1291],{},"wykonał ",[47,1289,1290],{},"seed"," tabel pomiarów (dziesiątki rekordów rozłożonych w czasie, żeby wykresy miały sens),",[93,1293,1294],{},"uruchomił aplikację,",[93,1296,1297,1298,1305],{},"przeszedł przez wszystkie ekrany za pomocą ",[19,1299,1300],{},[26,1301,1304],{"href":1302,"rel":1303},"https:\u002F\u002Fplaywright.dev\u002F",[30],"Playwright",", robiąc zrzuty,",[93,1307,1308],{},"napisał spójną instrukcję powiązaną tekstowo z odpowiednimi obrazkami.",[16,1310,1311,1312,1315,1316,1319],{},"Plik ",[19,1313,1314],{},"GUIDE.md"," spokojnie nadaje się do wyeksportowania jako PDF albo do podpięcia w samej aplikacji pod linkiem ",[19,1317,1318],{},"Instrukcja"," w menu głównym.",[11,1321,1323],{"id":1322},"generowanie-readmemd","Generowanie README.md",[16,1325,1326,1327,1330],{},"Na samym końcu, kiedy aplikacja, API i instrukcja dla użytkownika były już gotowe, poprosiłem agenta o jeszcze jedną rzecz — ",[47,1328,1329],{},"główną stronę projektu"," na GitHubie:",[159,1332,1334],{"className":161,"code":1333,"language":163,"meta":164,"style":164},"Mając wiedzę na temat tego projektu, przygotuj prosty plik **README.md**, który będzie stanowił główną stronę projektu dla GitHub repo.\n",[166,1335,1336],{"__ignoreMap":164},[169,1337,1338],{"class":171,"line":172},[169,1339,1333],{},[16,1341,1342,1343,1346,1347,80,1350,1353],{},"Tym razem nie tworzyłem SKILL-a — to była operacja jednorazowa. Agent przygotował kompletny ",[19,1344,1345],{},"README.md"," zawierający opis funkcji, stack technologiczny, instrukcję instalacji i uruchomienia, sposób zakładania kont użytkowników skryptem CLI oraz sekcję o aktualizacji zależności i bezpieczeństwie łańcucha dostaw (",[166,1348,1349],{},".ncurc.json",[166,1351,1352],{},".npmrc",").",[11,1355,1357],{"id":1356},"podsumowanie-workflow","Podsumowanie workflow",[16,1359,1360,1361,1363,1364,1367],{},"W finalnej formie cały mój ",[19,1362,5],{}," dla projektu ",[19,1365,1366],{},"CPW"," sprowadza się do kilku ról i jednej pętli:",[16,1369,1370],{},[19,1371,1372],{},"Role (SKILL-e):",[90,1374,1375,1380,1389,1395,1401,1406,1415,1424],{},[93,1376,1377,1379],{},[166,1378,616],{}," — planista, czyta specyfikację, układa zadania od bazy danych po frontend.",[93,1381,1382,1385,1386,69],{},[166,1383,1384],{},"do-task \u003Cnr>"," — wykonawca, realizuje pojedyncze zadanie zgodnie z planem w ",[166,1387,1388],{},"_TASKS\u002FNNNN.md",[93,1390,1391,1394],{},[166,1392,1393],{},"update-task \u003Cnr> \u003Copis>"," — korygujący, aktualizuje opis zadania i wprowadza zmianę w kodzie.",[93,1396,1397,1400],{},[166,1398,1399],{},"update-spec \u003Copis>"," — analityk biznesowy, aktualizuje specyfikację o nowe wymagania.",[93,1402,1403,1405],{},[166,1404,1176],{}," — porządkowy, dba o higienę plików specyfikacji.",[93,1407,1408,1410,1411,1414],{},[166,1409,1142],{}," — ",[47,1412,1413],{},"technical writer"," od API.",[93,1416,1417,1410,1419,1421,1422,1353],{},[166,1418,1260],{},[47,1420,1413],{}," od instrukcji użytkownika (ze zrzutami z ",[19,1423,1304],{},[93,1425,1426,1428],{},[166,1427,1096],{}," — sekretarz, opisuje i zatwierdza zmiany w repozytorium.",[16,1430,1431],{},[19,1432,1433],{},"Pętla rozwojowa:",[159,1435,1440],{"className":1436,"code":1438,"language":1439},[1437],"language-text","Główna:\n  pomysł → \u002Fupdate-spec → \u002Fupdate-tasks-list → \u002Fdo-task → (\u002Fupdate-task)* → \u002Fcommit-staged\n\nPomocnicza:\n  ↘ \u002Fupdate-api-doc, \u002Fupdate-user-guide (regularnie)\n  ↘ \u002Fcleanup-spec (okresowo)\n","text",[166,1441,1438],{"__ignoreMap":164},[16,1443,1444,1445,80,1448,80,1451,84,1456,1459],{},"Moja rola w tej pętli to ",[19,1446,1447],{},"architektura",[19,1449,1450],{},"decyzje koncepcyjne",[19,1452,1453,1454],{},"recenzja przez ",[166,1455,818],{},[19,1457,1458],{},"testy ręczne"," w przeglądarce. Agent wykonuje wszystko, co da się jednoznacznie opisać — a okazuje się, że da się opisać znacznie więcej, niż na pierwszy rzut oka się wydaje.",[1461,1462,1463],"warning",{},[16,1464,1465,1466,1469,1470,1472],{},"Workflow nie zwalnia z myślenia. Agent generuje kod zgodny z opisem zadania, ale to nie znaczy, że jest to ",[19,1467,1468],{},"najlepszy"," kod. Jakość decyzji architektonicznych nadal zależy od człowieka — agent doskonale wykonuje to, co mu powiesz, ale nie powie ci, że powinieneś powiedzieć coś innego. ",[166,1471,818],{}," przed każdym commit-em to nadal podstawa, a nie formalność.",[11,1474,1476],{"id":1475},"wnioski","Wnioski",[16,1478,1479],{},"Trzy obserwacje, które wynoszę z tego projektu:",[90,1481,1482,1488,1502],{},[93,1483,1484,1487],{},[19,1485,1486],{},"Wyspecjalizowany agent bije agenta uniwersalnego."," Te same modele i to samo narzędzie, ale rozdzielenie ról przez SKILL-e dało jakościowo lepsze wyniki niż próby zmuszania jednej sesji do robienia wszystkiego naraz. Każdy SKILL ma jasne kryteria sukcesu, jasne pliki, na których pracuje, i jasne ograniczenia.",[93,1489,1490,1493,1494,1496,1497,988,1499,1501],{},[19,1491,1492],{},"Specyfikacja musi być żywa."," Workflow, w którym ",[19,1495,141],{}," jest pisany raz na początku i nigdy nie odświeżany, rozjeżdża się z kodem w ciągu tygodni. ",[166,1498,956],{},[166,1500,1235],{}," to nie luksus, tylko warunek konieczny, żeby reszta procesu w ogóle miała sens po kilkudziesięciu iteracjach.",[93,1503,1504,1507,1508,1511,1512,1515],{},[19,1505,1506],{},"Małe zadania, częste commit-y."," Konwencja ",[166,1509,1510],{},"1 zadanie = 1 funkcjonalność = 1 commit"," (z opcjonalnymi commit-ami od ",[166,1513,1514],{},"\u002Fupdate-task",") daje czytelną historię i pozwala szybko cofać się do dowolnego stanu projektu. Bez tego nie da się recenzować pracy agenta na tej skali.",[16,1517,1518,1519,1521,1522,1525,1526,1529,1530,1533,1534,80,1536,1539,1540,1542],{},"Aplikacja ",[19,1520,1366],{}," jest niekomercyjna i pisana wyłącznie dla mnie, więc jako ",[47,1523,1524],{},"projekt produktowy"," jest mało ekscytująca. Jako ",[47,1527,1528],{},"ćwiczenie z workflow"," była bardzo wartościowa — w kilku wieczorach zbudowałem działającą aplikację z ",[19,1531,1532],{},"23 zadaniami",", pełną dokumentacją techniczną, dokumentacją ",[19,1535,1148],{},[19,1537,1538],{},"instrukcją użytkownika"," ze zrzutami ekranów i wzorcami bezpieczeństwa łańcucha dostaw. Wszystko to z ",[166,1541,891],{},"-iem, w którym każdy commit ma sens.",[11,1544,1546],{"id":1545},"materiały-do-pobrania-podglądu","Materiały do pobrania \u002F podglądu",[16,1548,1549,1550,1552],{},"Wszystkie SKILL-e opisane w tym artykule oraz pliki dokumentacji wygenerowane w projekcie ",[19,1551,1366],{}," udostępniam do swobodnego użycia:",[90,1554,1555,1569,1578,1587],{},[93,1556,1557,1564,1565,1568],{},[19,1558,1559],{},[26,1560,1563],{"href":1561,"rel":1562,"external":164},"https:\u002F\u002Fgithub.com\u002FArturWilczek\u002Fclaude-skills-1",[30],"Komplet SKILL-i Claude Code"," — publiczne repozytorium z wszystkimi 8 SKILL-ami jako zestawem plików ",[166,1566,1567],{},"SKILL.md"," w odpowiedniej strukturze katalogów.",[93,1570,1571,1577],{},[19,1572,1573],{},[26,1574,1576],{"href":1575},"\u002Fprevs\u002Fp0002","Przykładowy README.md"," — wygenerowany na końcu projektu.",[93,1579,1580,1586],{},[19,1581,1582],{},[26,1583,1585],{"href":1584},"\u002Fprevs\u002Fp0003","Przykładowy API.md"," — pełna dokumentacja REST API.",[93,1588,1589,1595,1596,69],{},[19,1590,1591],{},[26,1592,1594],{"href":1593},"\u002Fprevs\u002Fp0004","Przykładowy GUIDE.md"," — instrukcja użytkownika końcowego ze zrzutami z ",[19,1597,1304],{},[16,1599,1600,1601,1604],{},"Wystarczy skopiować SKILL-e do katalogu ",[166,1602,1603],{},".claude\u002Fskills\u002F"," we własnym projekcie i można od razu zacząć pracę w tym samym workflow.",[1606,1607,1608],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":164,"searchDepth":190,"depth":190,"links":1610},[1611,1612,1613,1614,1615,1616,1618,1619,1621,1623,1625,1626,1628,1630,1632,1634,1635,1636,1637],{"id":13,"depth":190,"text":14},{"id":72,"depth":190,"text":73},{"id":123,"depth":190,"text":124},{"id":552,"depth":190,"text":553},{"id":588,"depth":190,"text":589},{"id":612,"depth":190,"text":1617},"SKILL #1: planista zadań — update-tasks-list",{"id":697,"depth":190,"text":698},{"id":804,"depth":190,"text":1620},"SKILL #2: wykonawca — do-task",{"id":874,"depth":190,"text":1622},"SKILL #3: korygujący — update-task",{"id":912,"depth":190,"text":1624},"SKILL #4: aktualizacja specyfikacji — update-spec",{"id":941,"depth":190,"text":942},{"id":1092,"depth":190,"text":1627},"Skill pomocniczy: commit-staged",{"id":1138,"depth":190,"text":1629},"SKILL #5: dokumentacja API — update-api-doc",{"id":1172,"depth":190,"text":1631},"SKILL #6: porządkowanie specyfikacji — cleanup-spec",{"id":1256,"depth":190,"text":1633},"SKILL #7: instrukcja użytkownika — update-user-guide",{"id":1322,"depth":190,"text":1323},{"id":1356,"depth":190,"text":1357},{"id":1475,"depth":190,"text":1476},{"id":1545,"depth":190,"text":1546},"2026-06-02","Buduję zespół agentów \u002F specjalistów Claude Code, ustalam flow procesu produkcji i utrzymania nowej aplikacji.",false,"md","\u002Fpics\u002F0004.png",{"order":203},null,"\u002Fblog\u002Fai-driven-development-workflow",{"title":5,"description":1639},{"loc":1645},"blog\u002Fai-driven-development-workflow","0rtmlzc-pXSpm9CUe4hMCO4y11PijZ_99GJp5lQHPYE",[1651,1656],{"title":1652,"path":1653,"stem":1654,"description":1655,"children":-1},"Dwa dni robocze, jeden działający prototyp","\u002Fblog\u002Fmakieta-nuxt-supabase","blog\u002Fmakieta-nuxt-supabase","W dwa dni robocze, z pomocą Copilot-a i MCP, zbudowałem działającą makietę aplikacji medycznej.",{"title":1657,"path":1658,"stem":1659,"description":1660,"children":-1},"Grafiki i obrazy OG — nowe SKILL-e","\u002Fblog\u002Fgrafiki-artykulow-i-obrazy-og","blog\u002Fgrafiki-artykulow-i-obrazy-og","Dwa SKILL-e Claude Code, które generują grafiki artykułów i obrazy Open Graph stron w powtarzalnym stylu — AI od generowania bazowej grafiki, skrypty od manipulacji obrazem.",1780996675131]