alicankiraz1/codexqb

CodexQB is a plugin for Codex, an AI coding environment, that adds a structured project planning workflow as a reusable skill called $codexqb. The idea is to give software projects a defined planning phase before any code gets written or changed, with each step producing documentation that persists in the repository and can be reviewed like normal project files. The workflow has four main steps. In the first step, CodexQB reads the current repository, then asks four questions: the project name, intent, target end state, and known constraints. For existing projects it reads the repo first and proposes defaults based on what it finds. The output is a main planning document saved under a Planner-docs folder. For projects that already have code, an optional autopsy step produces a separate report covering existing modules, placeholder items, technical debt, integration gaps, and readiness risks. In the second step, the main plan gets broken down into ordered phase folders, each with detailed sub-plan files. The third step is a quality audit that checks coverage, naming, ordering, structure, and implementation readiness without modifying any files. Only after the audit passes does CodexQB produce the fourth step: a text prompt you copy into a new Codex thread to begin actual implementation. This handoff is gated so planning and building stay in separate sessions, keeping the user in control of when work starts. CodexQB does not implement product features, run destructive commands, commit code, or write credentials into planning documents. It also includes a validator script and a Makefile target called make check for confirming that planning documents meet structural requirements before the implementation handoff is allowed. The plugin installs via Codex's repository marketplace with two commands listed in the README. It is released under the MIT license and includes GitHub Actions that run the same validation checks automatically on pushes to the main branch.