---
title: /skill:grill-docs
description: Pi-adapted grilling with inline domain docs maintenance.
---

# /skill:grill-docs

**Status:** pi-adapted.

Runs the same decision interview as `/skill:grill`, and records terminology and important architecture decisions as they crystallise.

## Usage

```text
/skill:grill-docs design the order cancellation flow
```

## Interaction model

Uses pi's `ask_user` tool:

- one question at a time;
- recommended answer first;
- 2–4 realistic options;
- free-form answers enabled.

## May write

- `CONTEXT.md` — domain glossary.
- `docs/adr/NNNN-*.md` — architecture decision records.

Files are created lazily, only when there is something worth recording.

## Related

Use [`/skill:grill`](/yoke/skills/grill/) for a read-only interview.