# flow-next

> Plan-first AI workflow plugin for Claude Code, OpenAI Codex, and Factory Droid. Zero-dep task tracking, worker subagents, Ralph autonomous mode, cross-model reviews.

- **URL**: https://www.freshcrate.ai/projects/flow-next
- **Author**: gmickel
- **Category**: Frameworks
- **Latest version**: `flow-next-v1.6.0` (2026-06-04)
- **License**: MIT
- **Source**: https://github.com/gmickel/flow-next
- **Homepage**: https://mickel.tech/apps/flow-next
- **Language**: Python
- **GitHub**: 572 stars, 41 forks
- **Registry**: github
- **Tags**: `ai-agent`, `ai-workflow`, `anthropic`, `autonomous-agent`, `claude-code`, `claude-code-plugin`, `cli`, `code-review`, `python`

## Description

Plan-first AI workflow plugin for Claude Code, OpenAI Codex, and Factory Droid. Zero-dep task tracking, worker subagents, Ralph autonomous mode, cross-model reviews.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `flow-next-v1.6.0` | 2026-06-04 | High | ### Changed - **Tracker-sync is now opt-OUT, not opt-in — hooking up the bridge activates the whole pipeline by default.** Previously every `tracker.perEvent.*` lifecycle touchpoint defaulted `off`, so after the discovery ceremony you had to opt each event in individually (fn-52 R1). That inverted the intent — connecting a tracker means you want it kept in sync. Now the `/flow-next:tracker-sync` discovery ceremony, on confirmation, **activates every lifecycle event by default**: capture / inter |
| `flow-next-v1.3.4` | 2026-05-27 | High | ### Fixed - **Review-output R-ID parser dropped single-letter suffixes (`R4a` / `R4b`)** — `parse_unaddressed_rids` extracted R-IDs from a reviewer's `Unaddressed R-IDs:` summary line (`_extract_rids`) and from the `## Requirements coverage` table fallback with bare `\bR(\d+)\b`. fn-49.1 (1.2.1) taught the *spec* acceptance-criteria parser the `R\d+[a-z]?` suffix form but left this *review-output* path behind, so a reviewer reporting `Unaddressed R-IDs: [R4a, R4b]` parsed to drop the suffixed I |
| `flow-next-v1.1.11` | 2026-05-22 | High | ### Fixed - **`flowctl init` no longer silently flips pre-1.1.3 users' `planSync.crossEpic` from on to off.** Caught while auditing `/flow-next:setup` against the dev repo (this fix's sibling 1.1.10 PR surfaced the `.flow/config.json` diff). Pre-1.1.3 users have `planSync.crossEpic: true` (the only key) in their on-disk config. 1.1.3 introduced `planSync.crossSpec: false` as the new canonical default, and the 1.1.3 read precedence is "canonical wins on presence". Without a pre-merge mirror, eve |
| `flow-next-v1.1.1` | 2026-05-16 | High | ### Fixed - **`install-codex.sh` now copies `templates/spec.md` (and any sibling top-level templates) to `~/.codex/templates/`.** 1.1.0 shipped the canonical spec template at `plugins/flow-next/templates/spec.md` and wired the `/flow-next:interview` skill to read it at runtime via `${CLAUDE_PLUGIN_ROOT}/templates/spec.md`, but the Codex installer only copied skill-scoped templates (ralph-init). Codex users on 1.1.0 hit a missing-file when invoking `/flow-next:interview --scope=business` on a ne |
| `flow-next-v1.0.2` | 2026-05-09 | High | ### Marketplace housekeeping - **Legacy `flow` plugin removed.** The original two-step planning + execution plugin (`plugins/flow/`) has been deleted from the marketplace; `flow-next` is now the only plugin shipped here. The legacy plugin had been unmaintained for ~10 months and never tagged a release — keeping it side-by-side with `flow-next` confused new users about which to install. Marketplace metadata (`.claude-plugin/marketplace.json`), `scripts/install-codex.sh`, `scripts/bump.sh`, and ` |
| `flow-next-v0.42.0` | 2026-05-07 | High | ### Added - **`/flow-next:make-pr` — PR-as-cognitive-aid skill.** New eighteenth slash command closes the gap between "all tasks done" and "human reviews the PR." Five phases (pre-flight → gather → build body → mermaid → push + create) render a reviewable PR body from rich flow-next state: epic spec with R-IDs, per-task `done_summary` + evidence commits, `decisions` / bug / `architecture-patterns` memory, glossary changes, strategy alignment, deferred review findings, and the diff itself. Body |
| `flow-next-v0.41.0` | 2026-05-02 | High | ### Changed - **CI smoke matrix expanded to 7 suites on ubuntu / macos / windows.** Beyond `ci_test.sh` (already in matrix), the workflow now runs `resolve-pr_smoke_test.sh`, `strategy_smoke_test.sh`, `audit_smoke_test.sh`, `glossary_smoke_test.sh`, `prospect_smoke_test.sh`, `impl-review_smoke_test.sh`, and `smoke_test.sh` on each OS leg. ~596 assertions per leg, ~260s runtime, matrix wall time ~4 min. `fail-fast: false` so one OS failure no longer cancels the others; `defaults.run.shell: bash` |
| `flow-next-v0.38.2` | 2026-04-27 | High | ### Fixed - **`flowctl.py` subprocess calls now pin `encoding="utf-8"` instead of defaulting to the system locale.** On Windows, `subprocess.run(input=prompt, text=True, ...)` decodes through `locale.getencoding()` — which is **cp1252** by default — so any prompt containing characters outside the cp1252 range (Unicode in git diffs, prototype/documentation files, non-ASCII commit messages) raised `UnicodeEncodeError: 'charmap' codec can't encode characters ...`. Setting `PYTHONIOENCODING=utf-8` |
| `flow-next-v0.31.0` | 2026-04-22 | High | ### Added - **Unified review backend spec parser** — `backend[:model[:effort]]` grammar accepted at every surface (env, config, per-task, per-epic, CLI flag). `parse_backend_spec()` + `BackendSpec` dataclass + `BACKEND_REGISTRY` (rp/codex/copilot/none) validate specs on store; invalid values rejected with helpful errors listing valid models/efforts. Legacy bare-backend values (`codex`, `copilot`, `rp`) still work unchanged. Unparseable strings on disk degrade to bare backend with a stderr warni |
| `flow-next-v0.29.4` | 2026-04-12 | High | ### Fixed - **rp-cli 2.1.6: builder output missing tab/context ID** — `cmd_rp_builder` and `cmd_rp_setup_review` now always pass `--raw-json` to builder (was conditional on `--response-type`). RP 2.1.6 removed the `Tab:`/`Context:` text line from plain-text output; IDs are only in JSON mode. JSON parse tried first, regex fallback for older RP versions. Closes #109. Thanks @berhanbero - **Python 3.12+ `datetime.utcnow()` deprecation** — replaced with `datetime.now(timezone.utc)` in `now_iso()` a |

## Citation

- HTML: https://www.freshcrate.ai/projects/flow-next
- Markdown: https://www.freshcrate.ai/projects/flow-next.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/flow-next/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._