grill-with-docs

Validate project plans against domain models and update glossaries and ADRs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps ensure that project plans align with the domain model and documented decisions, catching potential issues early and improving communication.

Core Features & Use Cases

  • Domain Model Alignment: Validate plans against the project's domain model and terminology.
  • Documentation Updates: Update CONTEXT.md and ADRs inline as decisions are made.
  • Use Case: Before finalizing a new feature, use this Skill to review its design with the project's domain experts and update the documentation to reflect new decisions.

Quick Start

Run the grill-with-docs skill to review the new feature design document 'feature-design.md'.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I validate a feature design against my project's domain model?

To validate a feature design against your domain model, you can use this Skill to review the design document and ensure its terminology aligns with your project's documented domain language. It checks plans against existing domain definitions and flags misalignments.

What is the best way to update documentation and ADRs during a design review?

Updating documentation and ADRs during a design review is handled by this Skill by validating plans against existing decisions and appending new contexts to `CONTEXT.md`. It ensures your architecture decision records reflect the latest design outcomes.

How do I check if a new software plan conflicts with existing architecture decisions?

To check if a new software plan conflicts with existing architecture decisions, this Skill cross-references your plans against documented ADRs and the domain model. It identifies potential contradictions early before implementation begins.

Does validating plans against domain documentation require manual intervention?

Validating plans against domain documentation does require manual intervention for resolving domain-specific contexts and finalizing documentation updates. The Skill flags alignment issues but relies on human input for complex domain decisions.

When do I need to stress-test project plans against project documentation?

You need to stress-test project plans against project documentation before finalizing a new feature design or making structural changes. This ensures design decisions align with the project's language and previously documented decisions.

Can I use this Skill to update CONTEXT.md files inline with new design decisions?

Yes, you can use this Skill to update `CONTEXT.md` files inline as new design decisions are made during the review process. It integrates documentation updates directly into the plan validation workflow.