# Sharpen Plans and Create Decision Documentation

Unresolved assumptions weaken plans and technical designs. This skill conducts a focused interview and uses domain modeling to produce ADRs and a glossary.

## Install

```bash
npx skillstore add mattpocock/grill-with-docs
```

## Metadata

- Status: approved
- Slug: mattpocock-grill-with-docs
- Skillstore revision: r2
- Version status: missing
- Tree hash: 1b71bfe7c6e6f64c1f73b8194445739cfa64c76d9d13a7505e574166061c53c2
- Author: mattpocock
- GitHub username: mattpocock
- License: MIT
- Repository: https://github.com/mattpocock/skills/tree/main/skills/engineering/grill-with-docs/
- Ref: ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 79
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/mattpocock-grill-with-docs
- Manifest: https://skillstore.pages.dev/api/skills/mattpocock-grill-with-docs/manifest

## Capabilities

- Starts a grilling session for a plan or design.
- Uses the domain-modeling skill during the interview.
- Challenges assumptions through persistent follow-up questions.
- Refines unclear design choices and planning decisions.
- Creates architecture decision records and a glossary during the session.

## Use Cases

- Review a technical proposal: Expose assumptions and unresolved choices before an engineering team commits to implementation.
- Refine a feature plan: Clarify users, workflows, constraints, and terminology before a feature enters delivery.
- Document architecture decisions: Compare alternatives, record tradeoffs, and establish shared domain language for a system design.

## Prompt Templates

### Review a basic plan

```
Use grill-with-docs to interview me about this plan: [plan]. Identify assumptions and create ADRs and a glossary as decisions emerge.
```

### Challenge a feature design

```
Run grill-with-docs on this feature design: [design]. Focus on users, boundaries, failure cases, dependencies, and unresolved decisions.
```

### Resolve architecture alternatives

```
Use grill-with-docs to compare [option A] and [option B] for [system]. Question constraints, document tradeoffs, and record the selected decision.
```

### Stress-test a domain model

```
Run an advanced grill-with-docs session for [domain]. Challenge entities, invariants, workflows, ownership boundaries, failure modes, and terminology. Produce ADRs and a glossary.
```

## Limitations

- Requires the separate grilling and domain-modeling skills to be available.
- Does not implement the resulting plan or design.
- Produces documentation from supplied context, so missing details reduce accuracy.
- Does not replace expert review for security, legal, or compliance decisions.

## Best Practices

- Provide the current plan, constraints, stakeholders, and known uncertainties before starting.
- Answer follow-up questions with concrete evidence and state when information is unknown.
- Review each ADR and glossary term before treating the documentation as final.

## Anti Patterns

- Do not use the session when you only need a quick factual answer.
- Do not hide fixed constraints or decisions that are no longer open.
- Do not accept generated ADRs without checking ownership, consequences, and unresolved risks.

## Security Audit

- Audited at: 2026-07-23T18:54:16.906\+00:00
- Summary: The sole static finding is a false positive because SKILL.md line 7 uses Markdown backticks around slash-command names, not executable shell syntax. The eight-line prompt delegates to two skills and contains no prompt injection or malicious intent.

## Stats

- Views: 91
- Downloads: 61
- Favorites: 0
- Popularity score: 0