grill-with-docs

Interrogate technical designs and generate Architecture Decision Records and project glossaries.

63|9|Updated Jun 15, 2025
One-click install
npx skills add https://github.com/willdady/platypus --skill grill-with-docs-willdady
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/willdady/platypus/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/willdady/platypus --skill grill-with-docs-willdady

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of clarity and documentation in early-stage project planning by forcing a structured, critical review of your design or plan.

Core Features & Use Cases

  • Critical Interrogation: Acts as a relentless interviewer to identify gaps, assumptions, and weaknesses in your technical designs.
  • Automated Documentation: Simultaneously generates Architecture Decision Records (ADRs) and project glossaries based on the session output.
  • Use Case: Use this during the initial phase of a new feature implementation to ensure your domain model is robust and your team has a shared understanding of the terminology and architectural constraints.

Quick Start

Initiate a grilling session for the current project design to identify potential flaws and generate the necessary ADRs.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I generate Architecture Decision Records for a new feature design?

Generate Architecture Decision Records by initiating an AI-led critical interrogation of your technical design, which simultaneously outputs structured ADRs and project glossaries based on the session findings.

What is design interrogation and how does it improve software architecture planning?

Design interrogation is a structured critical review process that acts as a relentless interviewer to identify gaps, assumptions, and weaknesses in your technical designs to ensure robust software architecture planning and domain modeling.

How do I refine project requirements and domain modeling before implementation?

Refine project requirements and domain modeling by initiating a grilling session that forces a structured, critical review of your early-stage plan, ensuring your team shares understanding of terminology and architectural constraints.

Can I use AI to identify gaps and weaknesses in my technical designs?

Yes, you can use AI-led critical interrogation to act as a relentless interviewer, targeting software architecture planning to identify potential flaws, gaps, and unvalidated assumptions in your technical designs.

What is the best way to document architectural decisions and build a project glossary?

The best way to document architectural decisions is through a structured interrogation session that outputs ADRs and glossaries, leveraging domain-modeling to ensure consistency in your project terminology and architectural constraints.

Do I need prior domain modeling experience to use an AI design interrogation tool?

No prior experience is strictly required, as the tool facilitates critical design reviews and leverages domain-modeling automatically to ensure consistency in architectural decision records and project glossaries during early-stage project planning.