grill-with-docs

Align plans with domain models and update CONTEXT.md and ADRs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grilling session that helps align your plan with the project's domain model, surface terminology gaps, and update documentation inline (CONTEXT.md, ADRs) as decisions crystallize.

Core Features & Use Cases

  • Guides comprehensive questioning to uncover assumptions and dependencies between decisions.
  • Keeps CONTEXT.md and ADRs synchronized with evolving strategy during planning.
  • Improves terminology consistency across documentation and code.

Quick Start

Begin a guided interview with the project stakeholders to iteratively clarify decisions and update the repo docs as decisions crystallize.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I align my software architecture plan with the project's domain model?

To align your architecture plan with the domain model, run a guided grilling session that surfaces terminology gaps and resolves misalignments between your strategy and existing domain definitions. It iteratively clarifies decisions and updates documentation as your plan crystallizes.

When do I need to update CONTEXT.md and ADRs during planning?

You need to update CONTEXT.md and ADRs during planning when domain terminology shifts or new architectural decisions emerge. This ensures governance documentation stays synchronized with your evolving strategy, capturing clarifications and guiding future project discussions.

How do I uncover terminology gaps between documentation and code?

Uncover terminology gaps through a comprehensive interview process that questions project stakeholders about assumptions and dependencies. This grilling technique exposes misalignments between your plan and the project's domain language, ensuring consistency across documentation and code.

What is the best way to stress-test domain terminology decisions before implementation?

The best way to stress-test domain terminology decisions is applying a guided questioning framework during architecture sessions. It identifies misalignments with the domain model, captures crystallized decisions in ADRs, and updates CONTEXT.md to maintain governance and terminology consistency.

Can I use this grilling session to clarify dependencies between architectural decisions?

Yes, you can use this grilling session to clarify dependencies between architectural decisions. It guides comprehensive questioning to uncover hidden assumptions and relationships, ensuring that updates to CONTEXT.md and ADRs reflect the full context of your governance strategy.

Why does my project documentation lose terminology consistency during planning?

Project documentation loses terminology consistency when domain language evolves without synchronized updates to CONTEXT.md and ADRs. A grilling session resolves this by iteratively clarifying terms, capturing decisions, and aligning documentation with the actual domain model.