grill-me-for-clarification

Conduct structured clarification interviews to resolve plan ambiguity.

2|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill grill-me-for-clarification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-me-for-clarification
Source: https://github.com/Remaker-Digital/groundtruth-kb/tree/main/.claude/skills/grill-me-for-clarification
Command: npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill grill-me-for-clarification

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces ambiguity in a plan or design by forcing a structured, dependency-ordered clarification interview with the owner until shared understanding is reached.

Core Features & Use Cases

  • Dependency-ordered clarification interviews: Builds a decision tree by exploring in-scope artifacts first, then asks only the unresolved questions.
  • One-question-per-turn traversal: Ensures questions are asked in the correct order and discovered decisions are inserted at the right dependency position.
  • Durable checkpointing of outcomes: Persists each owner resolution immediately as either a decision record or a spec intake confirmation, so the interview can resume later.
  • Shared-understanding summary artifact: Produces a consolidated view of resolved and deferred branches with the persisted IDs and revisit triggers.

Quick Start

Use grill-me-for-clarification with a single explicit scope argument, for example: “grill me for clarification about the proposed architecture for payments checkout.”

Frequently Asked Questions about grill-me-for-clarification

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

FAQPage Schema
How do I resolve ambiguity in requirements before starting implementation?

To resolve ambiguity in requirements, you need a structured clarification interview that builds a dependency-ordered decision tree, asking the owner one unresolved question per turn until shared understanding is reached. This ensures all design branches are explicitly scoped before development begins.

What is the best way to conduct a spec intake for multi-decision design branches?

The best way to conduct spec intake for multi-decision design branches is through a structured clarification interview that explores in-scope artifacts first, then asks only unresolved questions. Each owner resolution is immediately persisted as a spec intake confirmation checkpoint to durable storage.

How do I track deferred decisions and dependency ordering during a design review?

You can track deferred decisions and dependency ordering by building a decision tree during the review, inserting discovered decisions at their correct dependency position. A shared-understanding summary artifact is then produced, showing resolved branches, persisted IDs, and revisit triggers for deferred items.

Can I pause a requirements clarification interview and resume it later without losing context?

Yes, you can pause and resume a requirements clarification interview later because each owner resolution is immediately persisted as a decision record or spec intake confirmation. This durable checkpointing ensures the interview state is saved and can resume exactly where it left off.

When do I need a dependency-ordered decision tree for project planning?

You need a dependency-ordered decision tree for project planning when dealing with multi-decision areas like requirements, directives, or design branches that require sequential decisions before implementation. It ensures questions are asked in the correct order based on their dependencies.

Why does my requirements clarification process fail to achieve shared understanding?

Your requirements clarification process may fail to achieve shared understanding if it lacks a structured interview format that enforces one-question-per-turn traversal and immediate persistence of resolutions. Without durable checkpointing and dependency-ordered questioning, unresolved ambiguities and lost context disrupt alignment.