<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/optim-plans-logo-dark.svg">
<img alt="optim-plans" src="docs/assets/optim-plans-logo-light.svg" width="500">
</picture>
</p>
<h1 align="center">optim-plans</h1>
<p align="center">
Your planning loop and execution loop for agentic coding.
</p>
<p align="center">
<a href="https://github.com/Optim-Agent/optim-plans/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Optim-Agent/optim-plans/actions/workflows/ci.yml/badge.svg" /></a>
<a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=square" /></a>
<img alt="Python" src="https://img.shields.io/badge/Python-3.11%2B-blue?style=square" />
<img alt="Status" src="https://img.shields.io/badge/status-active-brightgreen?style=square" />
<a href="https://code.claude.com/docs/en/skills"><img alt="Claude Skill" src="https://img.shields.io/badge/Claude-Skill-D97757?logo=claude&logoColor=white&style=square"></a>
<a href="https://developers.openai.com/codex/skills"><img alt="Codex Skill" src="https://img.shields.io/badge/Codex-Skill-blue?logo=openai&logoColor=white&style=square"></a>
<img alt="Repo views" src="https://hits.sh/github.com/Optim-Agent/optim-plans.svg?label=repo%20views" />
</p>
<details>
<summary><strong>It may be your best planner ever.</strong></summary>
all you need is a planning loop and an execution loop
both are elegantly featured in optim-plans
plans stay reviewable
execution stays gated
agents stay pointed at the work that matters
</details>
optim-plans turns "build me something" into a reviewed Markdown plan, records the decisions that shaped it, and keeps execution behind explicit approval. It gives Claude and Codex the two loops agentic coding actually needs: a planning-refining loop that keeps asking until the plan is real, and an execution loop that builds, verifies, and records what happened.
The T