Introducing FLYWHEEL.md 🌀

Agentic coding just crossed a line. Claude Code, Cursor, Codex, OpenClaw, the list keeps growing, and they all run fully autonomous now: /loop, /goal, crons. Agents that ship software around the clock. That is incredible power, and we have to use it responsibly. **Andrej Karpathy**'s AutoResearch showed the loop for ML research: an agent that runs experiments overnight, keeps what works, with no human in the loop. **FLYWHEEL.md** is that same loop, applied to shipping real software, where you keep a human at the gates that matter. Writing code was never the hard part. The hard part is everything after: shipping it, proving it works in production, learning what broke, improving. That is a loop. The agent repo is converging on a small canon: • **AGENTS.md**: what to do • **SOUL.md**: who to be • **FLYWHEEL.md**: how to ship, and how to know you did **FLYWHEEL.md** is not a "definition of done" checklist. It is your loop, with gates. Each stage says: done when \_\_\_, and: does the agent proceed, or wait for a human? It is one document that summarizes how you run the whole agentic pipeline: one file to review, manage, and update. The agent turns the wheel. You gate the turns that matter. A CLI, a model, and a web service each get a different loop. It is one file. MIT. Give your agents a wheel to turn, and a place to stop.