Czym jest Rzemiosło — The Craft

Rzemiosło (The Craft) to sztuka stawiania aplikacji end-to-end z Claude — takich, które są skalowalne, utrzymywalne i łatwe do dalszego rozwoju, Migracja (bazy danych) — Kontrolowana zmiana układu bazy — dodanie kolumny, tabeli czy przeniesienie danych — krok po kroku. Jak remont według planu: przebudowa danych w ustalonej kolejności, żeby nic się nie „zawaliło”. i zmiany przez całe życie projektu. Nie framework, nie biblioteka — doktryna współpracy człowiek + agent: zwarty zestaw reguł, przykazań i antywzorców, dzięki którym kod zostaje zrozumiały dla następnej sesji, testowalny, bezpieczny w zmianie i godny zaufania — od pierwszego commita po prod z żywymi użytkownikami.

W jednym akapicie

Większość projektów budowanych z AI nie rozsypuje się dlatego, że agent nie umie pisać kodu — rozsypuje się dlatego, że nikt nie ustalił zasad. The Craft to właśnie te zasady: dołączasz je do projektu jako docs/rules/, a Claude od Dnia 0 wie „jak my to robimy”. Efekt to aplikacja o ekstremalnie elastycznej strukturze plików i technologii — zaczynasz prosto (jeden serwer, jedna baza), a struktura jest z góry gotowa na wzrost: rozdzielone warstwy, Feature flag — Wewnętrzny włącznik, który uruchamia nową funkcję dla części ludzi albo wyłącza ją bez przerabiania kodu. Wpuszczasz nowość stopniowo i wycofujesz w sekundę — najtańsza polisa przy każdej zmianie., migracje forward-only, Slug — Czytelna, krótka część adresu strony, opisująca jej treść słowami zamiast tajemniczego numeru. Lepszy dla człowieka i SEO; trwały slug nie psuje linków przy zmianach. zamiast ID. Rozwijasz, migrujesz i skalujesz bez przepisywania od zera. Wszystko z poszanowaniem prywatności osobistej i prawa (RODO / GDPR — Unijne prawo o ochronie danych osobowych — jak wolno zbierać, trzymać i usuwać dane użytkowników. Dotyczy każdej aplikacji z danymi ludzi. Lepiej wpisać zgody i retencję od początku niż płacić kary później./GDPR, zgody, ochrona twórcy) wpisanym od początku, nie doklejonym na końcu.

Co dostajesz

Kod, który czyta się jak proza — dopasowany do otoczenia, łatwy w review przez człowieka i agenta.
Historia git jako pamięć projektu — szukasz, zanim napiszesz; nic nie wymyślasz od nowa.
Weryfikację zamiast deklaracji — „działa” znaczy dowód: Smoke test — Szybki test „czy w ogóle działa” zaraz po wdrożeniu — sprawdza najważniejsze ścieżki (np. logowanie). Łapie katastrofy w 30 sekund, zanim zobaczy je użytkownik. Tani sposób na spokojny sen po deployu., kod HTTP, liczby, screenshot.
Bezpieczeństwo zmian — Dry-run — Uruchomienie „na sucho” — skrypt pokazuje, co BY zrobił, ale niczego nie zmienia. Widzisz skutki przed wykonaniem; zmiana na danych idzie dopiero po świadomym potwierdzeniu. domyślnie, backup przed każdą migracją, prod święty, dane userów nienaruszalne.
Elastyczność i skalowalność — Monolit — Aplikacja zbudowana jako jedna całość (jeden deploy, jedna baza), a nie zlepek osobnych usług. Prosty, tani default na start — łatwy do ogarnięcia. Rozbijasz go dopiero, gdy skala naprawdę tego wymaga. na jednym VPS — Wynajęty kawałek serwera w chmurze „tylko dla Ciebie”, na którym stawiasz aplikację „na żywo”. Przewidywalny koszt i pełna kontrola. Jeden VPS spokojnie uniesie kilka małych projektów. jako prosty default, z jawną ścieżką wzrostu (SQLite — Najprostsza baza danych — cała mieszka w jednym pliku, bez osobnego serwera. Świetny default na start: zero konfiguracji, łatwy backup (kopiujesz plik). Przy wzroście migrujesz wyżej. → PostgreSQL — Solidna, „dorosła” baza danych do większych aplikacji — działa jako osobny serwer. Domyślny krok po SQLite, gdy potrzebujesz wielu równoczesnych użytkowników i zaawansowanych funkcji., VPS → Serverless — Model, w którym nie zarządzasz serwerem — kod odpala się sam, gdy ktoś go potrzebuje, i śpi, gdy nie. Płacisz za użycie, skaluje się sam. Pułapka: „zimny start” — pierwsze wywołanie bywa wolniejsze.), gdy metryka tego wymusi.
Spokój prawny — regulamin, polityka prywatności i disclaimery jako zbroja twórcy, nie refleksja po fakcie.

