メインコンテンツへスキップ
見出し画像

人間がやってた開発フローを全部Skill化したら、ウォーターフォール開発に戻った

    こんにちは。ナイルの大浜です。

    AIエージェントを使った開発にも、そろそろ疲れが見えてきた頃ではないでしょうか。

    先日、AnthropicのCEOがAIの能力向上のペースを落とすべきだと業界に呼びかけました。同社の研究者がAI開発への懸念から抗議の退社をしたことも報じられています。

    このエンジニアリングブログでも「AIを使っているか、AIに使われているか」という記事が出ました。10分で終わるはずの修正が、AIのレビュー指摘に応え続けるうちに1時間を超えてしまった、という話が出てきます。

    身に覚えのある方も多いのではないかと思います。

    とはいえ、技術というものは、一度世に出てしまえば、それを使わなかった世界には戻れません。

    表計算ソフトが普及した後、経理の現場が手作業の検算へ戻らなかったのと同じです。

    AIエージェントも「使うかどうか」ではなく「どう付き合うか」に移っていくはずです。

    では、まさに今どう付き合えばよいのか

    開発プロセスとは、突き詰めれば「間違える実行者のために、人間が積み上げてきた工夫の集まり」です。

    要件定義書を書くのは、口頭の合意がすぐに忘れられるからです。コードレビューをするのは、書いた本人が自分の誤りに気づけないからです。テストを先に書くのは、「動いたつもり」を信用しないためです。どの工程も、実行する人間が間違えるという前提の上に立っています。

    では、AIエージェントはどうでしょうか。

    以前の記事でも書いたとおり、AIはよく指示を忘れます。加えて、決めていないことをそれらしく決めてしまうこともあります。しかも人間よりはるかに速く、大量に。

    つまりAIもまた、間違える実行者です。

    だとすれば、AIに開発を任せるときに必要なのは新しい魔法ではなく、人間が長い時間をかけて作ってきた、あの地味で退屈な手順のほうではないか。

    そう考えて、要件定義から設計、実装、レビュー、リリース、振り返りまで、人間がやっていた開発フローを全部Skillにしました。Claude Codeで/goal /ndf:development-workflowと打つと、AIがその流れを最後まで通します。人間が中身を見るのは、ほぼ「企画承認」の1か所だけです。

    この稿では、その仕組みと、1か月ほど運用してみて気づいたことを書いてみます。

    /goal /ndf:development-workflowとは

    このコマンドは2つの部品でできています。

    • /goalはClaude Codeのコマンドで、「この条件を満たすまで作業を止めない」ことを指示できます

    • /ndf:development-workflowはai-plugins(社内で開発しているClaude Code向けのプラグイン集)のNDFプラグインに含まれるSkillで、変更の中身を見て、どの工程を通すかを決めます

    NDFはai-pluginsの中心となるプラグインです。PRの運用やレビュー、実装計画、要求定義・テスト駆動・構造改善・完了判定といった開発の進め方そのものを、Skillとしてまとめています。Claude CodeだけでなくCodex・Kiro CLI・agyにも同じSkillを配っており、Claude Code向けには45個のSkillと8個の専門サブエージェントが入っています。

    development-workflowは、そのSkillたちを工程の順に呼び出す進行役にあたります。

    変更の種類は5つのモードに分けています。すべての変更にフルコースの工程を課すと、誤字を1つ直すためにも設計書が必要になってしまうからです。

    画像

    どのモードに当たるかもAIが判定します。実際に触るファイルを見て、上から順に当てはまるものを選ぶ仕組みです。

    いつもの開発フローを、そのままSkillにした

    standardモードの流れは次のとおりです。

    要求と受け入れ条件   requirements-design
      ↓
    設計               design
      ↓
    設計レビュー         pr → cross-review → 【企画承認】→ マージ
      ↓
    実装計画            implementation-plan
      ↓
    テストを先に書く実装  tdd-cycle
      ↓
    構造改善            cross-refactoring
      ↓
    実装レビュー         cross-review
      ↓
    完了判定 → PR → マージ  quality-gates / pr / merged
      ↓
    リリース            release(本番は【承認】)
      ↓
    リリース後テスト      release-verification
      ↓
    振り返り            retrospective

    見てのとおり、目新しいことは何もしていません。チームで当たり前に行ってきた流れを、工程ごとにSkillとして書き起こしただけです。

    重要なのは、どの工程にも担当のSkillがいることです。AIは次に何をすべきかをその都度考える必要がなく、人間の側も「今回はあの確認を飛ばしていないか」と心配する必要がなくなります。

    いくつか補足しておきます。

    • 構造改善のcross-refactoringは、複数のAIに改善案を出させ、別のAIが適用し、残りのAIがレビューします。新しい提案が出なくなるまでこれを繰り返します

    • 実装レビューのcross-reviewは、AIが書いたコードを別のAIたちに指摘が出なくなるまでレビューさせる仕組みで、前回の記事で紹介しました

    • 人間の承認で止まるのは、「設計PRのマージ」と「本番へのリリース」の2か所だけです

    流れの最後にある振り返り(retrospective)は、リリースの後に進め方そのものを見直す工程です。

    これとは別に、工程の外で動いているSkillが2つあります。

    • out-of-scope:作業中に見つけた「今回の範囲外の問題」を、その場でissueにする

    • issue-upkeep:溜まったissueを棚卸しし、現状とのずれを直したり、「やらない」と決めて閉じたりする

    振り返りとこの2つが、後で述べる気づきに深く関わってきます。

    ドキュメントも同じ流れで書ける

    documentationモードは、提案資料や報告書、マニュアルといった、人に渡す文書を作るためのモードです。

    骨格はstandardとほぼ同じで、違いは次のとおりです。

    • 設計の後に、数字や引用の出どころを確定させる工程が入る

    • テストを先に書く実装の代わりに、執筆の工程が入る

    • 構造改善の工程は通らない

    • リリースの後に、実際に描画して見た目を確かめる工程が入る

    ここでの企画承認は、構成案を載せた設計PRのマージにあたります。

    実のところ、本稿もこのモードで書いています。

    AIが構成案を作って設計PRを出し、2つのAIが3ラウンドにわたってレビューしました。「周辺のSkillとして紹介すると書いたcross-refactoringが、構成案のどこにも出てこない」といった指摘も、この段階で出ています。

    そのうえで企画承認に回ってきた構成案は、堅すぎたため差し戻されました。いまお読みいただいているのは、その後に作り直した構成案から書かれたものです。

    ai-plugins自体もこのやり方で育てている

    ai-pluginsの開発そのものも、/goal /ndf:development-workflowで回しています。

    development-workflowを導入したのが8月中旬で、そこから約1か月の間にマージしたPRは273本、NDFの版は6.1.0から10.12.0まで進みました。

    興味深いのは、Skillの不具合が、そのSkillを使っている最中に見つかることです。

    レビューの手順に穴があれば、レビューを回している最中にAIがそれに気づき、issueとして起票します。そのissueも同じ工程で直され、直ったSkillで次の開発が回ります。道具が、自分自身を使って自分を改良していく構図になっています。

    やってみて気づいたこと

    1か月ほど運用してみて、気づいたことが5つあります。

    AIに任せるなら、ウォーターフォール + TDDが一番安心できる

    人間同士の開発であれば、作りながら決めていくアジャイルな進め方のほうが合う場面は多いと思います。

    ところがAIに任せると、決めていないことをAIが勝手に、それらしく決めてしまいます。

    先に受け入れ条件と設計を固め、テストを先に書かせる。そうすればAIの出力は、「条件を満たしたか」「テストが通ったか」だけで判定できます。手戻りが起きても、どこで食い違ったのかがすぐに分かります。

    古くからあるウォーターフォールとTDDの組み合わせが、AIを相手にしたときに最も安心感のある進め方でした。冒頭の「間違える実行者のための工夫」という話は、ここに行き着きます。

    人間が見るのは、ほぼ企画承認だけ

    承認の関門は、あえて2つに絞っています。

    関門を増やすと、人間は次第に中身を読まずに通すようになります。承認の回数が増えるほど、1回ごとの重みが薄れていくためです。

    2つのうち、中身をしっかり読むのは設計PRのマージ、つまり企画承認です。

    ここさえ押さえておけば、その先はAI同士のレビューとテストがかなりの部分を拾ってくれます。逆に、ここで方向を誤ると、その後の工程はすべて、きれいに誤った方向へ進んでいきます。

    worktreeとマイルストーンで、並列開発が回る

    効果が大きかったのが、並列開発です。

    開発の変更は、worktree Skillが用意する作業ツリー(.worktrees/<ブランチ名>)の中で行います。作業ディレクトリがPRごとに分かれているので、複数のAIが同時に別の課題を進めても、互いの変更が混ざりません。

    そのうえで、マイルストーン単位で「このまとまりを進めて」と/goal /ndf:development-workflowに渡すと、課題の分け方や束ね方、どれを並べて進めるかはAIが判断します。並行して走った設計PRの企画承認も、1本ずつではなく、まとめて1回で済みます。

    たとえばv10.11.0では、前の版を出してから約1日の間に16件の課題を閉じ、33本のPRをマージしました。同時に開いていたPRは、多いときで9本あります。

    ただし、並列にするほど速くなるわけではありません。サブエージェントを5〜6本同時に走らせたときは、レビュー用のCLIやテスト用のコンテナも合わせてメモリを使い切り、全員がまとめて止まりました。いまは同時に3本までに抑えています。人間のチームと同じく、並列度にも適正値があるようです。

    振り返りとissueの棚卸しが効く

    フローを回し続けていると、2種類のずれが溜まっていきます。

    • 進め方のずれ:同じところで何度もつまずいている

    • issueのずれ:issueに書かれた内容が、すでに現状と合っていない

    前者を直すのが振り返り(retrospective)、後者を直すのが棚卸し(issue-upkeep)です。

    棚卸しのSkillを作ったとき、openだったissue 43件を1件ずつ実物と突き合わせたところ、24件の本文が現状とずれていました。半数を超えています。

    ずれたissueを渡されても、AIはずれたまま真面目に作業を進めます。人間であれば「これはもう直っているのでは」と気づくところです。

    out-of-scopeでissueは増え続ける。だから「やらない」を定義する。

    out-of-scopeは「迷ったら起票する」というルールで運用しています。後から閉じるほうが、見落としたものを拾い直すよりも安く済むからです。

    その結果、8月末からの2週間余りで起票されたissue 264件のうち、127件が範囲外の起票でした。およそ半分にあたります。

    AIは律儀なので、見つけたものはすべてissueにします。入口を広くした以上、出口も用意しなければなりません。

    そこで、棚卸しのSkillに「やらない」と決めて閉じる判断を持たせました。直す価値よりも抱えておくコストのほうが大きいものは、「こうなったら再び検討する」という条件を付けて閉じます。

    人間の仕事は「作る」ことから「やること・やらないことを定義する」へ移りつつある。

    まとめ

    人間がやっていた開発フローを全部Skillにし、/goal /ndf:development-workflowの1行でAIに通させるようにしました。

    AIもまた間違える実行者である以上、人間のために作られてきた開発プロセスは、そのままAIのためのプロセスとして機能します。運用してみて分かったのは、AIに任せる範囲が広がるほど、「先に決める」ことと「やらないことを定義する」ことの重みが増す、ということでした。

    • 先に決める:受け入れ条件と設計を固め、企画承認で方向を確かめる

    • やらないことを定義する:振り返りでやめる進め方を決め、棚卸しで「やらない」と決めたissueを閉じる

    開発フローを全部Skillにしても、人間が不要になるわけではありません。人間の役割が「作る」から「決める」へ移っていく、ということなのだと思います。

    ai-pluginsはGitHubで公開しています。興味を持たれた方は、ぜひ覗いてみてください。

    https://github.com/devbasex/ai-plugins

    あなたへのおすすめ