Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Planowanie

grill-with-docs

/grill-with-docs

Testuje plan względem istniejącego języka kodu i decyzji, czyli aktualnej dokumentacji, słownika pojęć i ADR, zanim zacznie się implementacja.

Licencja
MIT
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Testuje plan względem istniejącego języka kodu i decyzji, czyli aktualnej dokumentacji, słownika pojęć i ADR, zanim zacznie się implementacja.

Oryginalny opis (EN)

Use when a plan must be stress-tested against the codebase's existing language and decisions — grill it against current docs, glossary terms, and ADRs before implementation begins

Jak działa

  1. When to Use
  2. When NOT to Use
  3. Workflow
  4. Output Template
  5. Common Rationalizations
  6. Red Flags
  7. Verification
  8. See Also
Sekcje z nagłówków SKILL.md, w oryginale · 121 linii, 676 słów
Podgląd SKILL.md
---
name: grill-with-docs
description: Use when a plan must be stress-tested against the codebase's existing language and decisions — grill it against current docs, glossary terms, and ADRs before implementation begins
metadata:
  category: workflow
  agent_type: general-purpose
  origin: adapted from mattpocock/skills grill-with-docs
---

# Grill With Docs

Grill With Docs is a documentation-grounded grilling session. It does the same branch-by-branch
interrogation as `grill-me`, but every challenge is anchored in the project's current language,
design records, and observable implementation.

## When to Use

- A plan must align with existing docs, glossary terms, ADRs, or architecture notes
- The same concept is described differently across code, docs, and the current proposal
- You need to challenge a plan without drifting away from the repo's existing vocabulary
- A durable decision may need to be recorded while the conversation is still active

## When NOT to Use

| Instead of grill-with-docs | Use |
|----------------------------|-----|
| You only need plan interrogation, not documentation grounding | `grill-me` |
| You are writing or updating docs after implementation changed | `doc-update` |
| You need a broad codebase walkthrough or onboarding tour | `code-tour` |

## Workflow

### 1. Gather the current sources of truth

Before questioning the plan, inspect the best available durable references:

- root docs such as `README.md` or architecture notes
- glossary or context files if they exist
- ADRs or decision logs
- the current code path if the docs are stale or incomplete

If the repo does not maintain dedicated glossary or ADR files, use the nearest durable project docs
instead of inventing new ceremony.

### 2. Challenge the plan against documented language

When the plan uses a term that conflicts with current project language, call it out directly.

Examples:

- "The docs call this a workspace, but the plan says project. Which term is canonical?"
- "The ADR says we prefer thin adapters here. Why does this proposal add a new orchestration layer?"

### 3. Use one question at a time

Like `grill-me`, walk the tree branch by branch. Each question should either:

- confirm the plan fits the existing docs
- expose a contradiction
- force a new durable decision

### 4. Check code when the docs and proposal disagree

If the docs say one thing and the current code does another, surface the mismatch instead of assuming
the docs win automatically.

```markdown
**Documented:** feature flags gate this flow.
**Observed in code:** the path is unconditional in production.
**Question:** Which source should the new plan follow?
```

### 5. Record only durable decisions

If the session produces a decision worth preserving, update the relevant docs during the session.
Only create or propose an ADR when all three are true:

1. it is hard to reverse
2. it would be surprising without context
3. it resulted from a real tradeoff

If one of those is missing, leave it out of the ADR layer.

## Output Template

```markdown
## Doc-Grounded Grill Summary

### Confirmed by Existing Docs
- ...

### Conflicts Found
- ...

### Decisions Made
- ...

### Docs To Update
- ...
```

## Common Rationalizations

| Rationalization | Reality |
|----------------|---------|
| "The docs are probably stale, so ignore them." | Maybe — but you still need to surface the contradiction explicitly. |
| "We'll rename the terms later." | Vocabulary drift makes design reviews and follow-up work harder immediately. |
| "Let's write an ADR for everything." | ADRs are for durable, surprising, hard-to-reverse tradeoffs, not routine notes. |

## Red Flags

- The plan uses new terminology without checking whether the repo already has a term
- Code, docs, and proposal disagree, but the session never resolves which one is authoritative
- ADRs are proposed for obvious or low-cost decisions
- The grilling session turns into doc rewriting before the core plan is settled

## Verification

- [ ] The plan was checked against current docs or code, not memory alone
- [ ] Terminology conflicts were surfaced explicitly
- [ ] Questions were asked one at a time
- [ ] Only durable decisions were promoted into doc updates or ADR candidates

## See Also

- [`grill-me`](../grill-me/SKILL.md) — one-question-at-a-time grilling without the doc-grounding requirement
- [`doc-update`](../../documentation/doc-update/SKILL.md) — sync docs after implementation changes
- [`architecture-decisions`](../../documentation/architecture-decisions/SKILL.md) — capture hard-to-reverse technical decisions deliberately

Wersje

RepozytoriumWynikLicencja
Ta strona · drvoss/everything-copilot-cli100MIT
kriegcloud/beep-effect100Apache-2.0
drosam/agents100MIT
dlebed/rotisserie100MIT
alirezarezvani/claude-skills100MIT
khaledsaeed18/dotclaude100MIT
ayoubben18/ab-method100MIT
lttr/claude-marketplace100MIT
flutter/agent-plugins100BSD-3-Clause

Migawka bazy z 13.11.2026 · wersja paczki dbe519212fe5 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100grilling
    Przepytuje plan lub decyzję i buduje glosariusz projektu oraz ADR w miarę ustalania kolejnych decyzji.
  • 100grill-me
    Testuje plan lub decyzję pytaniami o wybór opcji, a większe decyzje zapisuje jako dokumenty, na przykład ADR i terminy słownika.
  • 90grill
    Dociekliwie przepytuje użytkownika o plan lub decyzję, zanim zacznie się wdrażanie.
  • 100grill-me
    Testuje plan względem modelu domenowego projektu, doprecyzowuje terminologię i na bieżąco aktualizuje dokumentację (CONTEXT.md, ADR) w miarę podejmowania decyzji.
  • 100grill
    Testuje plan, projekt, decyzję lub pomysł przez wywiad, zanim cokolwiek zostanie napisane lub zbudowane, na przykład na polecenie „grill me”.
  • 100grill
    Testuje plan, projekt, decyzję lub pomysł przez wywiad, zanim cokolwiek zostanie napisane lub zbudowane, na przykład na polecenie „grill me”.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.