Grill Me i Grill With Docs: dogadaj się z agentem, zanim zaczniesz budować

Najdroższa porażka w kodowaniu wspieranym przez AI to nie błąd — to zbudowanie dobrze niewłaściwej rzeczy. Opisujesz funkcję w dwóch zdaniach, agent kiwa głową, pisze trzysta linii, a dopiero gdy czytasz diff, orientujesz się, że zrozumiał coś innego, niż miałeś na myśli. Pragmatyczny programista ujął przyczynę dosadnie dekady temu: „nikt nie wie dokładnie, czego chce”. Wymagania jeszcze nie istnieją w formie, którą da się komuś przekazać — trzeba je odkryć w rozmowie.

/grill-me i /grill-with-docs to dwa skille-polecenia z paczki mattpocock/skills Matta Pococka, które wymuszają tę rozmowę. Zamiast tego, żebyś ty przepytywał agenta, to agent przepytuje ciebie — bezlitośnie, po jednym pytaniu naraz — aż każda gałąź drzewa decyzyjnego zostanie rozstrzygnięta. To konsekwentnie jego najczęściej instalowane skille, bo naprawiają najczęstszy tryb porażki, zanim padnie choć jedna linia kodu.

Notatka

Oba to skille wywoływane przez użytkownika (uruchamiasz je po nazwie; agent nie odpali ich sam) i oba opakowują jedną wspólną pętlę grilling. To zwykłe Agent Skills, więc te same polecenia instalacji i komendy działają w Claude Code, Cursorze i Codeksie. Z repozytorium mattpocock/skills (na licencji MIT) autorstwa Matta Pococka.

Co wyniesiesz z tego rozdziału

• Dlaczego „grillujący” wywiad bije pozwolenie agentowi na przeskoczenie wprost do planu
• Dokładny mechanizm, który uruchamia skill — i jak wycisnąć z sesji najwięcej
• Kiedy sięgnąć po /grill-me, a kiedy po /grill-with-docs
• Jak /grill-with-docs buduje język wszechobecny (CONTEXT.md) i ADR-y jako efekt uboczny
• Jak grillowanie i tryb planowania się komponują — najpierw uzgodnij, potem bramkuj wykonanie

Co właściwie robi sesja grillowania

Wywołaj /grill-me (albo /grill-with-docs) z surowym pomysłem — od w pełni dopracowanej specyfikacji po mgliste przeczucie — a agent zaczyna go przepytywać. Instrukcja stojąca za skillem jest krótka i warto przeczytać ją w całości:

Przepytuj mnie bezlitośnie o każdy aspekt tego planu, aż osiągniemy wspólne rozumienie. Schodź po każdej gałęzi drzewa projektu, rozstrzygając zależności między decyzjami jedna po drugiej. Do każdego pytania podaj swoją rekomendowaną odpowiedź. Zadawaj pytania po jednym naraz, czekając na odpowiedź na każde, zanim przejdziesz dalej. Zadawanie wielu pytań naraz jest dezorientujące. Jeśli na pytanie można odpowiedzieć, badając kod, zbadaj kod zamiast pytać.

Działa dzięki trzem rzeczom:

• Jedno pytanie naraz. Ściana dziesięciu pytań paraliżuje; pojedyncze celne pytanie, na które naprawdę umiesz odpowiedzieć, podtrzymuje tempo. Odpowiadasz, ono zadaje kolejne.
• Rekomendowana odpowiedź przy każdym pytaniu. To nie jest puste przesłuchanie — agent proponuje, co by zrobił i dlaczego, więc reagujesz na konkretną sugestię, a nie generujesz wszystko od zera. Często po prostu mówisz „tak”.
• Rozstrzyga zależności po kolei. Decyzje są obchodzone gałąź po gałęzi, więc wczesne odpowiedzi kształtują późniejsze pytania, zamiast wszystkiego naraz.

Zanim pojawiło się AI, programiści nazywali to rubber duckingiem — przegadywaniem pomysłu, aż znajdzie się każdą permutację. Realna sesja trwa długo (często ~45 minut dla porządnej funkcji), a efektem jest bogate, wspólne rozumienie: twoja faktyczna intencja, przypadki brzegowe, o których nie pomyślałeś, i odpowiedzi na trudne pytania — wszystko, zanim agent cokolwiek napisze.

/grill-me kontra /grill-with-docs

Ten sam wywiad, dwa zastosowania:

• /grill-me — uniwersalny test pod ciśnieniem. Użyj, gdy nie ma kodu w grze: planowanie programu nauczania, przemyślenie decyzji, a nawet pisanie mowy pogrzebowej. To czyste narzędzie do myślenia.
• /grill-with-docs — wersja inżynierska. Użyj, gdy masz kod. Uruchamia identyczną pętlę grillowania, ale dokłada modelowanie dziedziny: osadza pytania w twoim faktycznym kodzie i pisze dokumentację po drodze.

Reguła kciuka jest prosta: kod → /grill-with-docs; brak kodu → /grill-me.

Instalacja

npx skills@latest add mattpocock/skills

1. Uruchom instalator, potem wybierz skille, których chcesz (grill-me, grill-with-docs) i agentów, na których je zainstalować.

