gmickel/flow-next

Flow‑Next – AI を活用したコーディングエージェントワークフロー

概要 – Flow‑Next は、コード生成 LLM（Claude Code、OpenAI Codex、Cursor、Grok Build など）とリポジトリの間に位置するプラグインです。エージェントにバグ、機能、チケット、パフォーマンス問題の説明を与えると、Flow‑Next は完全な開発サイクルをオーケストレーションします。失敗するテストや受け入れ仕様を作成し、モデルに修正を書かせ、diff を異なるモデルファミリーにルーティングしてレビューし、テスト/ベンチマークを実行し、最後に各変更を元の基準にマッピングする pull request を開きます。すべての成果物（仕様、決定、レシート）は .flow/ ディレクトリに保存され、作業は監査可能なままです。

重要性 – 純粋な LLM 生成コードには、周囲の足場（明確な仕様、自動検証、独立したレビュー）が欠けていることがよくあります。Flow‑Next はこれらの欠けているステップを自動的に追加し、README によると、エージェント単独で実行する場合と比較して、納品速度が最大 2 倍、品質が 10‑50% 向上（隠れたテスト失敗の減少）します。

主な機能

• ルート選択 – 入力（バグ、機能、パフォーマンス要求、チケット）に基づいて、Flow‑Next は最小限のワークフロー（例：テストファースト、仕様ファースト、測定ファースト）を選択します。計画されたルートは flow --explain で確認できます。
• 仕様とテストの生成 – スタックトレースを失敗するテストに変換し、機能の番号付き受け入れ基準を作成し、リファクタリング前に特性テストを作成します。
• モデルファミリーレビュー – diff は、作成したモデルとは異なるファミリーのモデルによってレビューされ、盲点バイアスを減らします。
• 証拠とレシート – 各ステージは ran、skipped(reason)、failed(reason) を記録します。結果、測定、レビュー決定は .flow/ に保持されます。
• 自律モード – flow --auto（または --until=merge）は、人間のプロンプトなしで実行され、PR が承認されるまでレビュー、CI、マージをループします。
• マルチホストサポート – Claude Code、OpenAI Codex、Factory Droid、Cursor、xAI Grok Build、OpenCode、Meta Muse Code のプラグインとしてインストール可能で、ホスト固有のインストールコマンドがあります。
• CLI とドキュメント – flowctl は CLI を提供します。広範なドキュメント、Discord コミュニティ、公開の証拠ページがパフォーマンスの主張を裏付けています。

典型的なワークフロー

1. セットアップ – ホスト用のプラグインをインストールし、/flow-next:setup を実行して指示スニペットを書き、レビューモデルを選択します。
2. 呼び出し – /flow-next:flow <description>（または flow --auto）。Flow‑Next はルートを決定し、テスト/仕様を作成し、コードを生成し、検証を実行し、最初の人間の決定ポイントで停止します。
3. レビューと PR – 「PR を開く」と言うと、各変更を対応する受け入れ基準にマッピングする pull request を開きます。
4. ランディング – /flow-next:land <PR> は残りのレビュー/CI フィードバックを解決し、承認後に squash‑merge します。

証拠 – README は、Flow‑Next と素の Claude Code を比較した 170 回のエンドツーエンド実行のベンチマークを引用しており、バグ修正、小規模/大規模機能、Rust ケースで速度 1.1‑1.9 倍、品質 8‑48% の向上を示しています。

対象読者 – すでに LLM コーディングアシスタントを使用しており、仕様、テスト、独立したレビュー、自動 PR 処理を追加する反復可能で監査可能なパイプラインを望むチーム。モノレポ、マイクロサービス環境、レガシーコードベースで動作し、GitHub、GitLab、Jira と統合します。

ライセンスとコミュニティ – MIT ライセンス、オープンソース。プロジェクトは活発で（3 つの OS で CI、Discord、スポンサーリンク）、「awesome‑Claude‑Code‑workflows」コレクションにリストされています。