chaseai-yt/grill-me-codex

This repository contains a set of skills for Claude Code, the AI coding assistant, that add a two-step review process before any code gets written. The idea is to address two weak points in AI-assisted development: first, making sure the AI and the developer agree on what is being built, and second, having an independent AI from a different company evaluate the plan before work begins. The first step, called Act 1, has Claude ask you a series of questions until the plan is fully defined and all decision branches are resolved. A variant called grill-with-docs-codex also checks the plan against a project glossary and records architectural decisions as the conversation progresses. Once the plan is locked, Claude writes it to a file called PLAN.md. The second step, called Act 2, feeds that written plan to OpenAI Codex, which is a separate AI tool from a different provider. Codex reviews the plan and returns either an approval or a list of objections. If it requests revisions, Claude updates the plan and sends it back for another round. This loop continues until Codex approves or until a maximum number of rounds is reached (five by default). Codex is restricted to read-only mode throughout this process, meaning it can only evaluate and critique, never write or change files. A log file called PLAN-REVIEW-LOG.md records the full round-by-round exchange. The rationale the README gives for using a second AI from a different company is that the model doing the planning and the model grading the plan are the same system, which creates a blind spot. A different provider is more likely to catch structural problems in the plan. Installation involves copying the skill folders into Claude Code's local skills directory and having the Codex CLI installed and authenticated separately via an OpenAI or ChatGPT account. The skills are invoked using Claude Code's slash-command interface. Act 1 was built on top of earlier work by Matt Pocock, Act 2 and the packaging were added by Chase AI. The project is MIT licensed.