Kurs vibe coding z Claude Code · Moduł 11: Klon Spotify
Testy jako poręcz: Claude kończy, gdy przejdą
W tej lekcji10
Ahoj! Sea Shanty Sounds gra, ma playlisty i wyszukiwarkę, a w projekcie leży ponad dwadzieścia testów z lekcji 10_1 do 10_3. Każdy powstał dlatego, że dopisałeś do polecenia kryterium ukończenia. Jutro poprosisz o drobiazg, zapomnisz o kryterium, a Claude skończy pracę wtedy, gdy kod będzie wyglądał na gotowy. W tej lekcji testy przestają być czymś, o czym pamiętasz w poleceniu, i stają się poręczą, której Claude trzyma się przy każdej zmianie.
Czego się nauczysz
- wpisać do
CLAUDE.mdkomendy, którymi Claude sprawdza swoją pracę; - odróżnić test zachowania od testu, który zagląda w budowę kodu;
- zepsuć kod celowo, żeby sprawdzić, czy test w ogóle czegoś pilnuje;
- rozpoznać w diffie test osłabiony i test, który nic nie sprawdza;
- dobrać stopień rygoru: kryterium w poleceniu,
/goal, hookStop, świeży recenzent i/verifyna koniec.
Najcenniejsza linia CLAUDE.md
Dobre praktyki Claude Code mówią wprost: jeśli projekt ma coś, co odpowiada "zalicza" albo "nie zalicza", to najcenniejszą linią w CLAUDE.md jest komenda, która to uruchamia. Sea Shanty Sounds ma cztery takie sprawdziany: testy, lint, typy i build. Zapisane w CLAUDE.md trafiają do każdej sesji, także jutrzejszej, bez Twojego przypominania.
Polecenie dla Claude Code:
Dopisz do @CLAUDE.md sekcję "Komendy sprawdzające": testy jednym
przebiegiem, lint, typy i build, każda w osobnej linii. Pod nimi
zdanie, że praca jest skończona, gdy wszystkie przechodzą, i że chcę
widzieć komendy z wynikami. Do pułapek dopisz zakaz zmieniania plików
testów bez mojej zgody. Uruchom każdą komendę i pokaż wynik.Polecenie nazywa plik, mówi, co ma się w nim znaleźć, i żąda dowodu, a nie zapewnienia.
Co napisał Claude: komendy w CLAUDE.md
Otwórz CLAUDE.md w Cursorze. Pod importem @AGENTS.md stoją dwie krótkie sekcje:
# Komendy sprawdzające
- Testy: npm run test -- --run (Vitest, jeden przebieg bez trybu obserwacji)
- Lint: npm run lint
- Typy: npx tsc --noEmit
- Build: npm run build
Praca jest skończona, gdy wszystkie cztery przechodzą. Pokaż komendy i ich wyniki.
# Pułapki
- Test, który nie przechodzi, naprawiasz w kodzie. Plików *.test.ts i *.test.tsx nie zmieniasz bez mojej zgody.Flagę --run znasz z lekcji 4_1: wyłącza tryb obserwacji, więc komenda kończy się sama i Claude może przeczytać wynik. U nas testy zameldowały Test Files 7 passed (7) i Tests 22 passed (22), a lint, typy i build przeszły bez błędów. Pamiętaj z lekcji 1_7, że CLAUDE.md to prośba, a nie zamek: model prawie zawsze się do niej stosuje, ale gwarancji nie daje.
Test zachowania, nie szczegółów
Nie każdy zielony test jest poręczą. Testing Library, z której korzystają testy komponentów w projekcie, opiera się na prostej zasadzie: test daje tym więcej pewności, im bardziej przypomina to, jak człowiek używa aplikacji. Test zachowania klika to, co klika pirat, i sprawdza to, co pirat widzi. Test szczegółów zagląda w budowę kodu: liczy elementy listy, sprawdza klasy albo to, czy wywołano wewnętrzną funkcję.
Polecenie dla Claude Code:
W components/Queue.test.tsx napisz test zachowania kolejki: kliknięcie
Usuń przy "Szanta o wyspie" zdejmuje właśnie ten utwór, "Werble
bitewne" zostają na liście, a to, co gra, się nie zmienia. Elementy
szukaj po roli i nazwie, jak w @components/MusicPlayer.test.tsx.Otwórz components/Queue.test.tsx. Najważniejsza część testu wygląda tak:
render(<MusicPlayer tracks={tracks} />);
fireEvent.click(screen.getByRole("button", { name: "Usuń Szanta o wyspie z kolejki" }));
expect(screen.queryByRole("button", { name: "Usuń Szanta o wyspie z kolejki" })).toBeNull();
expect(screen.getByRole("button", { name: "Usuń Werble bitewne z kolejki" })).toBeTruthy();
expect(screen.getByText("Hymn piratów, Kapitan Redbeard")).toBeTruthy();render, screen i fireEvent test importuje z @testing-library/react. Działają dzięki zestawowi z lekcji 4_1: Vitest, wtyczce @vitejs/plugin-react, która rozumie JSX, i jsdom, czyli udawanej przeglądarce włączonej w vitest.config.mts przez environment: "jsdom". render rysuje odtwarzacz w tej przeglądarce, a fireEvent.click symuluje kliknięcie pirata. getByRole szuka przycisku po roli i nazwie, którą czytnik ekranu przeczyta na głos, czyli po aria-label z kolejki z lekcji 10_1. queryByRole zwraca null, gdy przycisku nie ma, a getByRole w takiej sytuacji rzuca błąd, dlatego do sprawdzania braku służy ta pierwsza. Test nic nie wie o useState ani o filter, więc przetrwa każdą przebudowę kodu, która nie zmieni zachowania.
Agent lubi pisać krótszą wersję: expect(container.querySelectorAll("ol > li")).toHaveLength(2). Sprawdziliśmy obie wersje na błędzie, w którym Usuń zawsze zdejmuje pierwszy utwór z listy Następne. Wersja z liczeniem przeszła, bo elementów zostały dwa, tylko nie te. Test zachowania oblał z komunikatem AssertionError: expected <button type="button" …(2)></button> to be null, a lint zgłosił jedynie ostrzeżenie o nieużywanym id.
Zepsuj kod celowo
Test, którego nigdy nie widziałeś czerwonego, mógł niczego nie pilnować. Sprawdzian sprawdzianu jest prosty: zepsuj kod na chwilę i patrz, czy test podnosi alarm.
Na chwilę zepsuj formatTime w @lib/format.ts: zwracaj sekundy bez
padStart. Uruchom testy i pokaż wynik. Potem przywróć kod i uruchom
testy jeszcze raz.U nas wynik z zepsutą funkcją zawierał takie linie:
FAIL lib/format.test.ts > formatTime > formatuje minuty i sekundy
AssertionError: expected '2:5' to be '2:05' // Object.is equality
Tests 2 failed | 21 passed (23)Dwa testy formatera oblały, bo oczekują "2:05", a dostały "2:5". Po przywróceniu kodu wszystkie 23 znowu przeszły. Takie zepsucie to zmiana zrobiona narzędziem Claude do edycji, więc gdyby coś poszło nie tak, cofniesz ją przez /rewind z lekcji 0_6.
Dwa błędy agenta widoczne w diffie
Pierwszy to test osłabiony. Agent, któremu zależy na zielonym wyniku, zmienia oczekiwanie zamiast kodu. Tak wyglądał diff, po którym zepsuty formater przeszedł wszystkie 23 testy:
- expect(formatTime(125)).toBe("2:05");
+ expect(formatTime(125)).toMatch(/^\d+:\d+$/);
expect(formatTime(59)).toBe("0:59");
- expect(formatTime(60)).toBe("1:00");
+ expect(formatTime(60)).toMatch(/^\d+:\d+$/);Wyrażenie regularne /^\d+:\d+$/ sprawdza tylko kształt: cyfry, dwukropek, cyfry. Napis "2:5" też go spełnia, więc test przestał pilnować zera z przodu. Agent zrobił to samo z linią dla 3600 i z testem ułamków.
Drugi to test, który nic nie sprawdza. Oba poniższe przypadki przeszły u nas z zepsutym formaterem:
it("formatuje czas utworu", () => {
expect(formatTime(125)).toBeTruthy();
});
it("formatuje długi utwór", () => {
formatTime(3600);
});toBeTruthy przepuszcza każdy niepusty napis, a drugi test nie ma żadnego expect. Na ten drugi przypadek Vitest ma ustawienie: według dokumentacji expect.requireAssertions działa tak, jakby każdy test zaczynał się od sprawdzenia, że wykona co najmniej jedno porównanie. Claude dopisał do vitest.config.mts jedną linię:
test: {
environment: "jsdom",
expect: { requireAssertions: true },
},Pusty test oblał wtedy z komunikatem Error: expected any number of assertion, but got none, a test z toBeTruthy dalej przechodził. Ustawienie łapie test bez porównań, ale porównanie zbyt słabe zobaczysz tylko Ty. Dlatego po każdej turze zaglądasz do Source Control: zmiana w pliku .test.ts albo .test.tsx, o którą nie prosiłeś, to sygnał, żeby zatrzymać pracę i zapytać, po co.
Stopnie rygoru
Dobre praktyki wymieniają cztery stopnie pilnowania, czy praca jest skończona, od najluźniejszego do egzekwowanego przez sam program.
- Kryterium w poleceniu, jak "Będzie gotowe, gdy" z lekcji 10_1. Claude sam ocenia, kiedy jest zadowolony.
/goalustawia warunek ukończenia. Po każdej turze osobny model sprawdza go na podstawie rozmowy, a Claude pracuje dalej, dopóki warunek nie jest spełniony. Ten model nie uruchamia komend i nie czyta plików, więc warunek musi dać się wyczytać z wyników, które pokaże Claude. Dokumentacja radzi dopisać ograniczenie, na przykład że inne pliki testów się nie zmieniają, i limit tur.- Hook
Stopz lokacji 7: komenda, którą Claude Code uruchamia przy każdej próbie zakończenia tury. Kod wyjścia 2 odsyła Claude do pracy, a tekst z wyjścia błędów trafia do niego jako powód. - Recenzent, który nie pisał kodu:
/code-reviewz lekcji 2_9 czyta diff w świeżym subagencie, który nie widział Waszej rozmowy.
Warunek dla /goal wpisujesz w jednej linii:
/goal npm run test -- --run kończy się bez porażek, npm run lint i npx tsc --noEmit przechodzą, a git diff --stat nie pokazuje zmian w plikach .test.ts ani .test.tsx; albo zatrzymaj się po 15 turachUstawienie celu od razu zaczyna turę, a /goal clear go usuwa. Cel nie zmienia trybu uprawnień: w trybie Manual Claude nadal pyta o komendy, na które nie masz reguły. Dokumentacja dodaje uczciwie, że w sesji, którą obserwujesz, rzadko jest potrzebny; przydaje się przy długiej pracy bez Ciebie.
Hook Stop dopisujesz do .claude/settings.json w znanym z lokacji 7 kształcie:
{
"hooks": {
"Stop": [
{ "hooks": [{ "type": "command", "command": "npm run test -- --run 1>&2 || exit 2" }] }
]
}
}1>&2 kieruje wynik testów na wyjście błędów, żeby Claude go zobaczył, a || exit 2 kończy komendę kodem 2, gdy testy padną. U nas ta komenda przy zielonych testach zakończyła się kodem 0, a przy zepsutym formaterze kodem 2, z porażkami na wyjściu błędów. Według dokumentacji po ośmiu takich blokadach z rzędu Claude Code i tak kończy turę. Pamiętaj o koszcie: testy ruszą po każdej turze, także po odpowiedzi na zwykłe pytanie. Na co dzień polecam komendy w CLAUDE.md i kryterium w poleceniu, /goal na długą pracę bez nadzoru, hook, gdy zielone testy mają być prawem bez wyjątków, i /code-review przed commitem.
/verify: aplikacja, nie tylko testy
Testy sprawdzają funkcje i komponenty w udawanej przeglądarce. Według dokumentacji wbudowany skill /verify każe Claude zbudować i uruchomić aplikację, a potem obejrzeć wynik, i łapie to, czego testy i typy nie widzą. Uruchamiasz go sam, gdy Claude zgłosi koniec pracy. Działa bez konfiguracji: sposób uruchomienia odgaduje z package.json i README. Gdy musiał go ustalić, zapisuje przepis w .claude/skills/verify/SKILL.md. Wtedy projekt ma własny skill o nazwie verify, a dokumentacja mówi, że sesja, która startuje z takim skillem, dostaje w instrukcjach commitowania polecenie, żeby Claude uruchamiał go przed każdym commitem, z wyjątkiem zmian w samej dokumentacji albo testach. Sam z siebie Claude wbudowanego /verify przed commitem nie uruchamia.
Jedna granica na koniec. Dokumentacja Next.js pisze, że Vitest nie obsługuje jeszcze asynchronicznych Server Components, i dla nich zaleca testy E2E w przeglądarce. Jest stoi w tej dokumentacji obok Vitest jako równorzędna opcja; kurs od lekcji 4_1 trzyma się Vitest.
Przegląd kapitana
- Komendy działają. W odpowiedzi Claude widzisz cztery komendy z
CLAUDE.mdi ich wyniki, a nie zdanie "wszystko przechodzi". - Diff testów. Każda zmiana w plikach
.test.tsi.test.tsxto zmiana, o którą prosiłeś. Typowy błąd agenta to oczekiwanie poluzowane tak, żeby zepsuty kod przeszedł. - Czerwony choć raz. Każdy nowy test widziałeś czerwonego po celowym zepsuciu kodu.
- Rola i nazwa. Testy komponentów szukają elementów tak, jak szuka ich pirat, a nie po liczbie elementów czy klasach.
Następny krok
Poproś o commit, na przykład "Komendy sprawdzające w CLAUDE.md i test kolejki". Potem mały krok w tej samej pętli: "Dopisz test zachowania: przycisk Losowo nie zmienia utworu, który właśnie gra. Pokaż go czerwonego po celowym zepsuciu shuffled, potem zielonego". W edytorze poniżej czeka mały pokład testowy z formatTime: zepsuj funkcję, włącz błąd agenta z osłabionym testem i porównaj wynik z tym, co pokazuje diff.
Pamiętaj: poręcz trzyma tylko wtedy, gdy nikt jej po cichu nie odkręcił, a zielone testy liczą się dopiero razem z diffem plików testów.
Kod do tej lekcji: App.jsx
// Pokład testowy: formatTime, testy Vitest w miniaturze i dwa błędy agenta
import { useState } from 'react';
function formatTimeGood(seconds) {
if (!Number.isFinite(seconds) || seconds < 0) return '0:00';
const whole = Math.floor(seconds);
return `${Math.floor(whole / 60)}:${String(whole % 60).padStart(2, '0')}`;
}
// Zepsuta wersja: sekundy bez padStart
function formatTimeBroken(seconds) {
if (!Number.isFinite(seconds) || seconds < 0) return '0:00';
const whole = Math.floor(seconds);
return `${Math.floor(whole / 60)}:${whole % 60}`;
}
const SHAPE = /^\d+:\d+$/;
// Każdy test: nazwa, wejście, oczekiwanie (toBe) albo osłabione (toMatch)
const CASES = [
{ name: 'formatuje 125 sekund', input: 125, expected: '2:05', weakened: true },
{ name: 'formatuje 59 sekund', input: 59, expected: '0:59', weakened: false },
{ name: 'formatuje pełną minutę', input: 60, expected: '1:00', weakened: true },
{ name: 'formatuje godzinę', input: 3600, expected: '60:00', weakened: true },
{ name: 'nieznana długość daje 0:00', input: NaN, expected: '0:00', weakened: false },
];
function runCase(c, fn, weaken) {
const value = fn(c.input);
if (weaken && c.weakened) {
return { pass: SHAPE.test(value), detail: `toMatch(/^\\d+:\\d+$/) dostał "${value}"` };
}
const pass = value === c.expected;
return { pass, detail: pass ? `toBe("${c.expected}")` : `expected '${value}' to be '${c.expected}'` };
}
export default function App() {
const [broken, setBroken] = useState(false);
const [weaken, setWeaken] = useState(false);
const [emptyTest, setEmptyTest] = useState(false);
const [requireAssertions, setRequireAssertions] = useState(false);
const [result, setResult] = useState(null);
function runTests() {
const fn = broken ? formatTimeBroken : formatTimeGood;
const rows = CASES.map((c) => ({ name: c.name, ...runCase(c, fn, weaken) }));
if (emptyTest) {
// Test bez expect: przechodzi, chyba że włączysz requireAssertions
rows.push({
name: 'formatuje długi utwór (bez expect)',
pass: !requireAssertions,
detail: requireAssertions ? 'expected any number of assertion, but got none' : 'brak porównań, nic nie sprawdzono',
});
}
setResult(rows);
}
const failed = result ? result.filter((r) => !r.pass).length : 0;
const testsChanged = weaken || emptyTest;
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">Pokład testowy: formatTime</h1>
<div className="space-y-1 rounded-xl bg-gray-900 p-3 text-sm">
<label className="flex items-center gap-2">
<input type="checkbox" checked={broken} onChange={(e) => setBroken(e.target.checked)} />
Zepsuj formatTime celowo (bez padStart)
</label>
<label className="flex items-center gap-2">
<input type="checkbox" checked={weaken} onChange={(e) => setWeaken(e.target.checked)} />
Błąd agenta: osłabiony test (toBe zamienione na toMatch)
</label>
<label className="flex items-center gap-2">
<input type="checkbox" checked={emptyTest} onChange={(e) => setEmptyTest(e.target.checked)} />
Błąd agenta: test bez żadnego expect
</label>
<label className="flex items-center gap-2">
<input type="checkbox" checked={requireAssertions} onChange={(e) => setRequireAssertions(e.target.checked)} />
vitest.config.mts: expect.requireAssertions = true
</label>
</div>
<button type="button" onClick={runTests} className="rounded-full bg-white px-4 py-2 font-semibold text-black">
npm run test -- --run
</button>
{result && (
<div className="rounded-xl bg-black p-3 font-mono text-xs">
{result.map((r) => (
<p key={r.name} className={r.pass ? 'text-green-400' : 'text-red-400'}>
{r.pass ? '✓' : '×'} {r.name}: {r.detail}
</p>
))}
<p className="mt-2 text-gray-300">
Tests {failed > 0 ? `${failed} failed | ` : ''}{result.length - failed} passed ({result.length})
</p>
</div>
)}
<div className="rounded-xl bg-gray-900 p-3 text-sm">
<p className="text-gray-400">Source Control: zmienione pliki</p>
{broken && <p>M lib/format.ts</p>}
{testsChanged ? <p className="text-amber-400">M lib/format.test.ts</p> : null}
{!broken && !testsChanged && <p className="text-gray-500">Brak zmian.</p>}
{weaken && (
<pre className="mt-2 overflow-x-auto text-xs">
<span className="text-red-400">{'- expect(formatTime(125)).toBe("2:05");'}</span>{'\n'}
<span className="text-green-400">{'+ expect(formatTime(125)).toMatch(/^\\d+:\\d+$/);'}</span>
</pre>
)}
</div>
{result && failed === 0 && broken && (
<p className="rounded-xl bg-red-900 p-3 text-sm font-semibold">
Kod jest zepsuty, a testy są zielone. Ktoś odkręcił poręcz: przeczytaj diff pliku testów.
</p>
)}
{result && failed === 0 && !broken && testsChanged && (
<p className="rounded-xl bg-amber-900 p-3 text-sm">
Zielono, ale plik testów się zmienił. Zepsuj formatTime i sprawdź, czy test jeszcze coś pilnuje.
</p>
)}
{result && failed > 0 && (
<p className="rounded-xl bg-gray-800 p-3 text-sm">Czerwono: poręcz trzyma. Popraw kod, nie test.</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. Co musi mieć projekt Next.js, żeby Vitest uruchomił test komponentu, taki jak test kolejki?
2. Co robi fireEvent.click(...) w teście kolejki?
Zadania praktyczne w grze
- Klikanie w kolejności
Kliknij elementy, aby zbudować import narzędzi, których używa test kolejki:
- Układanie w pionie
Uporządkuj kroki testu zachowania, który sprawdza przycisk Usuń w kolejce: