claudex-grill-with-docs

name	claudex-grill-with-docs
description	Run a documented grilling session in claudex with Claude leading the interview and the GPT/Codex-family grill-advisor challenging the opening design tree and auditing the final decisions. Use when the user wants Claude and Codex to stress-test a plan or design together while recording ADRs and domain terminology.

Claudex Grill with Docs

Compose /grilling, /domain-modeling, /atelier, and /agent-orchestration. Claude owns the conversation and documentation; the grill-advisor agent (gpt-5.6-sol) acts as the Codex advisor. This skill fixes that advisor binding; use /model-orchestration only for broader routing and quota policy outside this composition.

Workflow

1. Confirm the session is running under claudex and the grill-advisor agent is available. If it is unavailable or its model fails to resolve, explain that the cross-family session cannot run and do not claim that Codex participated.
2. Establish the target. If the user named a doc, branch, handoff file, or topic, use it — a handoff passed as an argument is the target; read it first. If none is given, ask what to grill. Do not spelunk the repo to guess the topic.
3. Gather facts from the codebase and supplied documents. Distill the plan, constraints, known facts, and unresolved decisions; do not give the advisor raw file dumps.
4. Before asking the first question, start one persistent grill-advisor. Ask it to identify the consequential assumptions, missing branches, contradictions, and highest-value questions, with a recommended answer for each.
5. Use those findings as input to a /grilling session that maintains docs via /domain-modeling. Follow both contracts: work one decision at a time, recommend an answer, resolve discoverable facts without asking the user, and maintain the ADRs and glossary as decisions settle. Present each decision richly — the tension, a worked example, the verified facts (with file:line), and your recommendation — never a bare one-line question. Present the decisions on an /atelier surface with one Review Unit per decision. Apply /agent-orchestration for collaborator reuse, compact handoffs, durable state, continuity, and one human-facing voice.
6. Synthesize the advisor's advice into the grill; do not invoke the advisor before every question.
7. Before declaring shared understanding, distill the settled decisions, rationale, glossary, and remaining uncertainties. Continue the same grill-advisor with that compact delta for an adversarial completeness check.
8. If the final check finds a material gap, resume the grill one decision at a time. Otherwise, present the intended-state documents for confirmation.
9. Do not implement the plan, or ratify ADRs and glossary terms as decided, until the user explicitly confirms shared understanding.

Treat the two advisor calls as the default budget. Add another only when new information materially invalidates an earlier branch.

AFK / autonomous convergence

When the user says they are away and asks you to iterate to shared understanding without them, the advisor stands in for the human interviewer:

• Run grill-advisor rounds (distill → challenge → correct → re-check) until the advisor confirms shared understanding or you reach the round budget. Apply /agent-orchestration to continue the advisor and preserve resumable state.
• Leave every decision as an open proposal on the surface; mark nothing decided. ADR and glossary ratification still waits for explicit human signoff (step 9).
• End with the durable grill record ready for resumption.