agent-grill-me

Review PRDs and plans through Socratic questioning, enforcing domain vocabulary, and logging ADRs.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill agent-grill-me
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-grill-me
Source: https://github.com/VictorHueni/homemade-claude-kit/tree/main/skills/agent-grill-me
Command: npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill agent-grill-me

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a live Socratic session to stress-test PRDs and implementation plans, identifying ambiguities, enforcing domain vocabulary, and crystallizing decisions into ADRs.

Core Features & Use Cases

  • Socratic Stress-Testing: Live questioning to uncover thinking gaps and ensure document coherence.
  • Domain Vocabulary Enforcement: Checks against the project's domain glossary for consistency.
  • Decision crystallization: Log decisions into ADRs during the session.
  • Use Case: Before coding starts, use this skill to review a PRD or plan, ensuring clarity and alignment with project goals.

Quick Start

Run the agent-grill-me skill with the PRD or plan file as input: agent-grill-me path/to/your-prd.md

Frequently Asked Questions about agent-grill-me

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

FAQPage Schema
How do I stress-test a PRD for ambiguities before implementation?

To stress-test a PRD, you can use a Socratic questioning loop that probes your document for ambiguities, enforces domain vocabulary consistency, and crystallizes final decisions into Architecture Decision Records.

What is the best way to enforce domain vocabulary during a plan review?

The best way to enforce domain vocabulary during a plan review is by cross-referencing the target artefact against a project domain glossary and bounded context, ensuring all terminology remains consistent throughout the Socratic session.

Can I generate Architecture Decision Records directly from a PRD review session?

Yes, you can generate Architecture Decision Records directly from a PRD review by running a live Socratic session that identifies thinking gaps and logs the crystallized decisions into ADRs as the discussion progresses.

How does a Socratic stress-test work for implementation plans?

A Socratic stress-test for implementation plans works by engaging the document in a live questioning loop, actively uncovering logical gaps and misalignments to ensure coherence before any coding begins.

Do I need a domain glossary to review an implementation plan?

Yes, providing a domain glossary and bounded context is expected so the review process can actively check the implementation plan against established domain vocabulary and flag inconsistencies.

When should I not use a Socratic approach for PRD stress-testing?

You should avoid using a Socratic approach for PRD stress-testing if your project lacks a defined domain glossary or bounded context, as the enforcement of domain vocabulary is required to identify ambiguities accurately.