grill-with-docs

Validate design plans against domain models and architectural decision records.

113|23|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/opensage-agent/opensage-adk --skill grill-with-docs-opensage-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/opensage-agent/opensage-adk/tree/main/src/opensage/bash_tools/grill-with-docs
Command: npx skills add https://github.com/opensage-agent/opensage-adk --skill grill-with-docs-opensage-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the gap between high-level architectural plans and the actual domain language or documented decisions of a project, preventing technical debt and design drift.

Core Features & Use Cases

  • Domain Alignment: Challenges proposed plans against existing terminology in CONTEXT.md to ensure consistency.
  • Decision Integrity: Validates new design choices against existing ADRs and helps create new ones only when necessary.
  • Use Case: When planning a new feature, use this skill to interview your design, ensuring that terms like "Order" or "Invoice" are used correctly and that any major architectural trade-offs are properly documented.

Quick Start

Use the grill-with-docs skill to interview me about my current plan for the new billing module integration.

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 my software architecture plan against existing domain models?

You validate software architecture plans against project-specific domain models by conducting interactive interviews to resolve terminology conflicts and verify design consistency. This process challenges proposed plans against established documentation to prevent design drift.

What is the best way to ensure new features align with documented architectural decisions?

The best way to align new features with documented architectural decisions is to validate design choices against existing ADRs. This ensures major architectural trade-offs are properly documented and maintains decision integrity across complex system contexts.

How does an interactive design interview work for resolving domain terminology conflicts?

An interactive design interview resolves domain terminology conflicts by challenging proposed plans against existing terminology in CONTEXT.md. It verifies that terms like "Order" or "Invoice" are used correctly and ensures design consistency across complex system contexts.

Do I need specific documentation formats to check design consistency across complex systems?

Yes, checking design consistency across complex systems requires adherence to established documentation formats for context definitions and architectural decision tracking. You must maintain CONTEXT.md and ADRs to properly validate new design choices.

When should I stress-test my system design against domain-driven design documentation?

You should stress-test system design against domain-driven design documentation when planning a new feature integration. This addresses the gap between high-level architectural plans and actual domain language, preventing technical debt and design drift.

Why does my feature plan drift from the established project domain language?

Your feature plan drifts from established project domain language due to a gap between high-level architectural plans and actual documented decisions. Validating plans against CONTEXT.md and ADRs prevents this drift and maintains terminology consistency.