skills.rest
rjschie
rjschieCOMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

Validate user plans against project domain models and update documentation inline.

Updated Feb 28, 2019
Search Tags:#documentation#software design#domain model#decision-making#terminology refinement
One-click install
npx skills add https://github.com/rjschie/dotfiles --skill grill-with-docs-rjschie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/rjschie/dotfiles/tree/main/files/claude/skills/grill-with-docs
Command: npx skills add https://github.com/rjschie/dotfiles --skill grill-with-docs-rjschie

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps users to validate their plans against the existing domain model, refine their terminology, and update documentation inline as decisions are made.

Core Features & Use Cases

  • Domain Model Validation: Stress-test plans against the project's language and documented decisions.
  • Terminology Refinement: Sharpen language and ensure consistency with existing documentation.
  • Documentation Update: Update CONTEXT.md and ADRs inline during the session.
  • Use Case: When a user wants to ensure their design decisions align with the project's domain model and documentation.

Quick Start

Start a grill session with the 'grill-with-docs' skill to discuss your plan and validate it against the existing 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 a software design plan against an existing domain model?▼

To validate a software design plan against a domain model, use an interactive session to stress-test your decisions against the project's documented language and update CONTEXT.md inline as you refine terminology.

What is the best way to refine terminology and ensure consistency with project documentation?▼

Terminology refinement is achieved through turn-by-turn questioning that challenges your planned language against existing documentation, ensuring your software design decisions align with the project's domain model.

How do I update ADRs and CONTEXT.md inline while making design decisions?▼

You can update ADRs and CONTEXT.md inline during an interactive decision-making session, applying terminology refinement and domain model validation directly to your software design documentation as you discuss your plan.

Do I need existing domain documentation to start a domain model validation session?▼

Yes, domain model validation requires existing project documentation to function, as the session challenges your plan against documented decisions and applies terminology refinement based on that established context.

Can I use interactive decision-making to stress-test software design plans for large projects?▼

Yes, interactive decision-making applies to software design and documentation refinement processes of any scale, using turn-by-turn questioning to validate plans against the domain model and update documentation inline.

Related Skills

Explore More Software Engineering Skills→
matt-rileymatt-riley
1

grill-with-docs

Elicit and record domain terms and ADR decisions during planning.

Community
Advanced
Varadraj13Varadraj13

domain-model

Validate and refine domain models against codebase and documentation.

Community
Advanced
hgflimahgflima
1

domain-modeling

Guide domain model refinement, terminology, and architectural decision records.

Community
Intermediate
danielorzeata83-a11ydanielorzeata83-a11y

grill-with-docs

Validate project plans against the domain model and update documentation inline.

Community
Intermediate