grill-with-docs

Probe technical designs for weaknesses and generate ADRs and glossaries.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/rotnov/pycc --skill grill-with-docs-rotnov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/rotnov/pycc/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/rotnov/pycc --skill grill-with-docs-rotnov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of critical scrutiny in early-stage planning, helping teams identify gaps in logic or design before implementation begins.

Core Features & Use Cases

  • Relentless Interviewing: Systematically probes your design or plan to uncover hidden assumptions and edge cases.
  • Documentation Generation: Automatically produces Architecture Decision Records (ADRs) and project glossaries based on the interview outcomes.
  • Use Case: Use this skill when you have a draft architecture for a new feature and need to ensure it is robust, well-documented, and ready for peer review.

Quick Start

Invoke the grill-with-docs skill to begin a critical review of the current project design and generate the necessary documentation.

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 draft architecture before implementation begins?

Validating a draft architecture requires systematic interrogation to uncover hidden assumptions and edge cases. A structured critical interview process probes your design concepts to identify architectural weaknesses before implementation begins.

What is an Architecture Decision Record and when do I need one?

An Architecture Decision Record (ADR) documents critical technical decisions made during planning. You need an ADR when refining a draft architecture, capturing the outcomes of design interviews to formalize project logic and glossaries for peer review.

How do I generate project glossaries and ADRs from a design review?

Generate project glossaries and ADRs by running a diagnostic documentation workflow that probes your technical design. This process automatically produces formal Architecture Decision Records and glossaries based on the interview outcomes.

Can I use this critical interview process for any software planning scale?

This critical interview process suits any software planning scale where a draft architecture exists. It systematically probes your design to identify gaps in logic, ensuring robust documentation and peer review readiness regardless of project size.

Why does my technical design lack critical scrutiny during early-stage planning?

Technical designs lack critical scrutiny during early-stage planning because hidden assumptions and edge cases go unexamined. Relentless interviewing systematically probes your concepts to uncover these architectural weaknesses before implementation begins.