{
  "markdown": "# review-loop\n\n`review-loop` is a Claude Code plugin that drives a collaboration loop with Codex:\n\n1. **(Optional) Brainstorming** — If the `superpowers:brainstorming` skill is available, Claude Code can brainstorm requirements before designing.\n2. **Design stage** — Claude Code writes and iterates on a design while Codex audits it with full independent reviews each round.\n3. **Code stage** — After a user approval gate, Codex implements code while Claude Code reviews it.\n\nThe implementation follows [`specs/design.md`](specs/design.md), which was iteratively refined through 5 rounds of design review + a verification pass.\n\n## Layout\n\n- `review-loop/scripts/`: runtime scripts for background execution, polling, and cancellation\n- `review-loop/prompts/`: Codex prompt templates\n- `review-loop/commands/`: Claude Code slash-command documents\n- `review-loop/hooks/`: cleanup-only hook configuration\n- `tests/review-loop.test.sh`: self-contained shell test suite\n\n## Installation\n\n### Prerequisites\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed\n- [Codex](https://github.com/openai/codex) CLI installed and available on `PATH`\n- A Git repository with a clean working tree\n\n### Setup\n\n1. Clone this repository (or note the absolute path if you already have it):\n\n   ```bash\n   git clone https://github.com/Whisker17/claude-codex-loop.git\n   ```\n\n2. In the project where you want to use the plugin, add the plugin path to `.claude/settings.json` (or `.claude/settings.local.json`):\n\n   ```json\n   {\n     \"plugins\": [\n       \"/absolute/path/to/claude-codex-loop/review-loop\"\n     ]\n   }\n   ```\n\n3. Ensure the scripts are executable:\n\n   ```bash\n   chmod +x /path/to/claude-codex-loop/review-loop/scripts/*.sh\n   ```\n\n### Usage\n\nOpen Claude Code in your target project and run:\n\n```\n/review-loop <task description>\n```\n\nThis starts the full workflow:\n\n1. **Brainstorming (optional)** — If `superpowers:brainstorming` is available, you'll be asked whether to brainstorm first. Output is saved to `specs/brainstorm.md`.\n2. **Design stage** — Claude Code writes `specs/design.md`, Codex audits it iteratively (up to 5 rounds + optional verify pass). Each round is a full independent audit.\n3. **User gate** — You review and confirm the design before proceeding.\n4. **Code stage** — Codex implements the code, Claude Code reviews it iteratively (up to 5 rounds). Each round is a full independent review of the entire diff.\n\nAll changes are made on a dedicated `review-loop/<session-id>` branch.\n\nTo cancel at any time:\n\n```\n/cancel-review\n```\n\nCancellation discards all session work and restores the starting branch.\n\n### Marketplace\n\nThis plugin is available on the Claude Code plugin marketplace. You can also install it locally by pointing your project's `settings.json` to the plugin directory.\n\n## Verification\n\nRun:\n\n```bash\nbash tests/review-loop.test.sh\n```\n\n## Version History\n\n### v2.3\n\n- **Independent validation round** — a separate validation pass after design and code stages\n- **Marketplace plugin manifest** — `.claude-plugin/plugin.json` for official publishing\n\n### v2.1\n\n- **Optional brainstorming stage** with user opt-in when `superpowers:brainstorming` is available\n- **Fresh independent reviews** — every review round mandates a full audit; verify rounds strip all prior context\n- **Improved cancellation** — records `start_branch`/`start_sha`, restores starting point on cancel\n- **Session-scoped brainstorming** — `brainstorm_done` flag prevents stale artifacts from bleeding across sessions\n- **Protected brainstorm artifacts** — `specs/brainstorm.md` excluded from code-stage staging and diffs\n\nSee [`specs/design.md`](specs/design.md) for the current implementation spec.\n\n## Runtime Notes\n\n- The runtime scripts discover the project root by locating `.claude/review-loop.local.md`, so they can be called from subdirectories.\n- `REVIEW_LOOP_TIMEOUT_SECONDS` can override the default 20 minute Codex watchdog during tests or debugging.\n",
  "bytes": 3990,
  "sha": "27032853eeae00f99275d55fd27e0e11f0a2bacbfe595e4c6d221ac0050c3fb3",
  "repo_slug": "whisker17/claude-codex-loop",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_whisker17_claude_codex_loop_claude_codex_ffac5b5b/readme"
}