2. Dla /grill-with-docs wybierz też setup-matt-pocock-skills i uruchom /setup-matt-pocock-skills raz na repo — zapyta, gdzie trzymać dokumenty, które tworzy skill (glosariusz i ADR-y).

3. Zacznij sesję, wpisując polecenie, np. /grill-with-docs chcę dodać subskrypcje do modułu rozliczeń.

Wskazówka

W Claude Code nazwa skilla jest poleceniem ze slashem, więc /grill-me działa od razu po instalacji. W Cursorze i Codeksie wywołujesz je tak samo przez interfejs Agent Skills.

Co dodaje /grill-with-docs: język wszechobecny

Drugi tryb porażki, który celują te skille, to gadatliwość. Wrzuć agenta do projektu, a musi zgadywać żargon, więc używa dwudziestu słów tam, gdzie wystarczyłoby jedno. Lekarstwem, prosto z Domain-Driven Design Erica Evansa, jest język wszechobecny (ubiquitous language): jeden wspólny glosariusz, z którego czerpią programiści, eksperci dziedzinowi i kod. /grill-with-docs buduje go za ciebie, w locie, podczas wywiadu:

• Konfrontuje twoje terminy z glosariuszem. „Twój glosariusz definiuje »anulowanie« jako X, ale wygląda, że masz na myśli Y — które to?”
• Wyostrza mgliste słownictwo. „Mówisz »konto« — masz na myśli Klienta czy Użytkownika? To różne rzeczy.”
• Konfrontuje z kodem. Jeśli to, co mówisz, przeczy temu, co robi kod, wydobywa konflikt zamiast go zamiatać pod dywan.
• Zapisuje to, gdy terminy krystalizują się w głównym CONTEXT.md (albo CONTEXT-MAP.md dla monorepo z wieloma kontekstami).

Zysk kumuluje się sesja po sesji. Gdy „kaskada, w której lekcja dostaje realne miejsce w systemie plików” ma już nazwę, mówisz „kaskada materializacji” — i tak samo mówi kod. Zmienne, funkcje i pliki są nazywane spójnie, agent szybciej porusza się po repo i wydaje mniej tokenów na myślenie, bo język jest zwięźlejszy.

Uwaga

CONTEXT.md to glosariusz i nic więcej — definicje tego, czym terminy są, a nie jak cokolwiek jest zaimplementowane. Nie pozwól, by zsunął się do roli specyfikacji albo brudnopisu.

Oferuje też rekordy decyzji architektonicznych (ADR-y) — jednoakapitowe notatki w docs/adr/ — ale oszczędnie. Proponuje ADR tylko wtedy, gdy spełnione są wszystkie trzy warunki: decyzja jest trudna do odwrócenia, zaskakująca bez kontekstu (przyszły czytelnik pomyśli „czemu, u licha, zrobili to tak?”) i jest wynikiem prawdziwego kompromisu. Jeśli brakuje choć jednego, nie ma czego zapisywać.

Jak to współgra z trybem planowania

Grillowanie i tryb planowania rozwiązują sąsiednie problemy i ładnie się komponują. Sesja grillowania bramkuje twoje rozumienie — nie pozwoli ruszyć dalej, dopóki każda gałąź drzewa decyzyjnego nie zostanie rozstrzygnięta. Tryb planowania bramkuje twoje wykonanie — agent bada kod w piaskownicy tylko do odczytu i pisze plan, który zatwierdzasz, zanim wyląduje jakakolwiek edycja.

Pułapką jest sięganie najpierw po tryb planowania. Claude Code z radością wyprodukuje pewny siebie, ładnie sformatowany plan, zanim ty i on faktycznie zgodzicie się co do tego, co budujecie — a plan zbudowany na nieporozumieniu tylko nadaje złemu kierunkowi oficjalny wygląd. Najpierw grilluj:

1. /grill-with-docs, by wydobyć i rozstrzygnąć niejasności (i uchwycić słownictwo w CONTEXT.md).
2. /plan, by zamienić to wspólne rozumienie w bramkowany plan plik-po-pliku.
3. Wykonaj — teraz plan jest wart zatwierdzenia, bo myślenie za nim jest solidne.

Grillowanie jest tym, co czyni plan trybu planowania godnym zaufania. Bez niego często tylko przyklepujesz dopracowane zgadywanie.

Kiedy po nie sięgnąć

• Rozpoczynasz funkcję, której wymagania wciąż są mgliste nawet w twojej głowie.
• Pracujesz w nieznanej dziedzinie, gdzie terminologia nie jest jeszcze ustalona.
• Testujesz pod ciśnieniem projekt, który uważasz za skończony — by znaleźć przypadki brzegowe, zanim zrobi to agent.
• Każda decyzja wysokiej stawki, w kodzie czy nie, gdzie przegadanie bije decydowanie w pojedynkę.

Co dalej

Tryb planowania Bramka wykonania, która łączy się z grillowaniem: zbadaj w piaskownicy, zatwierdź plan, potem pozwól mu działać.

Domain-Driven Design Dyscyplina stojąca za /grill-with-docs -- język wszechobecny, konteksty ograniczone i modelowanie dziedziny.

shadcn/improve Audytuj najlepszym modelem, wykonuj tanim -- odpowiednik grillowania nastawiony na jakość architektury.

Instalowanie i zarządzanie skills Jak działa npx skills add i jak utrzymywać skills aktualne w różnych narzędziach.