sustackx0/simflow

SimFlow is a plugin that adds a structured development workflow to Claude Code and Codex, two AI coding assistants. Instead of building a project ad hoc, it walks you through a full lifecycle: understanding an idea, building it, testing it, reviewing it against a written spec, and debugging problems, while trying to keep the process light rather than adding a lot of extra steps. The plugin is organized around eight skills that each cover one stage of that lifecycle. The understand skill talks through a new idea with you, challenges assumptions, and writes a specification document before quizzing you to confirm you agree with it. The build skill breaks a spec into tasks and implements them one at a time, asking you to review and confirm each piece. Iterate handles changes to existing code with a lighter version of the same process. Dispatch sends independent tasks to multiple agents at once so they run in parallel. Test runs the existing test suite, finds gaps in coverage, and writes new tests. Review checks the implementation against the spec and loops until everything matches. Debug walks through root cause analysis on a reported bug, confirms the cause with you, then applies and verifies a fix. Status gives a snapshot of where the project currently stands. You are not required to use these in a fixed order, and each skill can detect earlier outputs such as an existing spec file. Behind the skills sit five bundled agents with different underlying models. A planner agent built on Opus breaks specs into tasks, while Sonnet powered agents handle implementation, testing, and debugging, and a second Opus agent reviews the final work for spec compliance. Installation for Claude Code is three commands through its plugin marketplace system. For Codex, you clone the repository into a plugins folder and point the configuration at a hooks file. A stated policy of the project is that every commit SimFlow makes uses only your own configured git identity, with no added co-author attribution. The project is released under the MIT license.