エージェントワークフロー

Forge

構造化されたタスク、依存関係の追跡、エージェントによる開発を操作する Web 画面を備えています。接続されたローカルワーカーが独立したワークツリーを準備して Codex を実行し、チェックとレビューを進めます。変更の公開と、人による承認後のリリースには Rail を使います。

Python
CLI
FastAPI
Pydantic
SQLAlchemy
Alembic
WebSocket
PostgreSQL
Git
Docker
CI/CD
GitHub Actions
Clean Architecture
Codex CLI
React
TypeScript
Vite

主な機能

依存関係、タスクグラフ、ステータス履歴、再利用可能な作成用プロンプトを備えた、プロジェクトと構造化されたタスク仕様。
ワークツリー、プロジェクトの指示、依存関係を準備し、Codex を実行するローカルワーカー。
ローカルチェックと GitHub CI の失敗をエージェントに返し、修正と再検証を実行。
Codex によるプルリクエストのレビューと、既存のエージェントセッションを継続できる人からのフィードバック。
Web 画面で段階ごとの履歴、結果、エラーを確認し、パイプライン全体または一段階ずつ実行。
Rail による Git ワークフローの管理。

技術設計

React の画面が、PostgreSQL を利用する FastAPI バックエンドに接続します。バックエンドは WebSocket でローカルワーカーに処理を割り当てます。ワーカーはタスク用ワークツリーで Codex を実行し、Git 操作には Rail、CI とレビューには GitHub を使います。

図を読み込み中…

開発ワークフロー

Web 画面でタスクを開始すると、ワークツリーの準備と Codex の実行が進みます。Rail が変更をチェックしてプルリクエストとして公開し、ローカルチェックや CI が失敗した場合はエージェントに修正を依頼できます。

Codex のレビュー指摘を実装エージェントに返して修正し、変更の公開と CI の検証を行えます。その後、人のレビューに応じて修正と検証を繰り返します。検証済みリビジョンを明示的に承認すると、Rail がマージ、タグ付与、後片付けを行います。自動で進めることも、一段階ずつ実行することもできます。

図を読み込み中…

Rail による Git ワークフロー

Forge がタスクの実行とレビューを管理します。Rail はワークツリーの作成、設定済みチェックの実行、プルリクエストの準備、承認済み変更のマージ、タグ付与、後片付けを担当します。同じ Git ワークフローを、Rail の CLI・Python API から単独で利用することもできます。

Rail — Git ワークフローの自動化