grill-with-docs

Validate development plans against domain models and architectural decision records.

2.8k|166|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/flutter/agent-plugins --skill grill-with-docs-flutter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/flutter/agent-plugins/tree/main/.agents/agents/reidbaker-agent/skills/grill-with-docs
Command: npx skills add https://github.com/flutter/agent-plugins --skill grill-with-docs-flutter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents architectural drift and terminology confusion by forcing your development plans to align with the project's existing domain model, documentation, and ADRs.

Core Features & Use Cases

  • Domain Alignment: Challenges your proposed changes against the project's glossary and context map to ensure consistent language.
  • Documentation Sync: Automatically updates CONTEXT.md and ADRs as design decisions are finalized during the session.
  • Use Case: Use this when you are about to implement a new feature and want to ensure your approach respects existing architectural constraints and naming conventions.

Quick Start

Initiate a grilling session to review the proposed plan for the new billing module against the current domain model.

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 new feature plans against existing domain models and architectural decision records?

Validating development plans against domain models requires interviewing the user to resolve design ambiguities, challenging proposed changes against the project glossary and context map, and updating project documentation in real-time to maintain architectural consistency.

What's the best way to prevent architectural drift when implementing new features?

Preventing architectural drift involves stress-testing your development plans against existing domain models and ADRs, ensuring your approach respects architectural constraints and naming conventions before implementation begins.

How does documentation sync work when resolving design ambiguities in domain-driven design?

Documentation sync works by automatically updating CONTEXT.md and ADRs as design decisions are finalized during a grilling session, ensuring project documentation reflects the resolved architectural constraints and domain terminology.

Do I need repository root context files to align my development plans with existing architecture?

Yes, aligning development plans requires access to the repository's root context files and ADR directory to validate domain integrity, challenge proposed changes against the project glossary, and maintain consistent language across the codebase.

When should I stress-test my development plans against context maps and glossaries?

You should stress-test plans against context maps and glossaries when you are about to implement a new feature and want to ensure your approach respects existing architectural constraints, domain models, and naming conventions.

Can I use this approach to refactor existing architecture without breaking domain consistency?

Yes, refactoring with domain consistency is possible by validating proposed changes against existing ADRs and domain models, resolving design ambiguities through structured interviewing, and updating documentation to reflect finalized architectural decisions.