DOCUMENTATION
Engineering Flow docs
An open-source workflow plugin for Codex CLI and Claude Code. Ordinary tasks keep their existing speed; the five full workflows load only when you invoke one by name.
What this is
Strong coding models already know these engineering techniques; the problem is that they apply them inconsistently, and the occasions they skip are usually the expensive ones. Engineering Flow targets a small number of those high-value failure modes. It does not take control away from you and it does not replace your project’s own instruction files. Each session automatically loads a compact set of engineering, completion, and safety rules. Anything heavier than that must be invoked by name.
How a session runs
- 01
New session
The minimal Engineering Core loads automatically. No planning, TDD, worktree, or release ceremony.
- 02
Ordinary request
Core only. A clear, routine task is handled directly at full speed.
- 03
Named workflow
The full workflow loads and owns the whole task, not just the message that named it.
- 04
Same-task follow-up
Ordinary replies continue the current phase — no need to repeat the token.
Choose a workflow
Choose by the situation you are in, not by how large the task looks.
| Situation | Workflow | Modifies code? |
|---|---|---|
| Feature, refactor, tests, or maintainability work | Develop | After your approval |
| Bug, regression, wrong output, intermittent fault, or slowdown | Diagnose | Only when you authorize a fix |
| A goal with no settled solution, or a design draft to refine | Code Design | No |
| Review a diff, branch, pull request, or uncommitted work | Review | No — strictly read-only |
| Continue in a new session or hand over to another agent | Handoff | No |
Boundaries that always hold
- Your current request, the project’s AGENTS.md / CLAUDE.md, and its authoritative documents always win.
- A full workflow is never loaded unless you name it. An unknown token triggers nothing.
- Explicit cancellation, switching workflows, or starting an unrelated task ends the inheritance.
- No workflow gains permission to commit, push, publish, open issues, install dependencies, or change global configuration.
Start here
Installation
Add the marketplace and plugin on Codex CLI or Claude Code, then verify it is enabled.
Quick start
Your first ordinary task, your first named workflow, and how approval actually works.
Design philosophy
Why ceremony is optional, why approval is explicit, and why nothing auto-triggers.
Design principles
The seven classical principles, and exactly which rule in this project encodes each one.