From 4979db969a86651c92fb70ca4cd1e300cfcde8a0 Mon Sep 17 00:00:00 2001 From: Ario Barin Ostovary Date: Fri, 21 Aug 2026 10:53:55 -0400 Subject: [PATCH] add decision frontier grilling --- codex/skills/grilling/SKILL.md | 28 +++++++++++++++++ codex/skills/grilling/agents/openai.yaml | 3 ++ codex/skills/grilling/references/sources.md | 35 +++++++++++++++++++++ manifests/portable-files.json | 1 + 4 files changed, 67 insertions(+) create mode 100644 codex/skills/grilling/SKILL.md create mode 100644 codex/skills/grilling/agents/openai.yaml create mode 100644 codex/skills/grilling/references/sources.md diff --git a/codex/skills/grilling/SKILL.md b/codex/skills/grilling/SKILL.md new file mode 100644 index 0000000..8ca78c6 --- /dev/null +++ b/codex/skills/grilling/SKILL.md @@ -0,0 +1,28 @@ +--- +name: grilling +description: Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases. +--- + +Interview the user relentlessly until you reach a shared understanding. Map this as a **design tree**: every decision branches into the decisions that hang off it. + +Work the tree in **rounds**. The **frontier** is every decision whose prerequisites are already settled: the questions you can ask _now_ without guessing at answers you haven't heard yet. Ask the whole frontier in one round: number each question and give your recommended answer. Then wait for the user's answers before the next round. + +Format a round like so: + +``` +❓ **Q1** - ****: + +➡️ + +--- + +❓ **Q2** - ****: + +➡️ +``` + +Each round the user answers reshapes the tree: settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier and ask the next round. A question whose answer depends on another question still open in this round belongs to a _later_ round, not this one. + +Finding _facts_ is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), dispatch a sub-agent to find it; don't ask the user for anything you could look up yourself. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait for the sub-agent to report; ask the rest of the frontier now. The _decisions_ are the user's: put each to them and wait. + +The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed. Do not act on it until the user confirms you have reached a shared understanding. diff --git a/codex/skills/grilling/agents/openai.yaml b/codex/skills/grilling/agents/openai.yaml new file mode 100644 index 0000000..ddbdb96 --- /dev/null +++ b/codex/skills/grilling/agents/openai.yaml @@ -0,0 +1,3 @@ +interface: + display_name: "Grilling" + short_description: "Stress-test thinking a round of questions at a time" diff --git a/codex/skills/grilling/references/sources.md b/codex/skills/grilling/references/sources.md new file mode 100644 index 0000000..46ead0c --- /dev/null +++ b/codex/skills/grilling/references/sources.md @@ -0,0 +1,35 @@ +# Sources + +Read this provenance when auditing or revising Grilling, not during normal use. + +The skill is substantially derived from Matt Pocock's `grilling` skill: + +- Source: https://github.com/mattpocock/skills/blob/0ab1b63a410a03d3627979a109c8695de27af954/skills/productivity/grilling/SKILL.md +- Repository license: MIT +- Upstream copyright: Copyright (c) 2026 Matt Pocock + +Compass preserves the upstream skill body and invocation metadata. The design-tree, frontier, facts-versus-decisions, and round structure are the behavior being adopted. + +## Upstream license + +MIT License + +Copyright (c) 2026 Matt Pocock + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/manifests/portable-files.json b/manifests/portable-files.json index d85d1dd..bbd0dd5 100644 --- a/manifests/portable-files.json +++ b/manifests/portable-files.json @@ -14,6 +14,7 @@ "blast-radius", "compass", "diagnosing-bugs", + "grilling", "ground-in-sources", "micro-experiment", "monitor",