░█▀▄░█▀▀░█░█░█░░░█▀█░█▀█░█▀█
░█░█░█▀▀░▀▄▀░█░░░█░█░█░█░█▀▀
░▀▀░░▀▀▀░░▀░░▀▀▀░▀▀▀░▀▀▀░▀░░

Spec-driven code/review loop that runs until all acceptance criteria are met and bugs fixed by agents.

$ curl -fsSL https://devloop.sh/install | bash

Requires Codex and Claude Code. Runs on macOS.

## WHY

Developers now spend most of their time in code review, assisted by coding agents. But the same model family can't both code and review. It favors its own outputs. Devloop makes Codex implement and Claude Code review adversarially (or vice versa), until all criteria are met and reviews addressed, so humans only come in where judgment pays off: at the spec and PR sign-off stages.

## HOW IT WORKS

• Spec: /devloop-spec skill generates a short markdown spec with a clear problem, outcome, acceptance criteria, and what's in scope as much as what's out.
• Code: Codex implements the spec in isolated git worktrees.
• Review: Claude Code runs /devloop-review against the spec to ensure all acceptance gates along with engineering gates (security, maintainability, correctness, simplicity, etc.) are met.
• Loop: Iterates on reject, stops on accept or max passes, and generates a PR ready for human review.

## SKILLS

Devloop ships two skills, installed for both agents:

• /devloop-spec: turns a rough idea, notes, a URL, or an interview into one concrete, devloop-ready spec.
• /devloop-review: judges each pass against the spec and engineering quality gates, returning ACCEPT, REJECT, or UNCLEAR with fix instructions.

## WHEN (NOT) TO USE

## FAQ