Skip to content
Development
Command

/cs-grill-me

/cs:grill-me <path-to-plan> — Start a relentless interrogation of a plan or design. Walks decision tree one branch at a time. One question per turn with recommended answer. Explores codebase before asking.

From plugin
claude-skills
24k116 skills100 agents116 commands1 MCP
Install
$ npx -y skills add alirezarezvani/claude-skills --agent claude-code

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/cs-grill-me

Context preview

What this command does when you run it.

/cs:grill-me <path-to-plan> — Start a relentless interrogation of a plan or design. Walks decision tree one branch at a time. One question per turn with recommended answer. Explores codebase before asking.

Command definition

cs-grill-me.md
name: "cs-grill-me"
description: "/cs:grill-me <path-to-plan> — Start a relentless interrogation of a plan or design. Walks decision tree one branch at a time. One question per turn with recommended answer. Explores codebase before asking."

/cs:grill-me — Relentless Plan Interrogation

**Command:** `/cs:grill-me <path-to-plan>`

The grill-master persona interrogates a plan one decision branch at a time.

When to Run

  • Stress-testing a plan before commitment
  • Pre-mortem on a design (find weaknesses before they hurt)
  • Onboarding to an existing plan (interrogate what's there)
  • Resuming a grill session from previous turn

The Six Forcing-Question Patterns

1. **Intent:** "Why X and not Y?" (names the alternative) 2. **Choice:** "Which side, and what's the deciding constraint?" 3. **Open:** "What's blocking this decision, and when does the blocker resolve?" 4. **Tradeoff:** "Which side are you optimizing for, and what's the kill criterion?" 5. **Dependency:** "Is the upstream decision locked in? If not, that comes first." 6. **Uncertainty:** "Even at 60% confidence — what's your best guess?"

Discipline

  • **One question per turn.** Never bundle.
  • **Recommended answer attached.** Every question carries a position + rationale.
  • **Codebase before speculation.** `grep` / `Read` resolves before asking.
  • **Depth-first walk.** Finish a branch before opening another.

Workflow

# 1. Extract decision branches from the plan
python ../skills/grill-me/scripts/decision_tree_extractor.py path/to/plan.md

# 2. Generate forcing questions with recommendations
python ../skills/grill-me/scripts/question_generator.py path/to/plan.md

# 3. Start session
python ../skills/grill-me/scripts/grill_session_tracker.py --action start --session NAME --plan path/to/plan.md

# 4. Walk one question at a time:
#    Persona asks Q1 with recommendation.
#    User answers.
#    Record:
python ../skills/grill-me/scripts/grill_session_tracker.py --action record --session NAME --question-id 1 --answer "..."

# 5. When complete:
python ../skills/grill-me/scripts/grill_session_tracker.py --action close --session NAME

When to Stop

  • Every branch has an answer
  • 3+ turns with no new questions arising
  • User signals fatigue ("can we move on?")
  • Diminishing returns past ~15 questions

Produce a "decisions locked" summary at close.

Output Format

Q[i]/[total] (L[line]): [question]
Recommended: [position] because [1-sentence rationale]

(or: I explored — found [evidence]. Confirm?)

Related

  • Agent: [`cs-grill-master`](../agents/cs-grill-master.md)
  • Skill: [`grill-me`](../skills/grill-me/SKILL.md)
  • Adjacent: `/cs:caveman`, `/cs:handoff`, `/cs:write-a-skill`

---

**Version:** 1.0.0 **Derived:** Matt Pocock's grill-me (MIT) + this repo's wrapper

Read more
Ships withclaude-skills

362 production-ready Claude Code skills, plugins, and agent skills for 13 AI coding tools. The most comprehensive open-source library of Claude Code skills and agent plugins — also works with OpenAI Codex, Gemini CLI, Cursor, and 9 more coding agents.

Get the whole plugin, auto-invoked
Stats
24,115
Stars
1
Views
3,400
Forks
Active
Maintenance
Python
Language
MIT
License
3d ago
Last commit
9mo ago
Created

Repo: alirezarezvani/claude-skills