grill-me

Interviews users question-by-question to resolve plan decisions and records findings to .work files.

3|Updated Oct 28, 2020
One-click install
npx skills add https://github.com/k0d3x8its/dotfiles --skill grill-me-k0d3x8its
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-me
Source: https://github.com/k0d3x8its/dotfiles/tree/main/claude/.claude/skills/grill-me
Command: npx skills add https://github.com/k0d3x8its/dotfiles --skill grill-me-k0d3x8its

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans often contain unresolved decisions and hidden dependencies that surface only after building starts. This Skill stress-tests a plan through relentless one-at-a-time questioning, resolving each design decision before any code is written. ## Core Features & Use Cases - Decision-tree interrogation: Walks each branch of the design tree, asking one question at a time and providing a recommended answer for each. - Fact vs. decision separation: Answers codebase-explorable questions itself and only asks the user about genuine decisions requiring input. - Format-aware output: Detects flat vs. clustered planning layouts and appends resolved decisions to .work/FINDINGS.md or per-cluster files under .work/findings/. - Use Case: Before starting a new feature, run this Skill to interview yourself on architecture, data models, and edge cases, ending with a findings file ready for the requirements or write-plan stage. ## Quick Start Ask the AI to grill you on your current plan so every open design decision is resolved and recorded before building begins.

Frequently Asked Questions about grill-me

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

FAQPage Schema
How do I stress-test a plan before writing code?▼

Run a structured interview that walks each branch of the design tree, resolving decisions one at a time with recommended answers. Resolved decisions are appended to .work/FINDINGS.md so nothing is lost before building starts.

How to resolve design decisions one at a time with an AI assistant?▼

Ask the assistant to interview you relentlessly, posing a single question per turn and waiting for feedback before continuing. Batching multiple questions at once stalls resolution instead of advancing it.

Where does grill-me write its resolved decisions?▼

In flat format it appends each decision directly to .work/FINDINGS.md. When a .work/plan/ directory exists, it writes per-cluster files under .work/findings/ and updates one index line in FINDINGS.md with an open, in-progress, or done status.

Does the planning interview answer questions from the codebase automatically?▼

Yes, facts answerable by exploring the codebase are investigated directly rather than asked. Only genuine decisions requiring user input are posed as interview questions.

When should I not use a plan stress-testing interview?▼

Skip it when the work is not feature work needing a formal spec, or when all open questions are already resolved. In those cases proceed directly to writing the plan or requirements.