grill-with-docs

Validate a development plan against domain glossary and documented decisions.

5|Updated Aug 8, 2016
One-click install
npx skills add https://github.com/gbencke/dotfiles --skill grill-with-docs-gbencke
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/gbencke/dotfiles/tree/main/pi/skills/grill-with-docs
Command: npx skills add https://github.com/gbencke/dotfiles --skill grill-with-docs-gbencke

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents misunderstandings by forcing your plan to match the project’s existing domain language and documented decisions, so your approach stays coherent as it evolves.

Core Features & Use Cases

  • Relentless domain interrogation: Challenges ambiguous or conflicting terms by comparing your wording to the project glossary and calling out mismatches immediately.
  • Scenario-based precision: Probes relationships and edge cases with concrete examples so dependencies between decisions become unambiguous.
  • Documentation-first outcomes: Updates CONTEXT.md with resolved terminology and offers ADR creation only when the decision meaningfully trades off options and would be hard to reverse.
  • Codebase cross-checking: Verifies claims against the existing repository so you surface contradictions between what was said and what the code actually does.

Quick Start

Tell the AI: “Grill my plan until we agree on the domain model terms and resulting decisions, updating CONTEXT.md and proposing ADRs only when appropriate.”

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I prevent terminology drift when proposing a new domain model?

To prevent terminology drift, stress-test your proposed domain model plan against an existing project glossary and documented decisions. This process catches mismatches immediately, ensuring your approach stays coherent with shared concepts before implementation begins.

What is the best way to clarify ambiguous design tradeoffs in a codebase?

The best way to clarify ambiguous design tradeoffs is through an iterative question-by-question interview that probes edge cases with concrete scenarios. This step-by-step process makes dependencies between decisions unambiguous before you finalize documentation.

How do I validate development requirements against existing codebase decisions?

Validate development requirements by cross-checking your claims against the existing repository to surface contradictions. This codebase review verifies that proposed plans align with what the code actually does and with documented decisions.

When should I propose an ADR for a design decision?

Propose an ADR only when a design decision meaningfully trades off options and would be hard to reverse. This ensures your ADR creation focuses on significant architectural choices rather than routine documentation updates to CONTEXT.md.

Does updating CONTEXT.md require resolving all glossary conflicts first?

Updating CONTEXT.md requires resolving glossary conflicts first, as the process aligns terminology through relentless domain interrogation. Inline updates happen only after shared concepts are clarified and design choices depend on agreed domain definitions.