Dlaczego warto spróbować napisać aplikację z The Craft

Bo różnica nie jest w tym, czy agent napisze kod — tylko w tym, jak będzie wyglądał Twój projekt za trzy miesiące. Bez zasad każda sesja z agentem dokłada trochę chaosu: niespójny styl, dokumentacja, która kłamie, migracja bez backupu, deploy „bo gotowe”. Po kwartale masz aplikację, której boisz się dotknąć. The Craft odwraca tę trajektorię: każda zmiana zostawia projekt czytelniejszym, nie gorszym.

Zaczynasz szybko, a nie tanim kosztem. Jeden serwer, prosty stack, monolit — coś, co ogarniasz w głowie: jeden deploy, jeden log, jeden backup, jeden Rollback — Cofnięcie zmiany do poprzedniego, działającego stanu — „Ctrl+Z” dla wdrożenia. Gdy nowa wersja psuje produkcję, rollback przywraca poprzednią w sekundy zamiast naprawiać w panice.. To nie jest „prymitywne” — to jest tanie w utrzymaniu. A gdy naprawdę przyjdzie skala, struktura już na nią czeka: warstwy są rozdzielone, klucze stabilne, migracje jednokierunkowe. Rozwój i migracja przestają być przepisywaniem — stają się dokładaniem.

Człowiek i agent grają do jednej bramki. Plan → iteruj → review. Agent nie zgaduje — wykonuje sprawdzony przepis, szuka w historii, raportuje uczciwie (z błędami, nie tylko z sukcesami). Ty zostajesz architektem decyzji, nie korektorem chaosu. To współpraca, w której zaufanie buduje się na dowodzie, a nie na optymizmie.

Prywatność i prawo masz z głowy od Dnia 0. RODO/GDPR, zgody, retencja, ochrona twórcy — wpisane jako polityki w konstytucję projektu, zanim pojawi się pierwszy realny użytkownik. Żadnych nocnych poprawek „bo ktoś poprosił o usunięcie konta”.

Najlepsze: to jest reużywalne. The Craft nie jest „pod jeden projekt”. Dołączasz go jako docs/rules/ do każdej nowej aplikacji, wypełniasz brief i ruszasz — a każdy kolejny projekt korzysta z lekcji poprzedniego.

Nie musisz nawet czytać całego Dekalogu na start. Najszybsze wejście: zainstaluj Claude Desktop / Claude Code, wypełnij brief, dołącz The Craft jako docs/rules/ — i jedziesz. Agent czyta reguły, więc nie musisz ich pamiętać; doktryna po prostu działa w tle.

Spróbuj raz. Weź następny pomysł, dołącz The Craft, zacznij od Dnia 0 i zbuduj go jak rzemieślnik — wolno tam, gdzie błąd jest drogi; szybko tam, gdzie jest tani. Zobaczysz różnicę nie pierwszego dnia, ale trzeciego miesiąca — gdy aplikacja wciąż jest przyjemna do rozwijania. Zacznij od Dekalogu: cała doktryna na jednym ekranie.