mp-grill

Clarify plans and requirements by interrogating assumptions until decisions are settled.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-grill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mp-grill
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/skills/mp-grill
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-grill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It resolves ambiguity in your plan, design, or requirements by interviewing you relentlessly until every branch of the decision tree is settled and shared.

Core Features & Use Cases

  • Relentless requirements clarification: Surfaces ambiguity, edge cases, dependencies, acceptance criteria, and scope until they are explicit.
  • Repo-aware exploration: Uses an Explore agent to answer questions by inspecting the codebase instead of defaulting to direct questioning.
  • Documentation updates: Writes confirmed domain language and settled decisions into .mpx/CONTEXT.md and .mpx/DECISIONS.md while keeping project docs concise.
  • Best-fit use: Use when you need to stress-test a plan/design, reconcile requirements, or add requirements without leaving gaps for later.

Quick Start

Ask Claude Code to run it by saying: grill me about the requirements for the new feature you are planning.

Frequently Asked Questions about mp-grill

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

FAQPage Schema
How do I clarify project requirements and resolve design ambiguity before development?

To clarify requirements and resolve design ambiguity, you can use an interrogative planning approach that relentlessly questions assumptions and settles every decision-tree branch until shared understanding is reached. This ensures explicit acceptance criteria and scope.

What is the best way to stress-test a project plan and uncover hidden edge cases?

Stress-testing a project plan involves interviewing stakeholders to surface ambiguity, edge cases, and dependencies until they are explicit. This approach reconciles requirements and closes gaps in design alignment before implementation begins.

Can I use codebase exploration to answer requirements questions instead of manual checks?

Yes, you can use an Explore agent to inspect the codebase and answer questions directly from the source. This prevents unnecessary manual checks and grounds requirement gathering in existing codebase architecture.

How do I document architecture decisions and domain language during project planning?

You document architecture decisions and domain language by writing confirmed terms and settled choices into project files like CONTEXT.md and DECISIONS.md. This keeps documentation concise and ensures project alignment throughout the workflow.

Does this requirements clarification approach work within a GitHub-driven project workflow?

Yes, this requirements clarification method is designed for doc-backed planning within a GitHub-driven project workflow. It reads existing context files and updates only confirmed domain terms to maintain project alignment.