これまでは、ghqでクローンしてきて、それをエディタで開いて、ブランチ作って、作業して、ということをやってきた。
claude codeを筆頭に、各種AIつかって作業していると、こっちも並列するか!となりがちで、そうなると今のやり方だと難しい。定番はgit worktreeを使って、作業ブランチ=作業フォルダを作成し、そこをAIに操作させる、というもの。それに対応するために、git worktreeのいい感じラッパーも色々ある。
- coderabbitai/git-worktree-runner: Bash-based Git worktree manager with editor and AI tool integration. Automates per-branch worktree creation, configuration copying, dependency installation, and workspace setup for efficient parallel development.
-
k1LoW/git-wt: A Git subcommand that makes
git worktreesimple - d-kuro/gwq: 🌳 Git worktree manager with fuzzy finder - Work on multiple branches simultaneously, perfect for parallel AI coding workflows 🍋
でも、そもそも、そういった作業すらもAIにまかせたらいいのでは?と最近は思っている。つまり、これらをAIに全部任せる。
- 作業スペースの準備(リポジトリのクローンやブランチ作成を含む)
- 実際の作業を進める
- テスト、lint
- コミット
- 必要に応じて人が介入
そう思って出来たのが、これ: https://github.com/sters/complex-ai-workspace
元々は複数リポジトリにまたがる作業をいい感じに〜と思っていた。
複数リポジトリにまたがる複雑なタスクをclaudeにいい感じに進めてもらいたい
けれども、別に複数リポジトリ扱わないときでもただのワークスペースツールとしてガンガン使えばいいじゃんと思ってきた。
で、このツールは「そういったワークスペース操作に関するSkill」+「作業を進めるAgent」という構造になっている。具体的には次のように動作する:
/init-workspace {やりたいこと}でワークスペースを準備repositoriesに必要なリポジトリをクローンworkspaceにディレクトリ作成、リポジトリのworktreeを作成ワークスペースに目標を書いたREADMEと、やるべきことを書いたTODOを作成してくれる
/execute-workspaceで開始必要に応じてAgentが立ち上がり、TODOを消化していってくれる
/create-prでPRが作られる
—2026-01-31追記—
AgentsとSkillsを全体的に見直して、命名に統一感を作り、構造も整理した。
/workspace-init {やりたいこと}でワークスペースを準備- repositoriesに必要なリポジトリをクローン
- workspaceにディレクトリ作成、リポジトリのworktreeを作成
- ワークスペースに目標を書いたREADMEを作成
- workspace-repo-todo-planner と workspace-todo-coordinator のエージェントを起動してリポジトリごとのTODO整理
/workspace-executeで作業を開始- workspace-repo-todo-executorのエージェントが起動して、リポジトリごとにTODOを進めてくれる
- lintやtest、コミットもやってくれる
/workspace-review-changesで変更点についてセルフチェック- workspace-repo-review-changesのエージェントが起動して、リポジトリごとに変更点をレビューしてくれる
- workspace-collect-reviewsのエージェントが起動して、レビュー結果を整理してくれる
/workspace-create-prでPRが作られる/workspace-update-todo {やりたいこと}を必要に応じて使うことでTODOを更新できる
—追記ここまで—
入力しなくても勝手に判断してやってくれることもある。バイブスでやっていける。
これって対話している部分=Manger、Agent=Workerという構造になるのでManagerのコンテキストは細かい中身に関与することがない(コンテキストも消費しない)のがいいところで、これによって、複数リポジトリにまたがるような実装も軽々こなすことができる。
やることを最初に整理しているので、大きくズレることもない。細かい実装がおかしくね?というのはあるので、最初のやること整理をどれだけきれいにするかというのにも掛かっている。逆に、ある程度雑でも、完了したあとに、それをきれいにする、という別のやることを始めればいいだけでもある。/workspace-update-todoで途中で乱入もできるので、様子を見たときにちょっとまってこうしたい!も可能。
人が介入するにしても、作られたワークスペースに入って、エディタを開けばいいだけなので、そんなに難しいこともない。
今のところはチケットをモリモリ消化できて便利にやっている。困っていることもとくにない、かなあ。使いながら改善したり機能拡張したりしていきたい。