# Skill /grill-docs

Pi-adapted.

`/skill:grill-docs` runs the same decision interview as `/skill:grill`, but also maintains domain documentation inline as decisions crystallise.

## Usage

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

## Interaction model

The skill uses pi's `ask_user` tool:

- one question at a time;
- 2–4 options per question;
- recommended answer first, labelled `(Recommended)`;
- free-form answer enabled.

## Documentation it may write

- `CONTEXT.md` — domain glossary. Format: [CONTEXT-FORMAT.md](../skills/grill-docs/reference/CONTEXT-FORMAT.md).
- `docs/adr/NNNN-*.md` — architecture decision records. Format: [ADR-FORMAT.md](../skills/grill-docs/reference/ADR-FORMAT.md).

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

## Related

Use `/skill:grill` for a read-only interview without documentation maintenance.