automagik-dev/genie

Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.

解決する課題

Genie は AI コーディングエージェント（Claude Code や Codex など）向けに設計された計画・実行レイヤーで、構造化されたマルチステップワークフローを通じて、曖昧なアイデアをマージ可能な Pull Request に変換します。ブレインストーミング、デザインレビュー、計画、独立実装レビューという厳格なシーケンスを強制することで「幻覚ループ」を防止します。

仕組み

Genie は Git ベースのドキュメントとローカル SQLite データベースを組み合わせて状態を追跡します。プロセスは以下のライフサイクルに従います：

  1. Brainstorming: アイデアを DESIGN.md ファイルに洗練させます。
  2. Wishing: デザインを実行グループを含むスコープされた WISH.md に変換します。
  3. Planning: 計画をレビューし、承認します。
  4. Work: ネイティブロールエージェントを派遣し、承認されたグループを並行して構築します。
  5. Review: エンジニアエージェントとは別の独立レビュアーエージェントが、受け入れ基準に対して実装を検証します。

作業状態は単一の .genie/genie.db ファイルに保存され、複数の Git worktree が同じタスク状態をバックグラウンドデーモンなしで共有できます。

対象者

AI コーディングエージェントを使用する開発者で、機能開発をより厳密かつ構造化された方法で行いたい、または計画と複数エージェントによる並行実行が必要な複雑タスクを管理したい方。

ハイライト

  • Git-native state: 願い事とデザインは Git でバージョン管理されるプレーンな markdown ファイルです。
  • Zero-daemon architecture: バックグラウンドプロセスや重いデータベース（Postgres など）は不要で、SQLite ファイルだけで動作します。
  • Warp Cockpit: 願い事の準備完了したグループを Warp ターミナルウィンドウで起動でき、各グループが自分の worktree で1ペインずつ表示されます。
  • Omni Bridge: Omni ハブを介して WhatsApp と統合し、リモート承認や短いタスクを実行できます。
  • MCP Server: 読み取り専用の Model Context Protocol (MCP) サーバーを提供し、タスクやボードの状態を他の AI ツールに公開します。