skills.rest
deathbeam
deathbeamCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/deathbeam/dotfiles --skill grill-with-docs-deathbeam
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
tonombtonomb

grill-with-docs

Critically review technical designs and generate ADRs and project glossaries.

Community
Intermediate
johangm90johangm90

spex-architect

Design software architecture with bounded contexts, vertical slices, ADRs, and PRDs.

Community
Advanced
hachejhachej
45

grill-with-docs

Interrogate domain models to identify gaps and generate ADRs and glossaries.

Community
Intermediate
GenerativeAgentsGenerativeAgents

glossary-creation

Extract and consolidate project terms into a standardized glossary at docs/glossary.md.

Official
Advanced