# codex-workflows

[](https://developers.openai.com/codex/cli) [](https://developers.openai.com/codex/skills/) [](https://opensource.org/licenses/MIT)

Repeatable software development workflows for [OpenAI Codex CLI](https://developers.openai.com/codex/cli) that keep scope and design decisions traceable through implementation, tests, and review.

Codex can implement a well-scoped task directly. codex-workflows is for changes where the harder problem is keeping analysis, design, implementation, and final verification aligned after the first answer.

Each phase delegates to task-specific subagents and hands off through explicit repository artifacts. The workflow inspects the existing codebase, selects the smallest sufficient process, pauses at decision boundaries, implements one task at a time, and checks whether the finished work still matches the agreed requirements.

---

## Quick Start

### Choose a path

| What do you need? | Start with | |---|---| | Deliver a backend, API, CLI, or general change end to end | `$recipe-implement` | | Complete a focused task without staged design handoffs | `$recipe-task` | | Design first and implement later | `$recipe-design` → `$recipe-plan` → `$recipe-build` | | Design and build a React / TypeScript web frontend | `$recipe-front-design` → `$recipe-front-plan` → `$recipe-front-build` | | Deliver a backend and React frontend change together | `$recipe-fullstack-implement` | | Review an implementation against its design | `$recipe-review` or `$recipe-front-review` | | Investigate a problem without changing code | `$recipe-diagnose` | | Run a throwaway experiment or one-shot script | Use Codex directly |

### Install and run

```bash cd your-project npx codex-workflows install ```

Then in Codex CLI:

``` $recipe-i