grill-with-docs

Run structured interviews to refine designs and produce ADRs and glossaries.

Updated Aug 26, 2024

Search Tags:#design #planning #domain modeling #adr #glossary #interview

Ready to run

npx skills add https://github.com/FabienDehopre/my-netatmo-24 --skill grill-with-docs-fabiendehopre

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/FabienDehopre/my-netatmo-24/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/FabienDehopre/my-netatmo-24 --skill grill-with-docs-fabiendehopre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams turn unclear plans and designs into clearer decisions by running a structured interview process that exposes assumptions and captures documentation.

Core Features & Use Cases

Relentless Design Interviews: Guides deep questioning sessions to challenge ideas, uncover gaps, and improve solution clarity.
Decision Documentation: Creates architectural decision records and glossaries while the discussion progresses.
Use Case: A product team can use this Skill before implementing a complex feature to refine the domain model and record important design choices.

Quick Start

Use the grill-with-docs skill to run a grilling session for my current design proposal and create the supporting documentation.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema

What is a structured design interview for refining domain models?▼

A structured design interview is a guided questioning process that challenges ideas and exposes assumptions to improve domain modeling clarity. It helps teams validate decisions and uncover gaps before implementation through deep, relentless inquiry sessions.

How do I create ADRs and glossaries during collaborative planning sessions?▼

To create ADRs and glossaries during planning, run a guided interview process that captures architectural decisions and terminology as the discussion progresses. This ensures documentation is generated continuously alongside the design refinement rather than separately.

Can I use interview-driven design refinement for product design and software architecture?▼

Yes, interview-driven design refinement applies directly to both product design and software architecture scenarios. It helps teams validate assumptions, refine domain models, and capture important design choices across these collaborative planning contexts.

What is the best way to turn unclear plans into clear architectural decisions?▼

The best way to turn unclear plans into clear architectural decisions is running a structured grilling session that questions assumptions and records decisions. This exposes gaps through deep questioning while simultaneously producing decision records and glossaries.

When do I need to run a grilling session for my design proposal?▼

You need to run a grilling session for your design proposal before implementing complex features, when plans are unclear, or when teams must validate assumptions. It is essential for refining domain models and recording important architectural choices during collaborative planning.