grill-with-docs

Challenge plans against existing domain documentation and terminology.

Updated May 8, 2026
One-click install
npx skills add https://github.com/mmartinsoliv/dotfiles --skill grill-with-docs-mmartinsoliv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/mmartinsoliv/dotfiles/tree/main/agents/skills/grill-with-docs
Command: npx skills add https://github.com/mmartinsoliv/dotfiles --skill grill-with-docs-mmartinsoliv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you pressure-test a plan against existing project language and documented decisions so you can catch ambiguity, contradictions, and hidden trade-offs before implementation.

Core Features & Use Cases

  • Structured interviewing: It asks one question at a time, recommends an answer, and keeps drilling into dependencies until the plan is fully understood.
  • Documentation alignment: It cross-checks the discussion against existing CONTEXT.md files, CONTEXT-MAP.md files, and ADRs to keep terminology and decisions consistent.
  • Inline knowledge capture: It updates context files as terms are resolved and suggests ADRs when decisions are hard to reverse, surprising, and trade-off driven.

Quick Start

Use this Skill to grill my plan against the repository’s documented domain language and update any needed context or ADR notes inline.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my project plan conflicts with existing domain documentation?

You pressure-test a plan by cross-checking it against existing domain documentation like CONTEXT.md files and ADRs to catch terminology contradictions and hidden trade-offs before implementation begins.

What is the best way to align new design decisions with an existing codebase glossary?

Aligning design decisions with a codebase glossary involves structured interviewing that detects terminology conflicts and updates context files inline as terms are resolved during the design discussion.

When should I create an ADR during a design review?

Create an ADR during a design review when a decision is hard to reverse, surprising to the team, and driven by meaningful trade-offs that warrant permanent architectural documentation.

Can I use structured questioning to update CONTEXT.md files automatically during planning?

Yes, you can update CONTEXT.md files during planning by resolving domain terminology conflicts through one-at-a-time questioning, which lazily creates or modifies context files only when justified.

Does this approach work for repository walkthroughs that need live documentation updates?

Yes, this approach works for repository walkthroughs by applying controlled questioning against documented domain language and performing live documentation updates as decisions are finalized.