@firstpick/pi-extension-grill-me

Deterministic /grill-me design interview workflow for Pi.

What it does

• Adds /grill-me [plan] to start a rigorous design interview.
• Forces progress through structured tools instead of relying only on prompt text.
• Records each question, recommended answer, user answer, status, and notes.
• Persists session state in the active project at .pi/grill-me/state.json.
• Saves final results to Markdown inside the project directory.
• Refuses to write result files outside the current project directory.

Install

pi install npm:@firstpick/pi-extension-grill-me

Development symlink

For local development, symlink Pi's global extension entry to this package:

ln -s /home/firstpick/npm-packages/pi-extension-grill-me/index.ts ~/.pi/agent/extensions/grill-me.ts

Then run /reload in Pi.

Configuration

No required configuration.

Commands

• /grill-me [plan] — initialize a grill session for the current project and start the interview.
  • If no plan is supplied, the agent asks you to paste or describe the plan first.

Tools

• grill_record_turn
  • Records exactly one interview question at a time.
  • Captures the assistant recommendation, user answer, decision status, and notes.
• grill_save_results
  • Writes the active interview state to Markdown.
  • Defaults to GRILL-ME.md in the project root.
  • Accepts a project-relative path override.

Output files

.pi/grill-me/state.json   # structured session state
GRILL-ME.md               # default rendered result file

Example

/grill-me Build a new plugin system for the app

Pi will ask one question at a time, provide a recommended answer, explore the codebase when possible, and save results when the interview is complete or when asked to stop/save.