Kurs vibe coding z Claude Code · Moduł 11: Klon Spotify
Lista kontrolna przed publikacją
W tej lekcji8
Sea Shanty Sounds to ostatni klon tej części kursu. Po drodze zebrałeś kilkanaście nawyków: testy i build jako dowód, przegląd diffu, /code-review, /security-review, reguły deny, .env.example, podgląd przed produkcją. Każdy z nich ratował już jakiś rejs. Kłopot w tym, że przed publikacją trzeba pamiętać o wszystkich naraz, a pośpiech wymazuje z pamięci zawsze ten jeden, który akurat był potrzebny. Piloci mają na to prosty sposób: listę kontrolną, którą czytają przed każdym startem, choćby latali od dwudziestu lat. Ty zapiszesz swoją w projekcie, żeby Claude szedł po niej za każdym razem tak samo.
Czego się nauczysz
- zdecydować, gdzie w projekcie zapisać procedurę: w
CLAUDE.md, w regułach czy w skillu; - podzielić listę na punkty, które sprawdza Claude, i punkty, które zostają dla kapitana;
- przeczytać wynik listy jak raport, a nie jak pieczątkę;
- wiedzieć, czego żadna lista nie złapie.
Gdzie zapisać listę
Masz trzy miejsca. CLAUDE.md z lekcji 1_7 ładuje się do każdej rozmowy, więc dziesięć punktów o publikacji zabierałoby uwagę przy każdej poprawce przycisku. Reguły w .claude/rules/ ładują się, gdy Claude pracuje na plikach pasujących do ścieżek z nagłówka reguły, a publikacja nie dotyczy konkretnych plików. Skill z lekcji 6_1 pasuje najlepiej: według dokumentacji w kontekście stale siedzi tylko jego opis, a pełna treść ładuje się dopiero przy użyciu.
Zostaje pytanie o disable-model-invocation. Przy /deploy było obowiązkowe, bo skill wdraża. Lista niczego nie wdraża ani nie poprawia, więc tu go nie dajesz: Claude może sięgnąć po nią sam, gdy powiesz "przygotuj publikację". Nawet wtedy wdrożenie dalej wymaga Twojego /deploy.
Polecenie dla Claude Code
Skill zamawiasz jak każdy plik: mówisz, gdzie ma leżeć, co ma sprawdzać i czego ma nie robić, a Claude zapisuje go i pokazuje do przeczytania.
Zapisz skill /przed-publikacja w .claude/skills/. Skill niczego nie
wdraża i niczego nie poprawia, tylko sprawdza i kończy tabelą: punkt,
komenda, wynik, ZALICZONE albo NIE ZALICZONE. Część pierwsza to punkty,
które sprawdzisz komendami: komendy z CLAUDE.md, czysty git status,
pliki .env w repozytorium, nazwy zmiennych w .env.example, reguły
w .claude/settings.json, next.config.ts, zmienione pliki testów.
Część druga to lista do odhaczenia dla mnie: przeglądy, /verify,
klucze w buildzie, podgląd, promocja i plan odwrotu.Co napisał Claude: część dla Claude
Otwórz w Cursorze .claude/skills/przed-publikacja/SKILL.md. Nagłówek ma tylko nazwę i opis, bo to opis podpowiada Claude, kiedy sięgnąć po skill:
---
name: przed-publikacja
description: Lista kontrolna przed publikacją Sea Shanty Sounds. Użyj, gdy kapitan chce wdrożyć podgląd albo produkcję.
---Pod nagłówkiem stoi zasada "Niczego nie wdrażaj i niczego nie poprawiaj", a potem siedem punktów dla Claude:
1. Komendy sprawdzające z CLAUDE.md: testy, lint, typy, build. Każda kończy się sukcesem.
2. git status --short nie pokazuje niczego. Jeśli coś pokazuje, zatrzymaj się.
3. git ls-files | grep -E '(^|/)\.env' pokazuje tylko .env.example.
4. Każda nazwa z grep -rhoE 'process\.env\.[A-Z0-9_]+' app components lib stoi w .env.example. Zmienna z kluczem nie ma przedrostka NEXT_PUBLIC_.
5. .claude/settings.json ma reguły deny dla .env i .env.* oraz reguły ask dla vercel i git push.
6. next.config.ts nie ma images.domains, a każdy adres obrazka w kodzie pasuje do images.remotePatterns.
7. Wypisz pliki testów zmienione w ostatnich commitach (git log --oneline --stat -5 -- '*.test.ts' '*.test.tsx'), żeby kapitan je przeczytał.Każdy punkt to nawyk z wcześniejszych lekcji, tym razem z komendą, którą da się sprawdzić. Punkt 1 to poręcz z lekcji 10_4. Punkt 3 pilnuje, żeby żaden plik z wartościami zmiennych nie wjechał do Gita, a punkt 4 porównuje nazwy z kodu z .env.example z lekcji 10_5. git ls-files wypisuje pliki śledzone przez Gita, a grep -o wycina z kodu same nazwy zmiennych. Punkt 5 sprawdza zamki z lekcji 8_4 i 10_5, punkt 6 obrazy, a punkt 7 nie ocenia, tylko kładzie Ci przed oczy zmiany w testach, bo osłabiony test wygląda w raporcie na zielony.
Komendy z listy uruchomiliśmy na projekcie po lekcji 10_5. Testy: Test Files 8 passed (8) i Tests 23 passed (23), lint, typy i build bez błędów, pusty git status --short. git ls-files znalazł tylko .env.example, a grep nazw zwrócił jedną, process.env.NEXT_PUBLIC_AUDIO_BASE_URL, która stoi w .env.example. grep -n domains next.config.ts nie znalazł nic.
Potem sprawdziliśmy, czy lista coś łapie. Odegraliśmy agenta, który "przy okazji" dopisał do konfiguracji obrazków jedną linię ze starego poradnika:
5: domains: ["picsum.photos"],To wynik komendy z punktu 6: numer linii i jej treść. Jednocześnie git status --short pokazał M next.config.ts, więc nie przeszedł też punkt 2. Jedna zmiana, której nie zamawiałeś, oblała dwa punkty, a Ty dowiadujesz się o niej przed publikacją, a nie po niej. Lint i typy takiej zmiany nie zauważą, co widziałeś w lekcji 10_5, a build tylko ostrzeże.
Co napisał Claude: część dla kapitana
Druga część to punkty, których Claude nie może albo nie powinien zaliczyć za Ciebie:
- /code-review i /security-review na tej gałęzi; decyzja, które uwagi przyjmuje.
- /verify po ostatniej zmianie.
- Fragment każdego klucza z .env.local szukany w .next/static we własnym terminalu: zero trafień.
- Podgląd z /deploy otwarty w przeglądarce: odtwarzacz, okładki, wyszukiwarka.
- Promocja na produkcję w panelu Vercela, ręcznie.
- Plan odwrotu: który poprzedni deployment przywróci Instant Rollback.Każdy z tych punktów ma swój powód. Raport /security-review i /code-review to hipotezy do sprawdzenia, jak w lekcjach 2_9 i 8_7, więc decyzja jest Twoja. /verify uruchamiasz po słowie "gotowe", jak w lekcji 10_4. Klucza w buildzie Claude nie sprawdzi, bo reguła deny z lekcji 8_4 nie pozwala mu czytać .env.local, i dobrze: fragment klucza wpisujesz w swoim terminalu, a dobre trafienie to zero trafień. Podgląd, promocja i plan odwrotu to lekcja 10_5.
Przegląd kapitana
Wynik listy czytasz jak raport zwiadowcy, nie jak pieczątkę:
- Każdy punkt ma komendę i wynik. "ZALICZONE" bez komendy pod spodem to zapewnienie, nie dowód.
- NIE ZALICZONE zatrzymuje rejs. Nie prosisz o "napraw wszystko". Wybierasz punkt i wydajesz wąskie polecenie, jak przy poprawkach po przeglądzie bezpieczeństwa.
- Lista nie poprawia sama siebie. Typowy błąd agenta to dopisanie "dla porządku" kroku, który coś zmienia, na przykład
npm audit fixalbo automatyczny commit. Każda zmiana wSKILL.mdprzechodzi przez Twój diff jak kod. - Nagłówek bez furtek. W nagłówku nie ma pola
allowed-tools, które według dokumentacji pozwala w danej turze używać wymienionych narzędzi bez pytania. Lista, która tylko sprawdza, nie potrzebuje zgody na nic poza komendami, które i tak przeczytasz w raporcie. - Lista rośnie po wpadkach. Dobre praktyki radzą dopisywać do instrukcji to, co poprawiałeś już dwa razy. Gdy podgląd przepuści błąd, który dało się złapać komendą, dopisz punkt.
Czego lista nie złapie
Bądź wobec listy uczciwy. Testy pilnują tylko tego, co ktoś opisał w teście: błąd w ścieżce, której nikt nie przetestował, przejdzie przez wszystkie siedem punktów. Grep znajdzie tylko klucz, którego fragment znasz, a nie sekret wklejony pod inną nazwą. Podgląd ma zmienne podglądu, więc produkcja może zachować się inaczej, a promocja buduje aplikację od nowa ze zmiennymi produkcji. Reguły ask i deny dopasowują tekst komendy, a nie jej skutek. Lista nie widzi też tego, co dzieje się poza projektem: awarii hostingu nagrań czy zmian w cudzym API. Dlatego ostatnim punktem zawsze jest plan odwrotu.
Następny krok
Poproś o commit, na przykład "Skill przed-publikacja". Od teraz każdy rejs ma tę samą kolejność: /przed-publikacja, Twoje punkty z listy, /deploy, podgląd w przeglądarce, promocja w panelu i gotowy plan odwrotu. Mentorowi wyślesz zrzut działającego Sea Shanty Sounds, zrzut zielonych testów i swoją listę. W edytorze poniżej czeka lista kontrolna do przejścia: odhaczaj punkty, włącz błędy agenta i zobacz, który punkt je łapie, a który nie.
Pamiętaj: lista kontrolna nie płynie za kapitana, ale nie pozwala mu zapomnieć o żadnej linie przed wyjściem z portu.
Kod do tej lekcji: App.jsx
// Lista kontrolna przed publikacją: punkty Claude, punkty kapitana i błędy agenta
import { useState } from 'react';
const MISTAKES = [
{ id: 'domains', label: 'Agent dopisał images.domains do next.config.ts (bez commita)' },
{ id: 'weakTest', label: 'Agent osłabił test formatTime i zrobił commit' },
{ id: 'publicKey', label: 'Agent użył NEXT_PUBLIC_STATS_KEY dla klucza' },
{ id: 'envFile', label: 'Agent dodał .env.local do Gita' },
{ id: 'untested', label: 'Błąd w ścieżce, której nie sprawdza żaden test' },
];
const CAPTAIN = [
'/code-review i /security-review: decyzja, które uwagi przyjmuję',
'/verify po ostatniej zmianie',
'Fragment każdego klucza szukany w .next/static: zero trafień',
'Podgląd z /deploy sprawdzony w przeglądarce',
'Promocja na produkcję ręcznie, w panelu Vercela',
'Plan odwrotu: wiem, które wdrożenie przywróci Instant Rollback',
];
// Siedem punktów, które Claude sprawdza komendami; wynik zależy od stanu projektu
function claudeChecks(m) {
return [
{ point: 'Testy, lint, typy, build', command: 'komendy z CLAUDE.md', pass: true, note: 'Tests 23 passed (23)' },
{ point: 'Czysty git status', command: 'git status --short', pass: !m.domains, note: m.domains ? 'M next.config.ts' : 'pusto' },
{ point: 'Pliki .env w Gicie', command: "git ls-files | grep -E '(^|/)\\.env'", pass: !m.envFile, note: m.envFile ? '.env.example, .env.local' : '.env.example' },
{
point: 'Nazwy zmiennych w .env.example',
command: "grep -rhoE 'process\\.env\\.[A-Z0-9_]+' app components lib",
pass: !m.publicKey,
note: m.publicKey ? 'NEXT_PUBLIC_STATS_KEY: brak w .env.example, klucz z NEXT_PUBLIC_' : 'NEXT_PUBLIC_AUDIO_BASE_URL',
},
{ point: 'Reguły deny i ask', command: 'cat .claude/settings.json', pass: true, note: 'deny .env, ask vercel i git push' },
{ point: 'Bez images.domains', command: 'grep -n domains next.config.ts', pass: !m.domains, note: m.domains ? '5: domains: ["picsum.photos"],' : 'brak trafień' },
{
point: 'Zmienione pliki testów do przeczytania',
command: "git log --oneline --stat -5 -- '*.test.ts' '*.test.tsx'",
pass: true,
note: m.weakTest ? 'lib/format.test.ts zmieniony: przeczytaj diff!' : 'components/Queue.test.tsx (test kolejki z 10_4)',
},
];
}
export default function App() {
const [mistakes, setMistakes] = useState({});
const [report, setReport] = useState(null);
const [captain, setCaptain] = useState(CAPTAIN.map(() => false));
function toggleMistake(id, on) {
setMistakes((m) => ({ ...m, [id]: on }));
setReport(null);
}
function runChecklist() {
setReport(claudeChecks(mistakes));
}
const claudeOk = report && report.every((r) => r.pass);
const captainOk = captain.every(Boolean);
return (
<div className="min-h-screen bg-gray-950 p-4 text-white">
<div className="mx-auto max-w-xl space-y-4">
<h1 className="text-lg font-semibold">/przed-publikacja</h1>
<div className="space-y-1 rounded-xl bg-gray-900 p-3 text-sm">
<p className="text-gray-400">Błędy agenta do włączenia</p>
{MISTAKES.map((m) => (
<label key={m.id} className="flex items-center gap-2">
<input type="checkbox" checked={Boolean(mistakes[m.id])} onChange={(e) => toggleMistake(m.id, e.target.checked)} />
{m.label}
</label>
))}
</div>
<button type="button" onClick={runChecklist} className="rounded-full bg-white px-4 py-2 font-semibold text-black">
Uruchom /przed-publikacja
</button>
{report && (
<div className="overflow-x-auto rounded-xl bg-black p-3 text-xs">
<table className="w-full text-left">
<thead className="text-gray-400">
<tr><th className="pr-2">Punkt</th><th className="pr-2">Komenda</th><th className="pr-2">Wynik</th><th>Ocena</th></tr>
</thead>
<tbody>
{report.map((r) => (
<tr key={r.point} className="align-top">
<td className="pr-2">{r.point}</td>
<td className="pr-2 font-mono text-gray-400">{r.command}</td>
<td className="pr-2">{r.note}</td>
<td className={r.pass ? 'text-green-400' : 'text-red-400'}>{r.pass ? 'ZALICZONE' : 'NIE ZALICZONE'}</td>
</tr>
))}
</tbody>
</table>
</div>
)}
<div className="space-y-1 rounded-xl bg-gray-900 p-3 text-sm">
<p className="text-gray-400">Sprawdza kapitan</p>
{CAPTAIN.map((item, i) => (
<label key={item} className="flex items-center gap-2">
<input
type="checkbox"
checked={captain[i]}
onChange={(e) => setCaptain((list) => list.map((v, j) => (j === i ? e.target.checked : v)))}
/>
{item}
</label>
))}
</div>
{report && !claudeOk && (
<p className="rounded-xl bg-red-900 p-3 text-sm">Rejs wstrzymany: wybierz jeden punkt NIE ZALICZONE i wydaj wąskie polecenie.</p>
)}
{report && claudeOk && mistakes.weakTest && (
<p className="rounded-xl bg-amber-900 p-3 text-sm">Wszystko zielone, ale punkt 7 wskazuje zmieniony test. Zielony raport to nie dowód, dopóki nie przeczytasz diffu.</p>
)}
{report && claudeOk && mistakes.untested && (
<p className="rounded-xl bg-amber-900 p-3 text-sm">Lista tego nie widzi: błąd w ścieżce bez testu wyjdzie dopiero na podglądzie w przeglądarce albo u załogi. Dlatego masz plan odwrotu.</p>
)}
{report && claudeOk && captainOk && (
<p className="rounded-xl bg-green-900 p-3 text-sm">Można uruchomić /deploy, a po sprawdzeniu podglądu promować go ręcznie.</p>
)}
</div>
</div>
);
}Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Projekt ma testy, lint i build. Którą linię dobre praktyki Claude Code nazywają najcenniejszą w CLAUDE.md?
2. Claude melduje zielone testy, a Source Control pokazuje zmianę w lib/format.test.ts, o którą nie prosiłeś. Co robisz?
To 2 z 7 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w pionie
Uporządkuj kroki pracy z nowym testem zachowania:
- Układanie w pionie
Uporządkuj rejs od listy kontrolnej do produkcji:
Zadania po tej lekcji
- PytanieNajcenniejsza linia CLAUDE.md
- PytanieTest zmieniony w diffie
- Ułóż w kolejnościPętla nowego testu
- PytanieCo robi /goal
- PytaniePo co /verify
- Ułóż w kolejnościKolejność przed publikacją
- Pytaniedisable-model-invocation w /deploy
- PytanieWdrożenie produkcyjne w trybie auto
- PytanieCzego lista nie złapie
- Projekt do wysłaniaWyślij Sea Shanty Sounds do mentora
- WideoPodsumowanie modułu