Lekcja 14 · Faza 2 · Krok 2 z 6

Grillowanie planu: grilling, grill-me, grill-with-docs

Autor pakietu wprost stawia to jako drugi krok, zaraz po setupie: zanim padnie choć jedna linijka kodu, przegoń plan przez "relentless interview" — serię pytań, które wymuszają precyzję tam, gdzie normalnie zostałaby niedopowiedziana. To adresuje pierwszy z czterech trybów porażki z README pakietu: misalignment — agent nie zrozumiał wymagań.

Polecane źródło Lokalne pliki .agents/skills/{grilling,grill-me,grill-with-docs,domain-modeling}/SKILL.md — cała treść poniżej pochodzi wprost z nich.

Jedna mechanika, trzy nazwy

SkillCo robiKto wywołuje
grillingsam wywiad — pytanie po pytaniu, z rekomendowaną odpowiedzią Claude przy każdymTy, albo Claude samo, gdy wyczuje frazę-wyzwalacz albo plan wymagający testu
grill-metylko uruchamia sesję grillingwyłącznie Ty, ręcznie — disable-model-invocation: true
grill-with-docsuruchamia grilling razem z domain-modelingwyłącznie Ty, ręcznie

To nie trzy różne wywiady — to jeden mechanizm (grilling), plus dwie ręczne furtki do niego, z których jedna dokłada dyscyplinę domenową. Dokładnie ta kompozycyjność, o której mówi README pakietu: małe, składalne skille zamiast jednego wielkiego.

Same zasady wywiadu (treść skilla grilling)

"Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. Ask the questions one at a time, waiting for feedback on each question before continuing. If a question can be answered by exploring the codebase, explore the codebase instead."

Trzy zasady warte zapamiętania: jedno pytanie naraz (nie zalewa Cię listą), zawsze z rekomendacją (nie zostawia Cię samego z pustym pytaniem), i eksploracja zamiast pytania, gdy odpowiedź da się znaleźć w kodzie zamiast w Twojej głowie.

Kluczowy wniosek: grill-with-docs nie jest osobnym, "lepszym" wywiadem — to dokładnie ten sam grilling, uruchomiony razem z domain-modeling (Lekcja 13 wspominała ten skill przy trzeciej decyzji setupu). Różnica: przy każdym rozstrzygniętym terminie CONTEXT.md aktualizuje się na żywo, a ADR-y powstają w trakcie, nie po fakcie.

ADR-y powstają rzadko, celowo

domain-modeling oferuje ADR tylko, gdy wszystkie trzy warunki są spełnione naraz:

  1. Trudno to odwrócić później
  2. Bez kontekstu przyszły czytelnik się zdziwi — "dlaczego tak to zrobili?"
  3. To wynik realnego kompromisu — były prawdziwe alternatywy, wybrano jedną z konkretnego powodu

Brak choćby jednego — ADR się nie tworzy. To celowa ochrona przed zaśmiecaniem docs/adr/ decyzjami, które nikogo w przyszłości nie zdziwią.

Zadanie praktyczne — zgrilluj prawdziwy plan

W swoim prawdziwym projekcie (po uruchomionym setup-matt-pocock-skills z Lekcji 13), weź plan na najbliższą, jeszcze nierozpoczętą funkcję i wpisz /grill-with-docs:

  1. Obserwuj: czy pytania faktycznie przychodzą pojedynczo? Czy każde ma rekomendowaną odpowiedź?
  2. Jeśli w repo już jest CONTEXT.md — sprawdź po sesji, czy faktycznie zaktualizował się w trakcie, a nie dopiero na końcu.
  3. Zwróć uwagę, czy w ogóle zaproponowano ADR. Jeśli tak — sprawdź, czy potrafisz wskazać, które z trzech warunków go uzasadniły.

Sprawdź się

1. Czym różni się grill-with-docs od grill-me pod względem samego mechanizmu pytań?

Oba uruchamiają dokładnie ten sam skill grilling. Różnica leży w tym, co działa obok — grill-with-docs dokłada domain-modeling, które aktualizuje CONTEXT.md i oferuje ADR-y na żywo.

2. Dlaczego grilling (w przeciwieństwie do grill-me) NIE ma disable-model-invocation: true?

Opis grilling wprost mówi: "Use when the user wants to stress-test a plan, or uses any grill trigger phrases" — czyli Claude może sam zdecydować się na ten skill, bez ręcznej komendy.

3. Wywiad ma zadać pytanie, na które odpowiedź istnieje wprost w kodzie repo. Co powinno się stać zgodnie z treścią skilla grilling?

Treść skilla wprost: "If a question can be answered by exploring the codebase, explore the codebase instead" — eksploracja ma pierwszeństwo przed obciążaniem Ciebie pytaniem, na które kod już odpowiada.

4. Grillujecie decyzję, która jest łatwa do odwrócenia i nie wynika z żadnego realnego kompromisu. Co zrobi domain-modeling?

ADR wymaga spełnienia wszystkich trzech warunków naraz: trudno odwrócić, zaskakujące bez kontekstu, wynik realnego kompromisu. Brak choćby jednego — ADR się nie tworzy.

5. Czym CONTEXT.md różni się od specyfikacji czy notatnika implementacyjnego, według domain-modeling?

Skill wprost zabrania traktowania CONTEXT.md jako specyfikacji, notatnika czy repozytorium decyzji implementacyjnych — ma być wyłącznie glosariuszem terminów domenowych.
Coś niejasne? Zapytaj mnie wprost — mogę pomóc rozstrzygnąć, czy konkretna decyzja z Twojego prawdziwego grillowania kwalifikuje się na ADR.
← Lekcja 13: Setup Następna lekcja: to-issues — rozbicie planu na zadania →