02 Grill me, Grill with docs und Wayfinder

Die folgenden Skills stammen aus Matt Pococks Skill-Sammlung. Sie helfen, Anforderungen zu klären und größere Vorhaben zu planen. Hier beschreiben wir ihre Abläufe; die Skills werden nicht mitinstalliert.

Skill	Wann einsetzen?	Ergebnis
`grill-me`	Eine Idee hat offene Entscheidungen oder unklare Annahmen.	Ein gemeinsam geklärter Plan.
`grill-with-docs`	Die Klärung soll im Repo nachvollziehbar bleiben.	Zusätzlich ein Glossar und bei relevanten Abwägungen ADRs.
`wayfinder`	Die Planung ist größer als eine Agent-Session.	Eine verlinkte Karte aus Entscheidungs-Issues.

Grill me¶

Ein hartnäckiges Interview, das einen Plan oder Entwurf schärft. Der Agent hinterfragt Annahmen und stellt die gerade beantwortbaren Fragen mit Empfehlungen. Deine Antworten öffnen die nächste Fragerunde. Fakten recherchiert er selbst; Entscheidungen triffst du. Umsetzung beginnt nach gemeinsam bestätigter Klärung.

Nutze grill-me: Welchen Projektkontext brauchen wir,
damit Joko mit AI verlässlich entwickeln kann?

Grill with docs¶

Der tatsächliche Skill heißt grill-with-docs, nicht grill-me-with-docs. Er ergänzt das Interview um Domain Modeling: geklärte Begriffe kommen ins GLOSSARY.md; schwer umkehrbare, erklärungsbedürftige Abwägungen in docs/adr/. Dateien entstehen erst, wenn es etwas festzuhalten gibt.

Das Diagramm zeigt den Klärungsablauf und seine Dokumentation.

%%{init: {"look":"handDrawn","theme":"neutral","themeVariables":{"fontFamily":"Excalifont, Virgil, Chalkboard SE, Comic Neue, cursive","fontSize":"14px"}}}%%
flowchart LR
    accTitle: Klärung mit Grill with docs
    accDescr: Fragen und menschliche Antworten führen zum geklärten Plan; Begriffe und Entscheidungen werden dokumentiert.
    Q("Fragen<br/>Agent") ==> A("Antworten<br/>Mensch") ==> P("Plan<br/>Gemeinsam geklärt")
    A -.-> D("Glossar und ADRs<br/>Bei Bedarf")
    class Q,P service
    class A ingress
    class D storage
    classDef ingress fill:#eff6ff,stroke:#2563eb,stroke-width:1.5px,color:#0f172a
    classDef service fill:#f0fdf4,stroke:#15803d,stroke-width:1.5px,color:#0f172a
    classDef storage fill:#f1f5f9,stroke:#64748b,stroke-width:1.5px,color:#0f172a
    classDef external fill:#fef3c7,stroke:#b45309,stroke-width:1.5px,color:#0f172a
    classDef boundary fill:none,stroke:#cbd5e1,stroke-width:1px,color:#475569

Wayfinder¶

Zuerst das Ziel klären, dann eine Map und konkrete Entscheidungs-Issues im Tracker anlegen. Abhängigkeiten zeigen, was als Nächstes geklärt werden kann. Noch unscharfe Fragen bleiben auf der Map sichtbar. Jede Entscheidung wird im zugehörigen Issue dokumentiert und von der Map verlinkt.

Wayfinder plant standardmäßig. Pro Session wird höchstens ein Entscheidungs-Issue gelöst; Recherche-Issues sind die Ausnahme. Für eine kleine, bereits klare Aufgabe reicht ein normales Issue.

Nutze wayfinder, um unseren vierwöchigen Pilot zu planen.
Ziel: einen belastbaren Vergleich mit dem bisherigen Delivery-Modell vorbereiten.

Welche Skills und Zugriffe hängen daran?¶

Einstieg	Benötigte Skills und Ressourcen
grill-me	Ruft grilling auf. Faktenrecherche kann an einen Agent mit frischem Kontext gehen.
grill-with-docs	Nutzt `grilling` und domain-modeling; braucht Schreibzugriff auf Glossar und ADRs.
wayfinder	Nutzt `grilling` und `domain-modeling`; je Ticket außerdem research oder prototype. Braucht einen beschreibbaren Tracker für Map, Tickets und Abhängigkeiten.

Für grill-with-docs ist kein Issue-Tracker zwingend. Wayfinder unterstützt auch einen lokalen Markdown-Tracker; hier verwenden wir GitHub Issues. Ein separater Skill namens issue-tracker ist keine allgemeine Voraussetzung. Beim Installieren die benötigten Begleit-Skills mitnehmen.

Lokale Anpassungen: Die Codex-Fassungen verwenden Skill-Verweise statt Claudes Skill-Tool. Wayfinder liest den Tracker aus workspace.toml und nennt die optionalen Begleiter mattpocock-research und mattpocock-prototype. Den lokalen Grill-Einstiegen fehlt eine explizite Codex-Policy für ausschließlich manuelle Aufrufe; Matt sperrt die automatische Auswahl in seinen Claude-Einstiegen. Die lokale Fassung ist deshalb keine unveränderte Kopie. Quellenvergleich: 3. November 2026.

Deepen¶

Felix Riesebergs (Anthropic) Depth-Prompt ersetzt bloß professionell klingende Antworten durch vier Fragen nach Profivorgehen, Rohmaterial, konkreten Methoden und unabhängigen Nachweisen, damit die Aufgabe fachlich tiefer wird.

Unser deepen-prompt-Skill berichtet aber: Agents beantworteten die vier Fragen gut und vergrößerten danach trotzdem den Auftrag. Seine Kernaussage:

The job is selection, proportion, grounding, and shape.

Deshalb priorisiert der Skill wenige entscheidende Verbesserungen, liest tatsächliches Rohmaterial, begrenzt den Umfang und verlangt einen konkreten externen Check. Aus einer Funktion soll keine ganze Pipeline werden. Das ist eine im Skill dokumentierte Beobachtung, kein hier reproduzierter Benchmark.

Weiter: Kontext und vertikale Slices.