skills.rest
hgxszhj
hgxszhjCOMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

Validate project plans against the domain model and update CONTEXT.md and ADRs.

Updated May 7, 2026
Search Tags:#documentation#adr#interactive#design-decisions#domain-model#context-md#grill
One-click install
npx skills add https://github.com/hgxszhj/mattpocock_skills --skill grill-with-docs-hgxszhj
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/hgxszhj/mattpocock_skills/tree/main/skills/engineering/grill-with-docs
Command: npx skills add https://github.com/hgxszhj/mattpocock_skills --skill grill-with-docs-hgxszhj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams stress-test their plan against the current domain model and terminology, and inline-update documentation so decisions stay aligned as they crystallize.

Core Features & Use Cases

  • Interactive grilling sessions that challenge assumptions and surface terminology gaps.
  • Inline documentation updates to CONTEXT.md and ADRs as decisions crystallize.
  • Suitable for architecture planning, domain-language alignment, and ensuring decisions map to code and docs.

Quick Start

Begin an interactive grilling session that asks questions one by one, updates CONTEXT.md and ADRs inline as decisions crystallize, and explores the codebase when helpful.

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 the domain model?▼

You can validate your architecture plan by running an interactive grilling session that forces a thorough, questioning review against the domain model. This surfaces terminology gaps and ensures your design decisions map accurately to the project's domain language.

How do I update CONTEXT.md and ADRs inline during a planning session?▼

Update CONTEXT.md and ADRs inline by providing your current plan and related code or docs to an interactive grilling session. As decisions crystallize during the questioning review, the session updates documentation automatically to maintain alignment.

What is an interactive grilling session for documentation and design decisions?▼

An interactive grilling session for design decisions is a questioning review process that asks questions one by one to stress-test your plan against the domain model. It explores the codebase when helpful to clarify and validate project architecture.

Do I need existing code or docs to align domain terminology across contexts?▼

Yes, providing the current plan and related code or docs is required to align domain terminology across contexts. This input allows the grilling session to explore the codebase and update CONTEXT.md and ADRs inline as decisions crystallize.

What is the best way to stress-test a project plan and align terminology?▼

The best way to stress-test a project plan and align terminology is through an interactive grilling approach that forces a thorough review against the domain model. This challenges assumptions and updates documentation inline as decisions crystallize.

Related Skills

Explore More Software Engineering Skills→
JCE-Joshhh77JCE-Joshhh77
16

grill-with-docs

Validate planning proposals against local context and ADR files.

Community
Intermediate
compozycompozy
83

grill-with-docs

Challenge project plans against domain models and update CONTEXT.md and ADRs.

Official
Advanced
dachentdachent
18

grill-with-docs-codex

Validate project plans against domain terminology, ADRs, and codebase context.

Community
Intermediate
harishgovardhandamodarharishgovardhandamodar

documentation-and-adrs

Record architectural decisions and project documentation with ADR templates and verification checklists.

Community
Basic