pi-grill-me

Conducts one-question-at-a-time design interviews and saves structured Q&A to Markdown.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/mikalv/pi-extensions --skill pi-grill-me-mikalv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pi-grill-me
Source: https://github.com/mikalv/pi-extensions/tree/main/packages/pi-grill-me/skills/pi-grill-me
Command: npx skills add https://github.com/mikalv/pi-extensions --skill pi-grill-me-mikalv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain untested assumptions that only surface during implementation. This Skill stress-tests a plan by interviewing the user with one focused question at a time and recording every decision in a reusable artifact. ## Core Features & Use Cases - Structured Design Interview: Asks exactly one question per turn, each with a recommended answer, so decisions stay focused and unblocked. - Codebase-Aware Questioning: Inspects the repository directly when a question can be answered from code instead of asking the user. - Persistent Q&A Record: Tracks each turn as resolved, open, or needs-codebase-check, and saves the final result to GRILL-ME.md with working state in .pi/grill-me/state.json. - Use Case: Before implementing a new feature, ask the agent to grill your implementation plan; it will challenge each assumption sequentially and produce a Markdown document of settled and open decisions. ## Quick Start Ask the agent to grill your implementation plan and answer its questions one at a time until it saves the results to GRILL-ME.md.

Frequently Asked Questions about pi-grill-me

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

FAQPage Schema
How do I stress-test an implementation plan with an AI agent?▼

Ask the agent to grill your plan or challenge your design. It will interview you with one question at a time, provide a recommended answer for each, and save the full Q&A record to GRILL-ME.md when finished.

How do I save design questions and answers to a Markdown file?▼

Run the grill-me interview and answer each question until you ask to stop, save, or wrap up. The agent then writes all resolved and open decisions to GRILL-ME.md, with working state kept in .pi/grill-me/state.json.

Can the interview answer questions from my codebase directly?▼

Yes. When a question can be answered from code, the agent inspects the repository first instead of asking you. Such turns are marked with the needs-codebase-check decision status until resolved.

What do the resolved, open, and needs-codebase-check statuses mean?▼

Resolved means the decision is settled, open means it is still pending, and needs-codebase-check means the next step is repository inspection. These statuses are recorded per turn to track which decisions remain outstanding.

When should I not use a one-question-at-a-time design interview?▼

Avoid it for trivial changes with no meaningful design trade-offs, since the sequential interview adds overhead. It is best suited to plans with real assumptions, dependencies, or architectural choices worth challenging.