# Grill With Docs

> Resolve open requirements, assumptions or design choices against the repository's domain model, recording agreed terms and qualifying decisions. Use for coherent design clarification; use `to-spec` to capture a settled plan and `wayfinder` for dependent decisions needing a persistent map.

- Skill: `navikt/grill-with-docs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add navikt/grill-with-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/navikt/grill-with-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: navikt (https://skillmd.com/u/navikt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/navikt/grill-with-docs

---


# Grill with Docs

Load `grilling` and `domain-modeling` through the active skill catalog and the
runtime's native loading mechanism. Combine the shared interview method with
the repository's vocabulary and decision history. Start automatically when a
request needs coherent design clarification; the user need not name this skill
or separately select a documentation mode.

Inspect the relevant domain documents and implementation before asking. Test
the proposal against established terms, boundaries, invariants, and concrete
edge cases. Ask one material question at a time, recommend an answer with its
consequence, and wait for the user's choice before dependent work.

As terms and decisions are resolved, apply `domain-modeling` within the user's
authorized scope and the repository's language, paths, and formats. Write only
what qualifies: a conversation can complete without creating a glossary entry
or an ADR. Never turn an unchosen recommendation into a documented decision.
Honor explicit discussion-only or read-only requests.

If the work exposes several dependent decisions that need a durable shared map
across sessions, use `wayfinder` to organize them and continue this method for
the active decision. Implementation size alone does not justify a map. When
the direction is settled, summarize it and continue the authorized delivery
workflow without an extra skill-selection or confirmation step.