AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--grill-me at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 4

references/companion_tooling.md

Companion Tooling

Interrogation tools + cs-* wrapper layered on top of Matt's grill-me skill.

Validation Tools (stdlib Python)

| Tool | Purpose | Run when | |---|---|---| | scripts/decision_tree_extractor.py | Scan a plan doc for decision branches (intent / choice / open / tradeoff / dependency / question) | Starting a grill session — see what's there to interrogate | | scripts/question_generator.py | Generate forcing questions from extracted branches with recommended answers + dependency-aware ordering | Producing the question list for a grill session | | scripts/grill_session_tracker.py | JSON-backed session storage in ~/.grill_sessions/ — track answers across turns, resume sessions | Running a multi-turn grill (most real grills) |

All three:

  • Stdlib-only
  • Run with embedded sample if no input provided
  • Output text or JSON (--output json)

Session Storage

grill_session_tracker.py persists state to ~/.grill_sessions/<name>.json. This enables:

  • Resume a grill across days
  • Switch between concurrent grills (e.g., per project)
  • Audit which decisions were resolved when
  • Generate a "decisions locked" summary at end

cs-grill-master Persona Agent

Lives at ../agents/cs-grill-master.md. Voice: relentless, one-question-at-a-time, codebase-exploration-first.

The persona's hard rule: never bundle questions. Even when there are 10 obvious follow-ups, ask one, wait for answer, then ask the next.

/cs-grill-me Slash Command

Lives at ../commands/cs-grill-me.md. Activation pattern:

  1. /cs-grill-me <path-to-plan> — start grill session on plan doc
  2. Persona asks Q1 with recommended answer
  3. User answers
  4. Persona asks Q2
  5. ...continues until all branches resolved

Why Wrap Matt's Original

Matt's grill-me skill is intentionally minimal (3 sentences). The wrapper adds:

  1. Automatic branch extraction — manually identifying decision branches is the slow part; the extractor does it deterministically
  2. Question templating — consistent question patterns per branch kind (intent / choice / tradeoff)
  3. Session persistence — grills span days; persistence prevents re-asking + losing context
  4. Recommendation defaults — every question carries a recommended answer (per Matt's "provide your recommended answer" rule)

Attribution

Original: matt-pocock/skills/skills/productivity/grill-me (MIT).


Source authorities (non-exhaustive):

  • Matt Pocock — grill-me (https://github.com/mattpocock/skills/, MIT) — the upstream source
  • Socratic Method (5th-century BC) — interrogation as truth-finding; one-question-at-a-time discipline
  • YC office hours format (Y Combinator) — forcing questions for founders; "what's blocking this?" + "why this and not Y?"
  • Cockburn, A. — "Writing Effective Use Cases" (2000) — exploring decision branches in requirements
  • Fournier, C. — "The Manager's Path" (2017) — interview discipline for hard decisions
  • Larson, W. — "An Elegant Puzzle" (2019) — engineering manager decision-making patterns
  • 5 Whys (Toyota Production System) — Sakichi Toyoda — sequential interrogation for root cause