grill-with-docs

Review software designs through critical questioning and generate ADRs and project glossaries.

110|4|Updated Jul 19, 2016

Search Tags:#design #planning #architecture #documentation #adr #review

Ready to run

npx skills add https://github.com/deathbeam/dotfiles --skill grill-with-docs-deathbeam

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/deathbeam/dotfiles/tree/main/agents/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/deathbeam/dotfiles --skill grill-with-docs-deathbeam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of rigor in early-stage planning by forcing a critical review of your ideas while simultaneously capturing the output as formal documentation.

Core Features & Use Cases

Critical Review: Acts as a relentless interviewer to identify gaps, edge cases, and logical flaws in your proposed designs.
Automated Documentation: Converts the insights gained during the grilling session into structured ADRs (Architecture Decision Records) and project glossaries.
Use Case: Use this when you have a draft architecture or a new feature proposal and need to ensure it is robust and well-documented before implementation.

Quick Start

Initiate a grilling session by asking the assistant to grill your current design proposal and document the findings.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema

How do I stress-test my software architecture before implementation?▼

Architecture Decision Records document formal design choices. They are generated by synthesizing feedback from rigorous design reviews, capturing architectural decisions and project glossaries for future reference.

What is the best way to review a draft architecture for logical flaws?▼

The best way to review a draft architecture is through a relentless interviewing process that probes your design to expose hidden requirements and logical flaws, ensuring your planning is robust and rigorous.

Can I generate a project glossary directly from my design review session?▼

Yes, you can generate a project glossary directly from a design review. The review process leverages domain modeling techniques to synthesize session insights into structured glossaries and formal documentation.

How do I create ADRs from a new feature proposal?▼

To create ADRs from a feature proposal, submit the draft design to a grilling session. The interactive review identifies inconsistencies and automatically converts the findings into Architecture Decision Records.