AIの最新情報はXなどで拾っていた。しかし、自分の手で回したことはほとんどない。
そんな筆者の目に、「ループエンジニアリング」という言葉が入ってきた。寝ている間にも実装が進む。そのイメージに、ロマンしか感じなかった。だから、やってみた。
対象は自分で育てているC++のゲームエンジン。知識を深めるために個人的に作っては壊すを繰り返していたプロジェクト。最新のC++26も採用し、本格的なものにアーキテクチャを刷新予定。ここにAIを載せるなら、「それっぽいコードが出る」だけでは足りない。
この記事は、その過程で学んだことを、プロンプト・ハーネス・ループの三層で整理した記録である。専門用語はあとからついてきた。最初は、もっと雑で、もっと手探りだった。
使用環境 / エディタ
初めて触るとき、いちばん迷うのは「どのサービスを使うか」だと思う。調べれば調べるほど選択肢が増え、決断が遠のく。
私は、とりあえず Cursor を選んだ。
悩んで考え続けるより、手を動かしたほうが確実に良いと私は思っている。ツール選定で完璧を狙うより、同じリポジトリでトライアンドエラーを積み上げたほうが良いと考えている。
回せッ!PDCAサイクルをッ!!
Cursor を選んだ結果として、次のような「置き場所」が自然にできた。
- いつも効くルール(依存方向、禁止事項、テストの回し方)
- タスク種別ごとの手順書(スキル)
- 設計の正本(memory)
- 長い作業の引き継ぎメモ(handoff)
後から振り返ると、これがそのまま「ハーネス」の骨格になった。ただし、最初からこう設計したわけではない。使っているうちに「また同じこと言ってるな」が増えて、置き場所が必要になっただけだ。
最初は何もわからない
Cursorを入れてみたはいいものの、何をすればいいのかあまりわかっていなかった。
それこそ最初はチャット欄に指示を書いて実装させるだけ。
分からないなら調べる?記事を見に行く?
いやいや、こんなのはAIに聞いてしまえばいい。
AIについて詳しいのはやはりAIだ。
それを活かして「これってできないかな?」をひたすら聞いて、可能なら実装させた。
RulesもSkillsも、自分で書いていない。
AIにすべて書かせ、Skillsを育てるSkillsまでもを作ってもらった。
ここが、初心者にとっていちばん大事な入口だと思う。完璧なプロンプトを覚える前に、「できないかな?」を投げる。返ってきた手順を試す。ダメならまた聞く。その繰り返しで、自分のプロジェクト専用のレールが育っていく。
プロンプトエンジニアリング(というより、言い方の工夫)
最初に想像していたプロンプトエンジニアリングは、「うまい一文を書く技術」だった。
実際に効いたのは、もっと生活感のあるものだった。
「やって」だけだと、すぐ迷子になる
たとえば最初はこう言っていた。
物理を入れて
するとAIは、それっぽいコードをたくさん出す。でも翌日見ると、どこまで終わったのか分からない。テストしたのかも分からない。別のチャットを開くと、前の文脈も消える。
そこで言い方を変えた。
まずやることリストを作って。1個ずつ進めて。終わったらチェックして。
これだけで、体感がかなり変わった。AIが「全部一気に頑張る存在」から、「リストを消化する存在」に見えてきた。
うまくいった言い方の型
初心者向けに、効いた型だけ書く。
-
ゴールを短く言う
「シーン保存できるようにしたい」 -
やり方はAIに聞く
「どう進めるのが安全?手順を出して」 -
リスト化させる
「タスクリストにして。小さく分割して」 -
1個ずつやらせる
「上から1個だけやって。終わったら報告して」 -
確認条件を足す
「テスト通るまで完了って言わないで」
難しい英語プロンプトは不要だった。大事なのは、「一気に全部」を禁止して、「小さく区切って報告させる」ことだった。
お願いより、止め方を書く
AIは善意でショートカットする。
- テストは後で、と言いながら進む
- 小さな修正だからこのままでいい、と判断する
- 「たぶん大丈夫」で完了にする
だから、だんだんこう書くようになった。
- まだ終わってないのに完了って言わない
- 勝手に本番ブランチを触らない
- 分からなくなったら止まって聞いて
プロンプトの上達とは、きれいに書くことではなかった。AIが暴走したときに戻れる言葉を増やすことだった。
タスクリストから始めた開発
ループの前に、もっと素朴な段階があった。それがタスクリスト運用だ。
なぜタスクリストが効くのか
初心者の自分と、AIの弱点は似ていた。
- 欲張りすぎる
- 途中で何をしていたか忘れる
- 「できた気がする」で次へ行きたくなる
タスクリストは、その両方を抑える。
具体的には、こんな感じでやっていた。
[ ] 現状の保存処理を調べる
[ ] 小さな設計メモを書く
[ ] 実装する
[ ] テストを回す
[ ] 結果を報告する
最初はチャットの中のチェックリストで十分だった。これがあるだけで、「いま何番目?」が分かる。AIにも自分にも効く。
タスクリストの限界
しばらくすると、次の問題が出た。
- チャットが変わるとリストが消える
- 複数の作業が混ざる
- 「前に直したはず」が追えない
- レビューやPRの単位が曖昧
つまり、タスクリストは「今日の作業」には強いが、「プロジェクトの履歴」には弱い。
そこで発展させたのが、GitHub issue だった。
その発展:issue を使うようにした
issue を使い始めた理由は、かっこいい開発フローに憧れたからではない。タスクリストが散らかったからだ。
issue 1個 = 仕事 1個
ルールを単純にした。
- やりたいことは、まず issue にする
- 1つの issue は、1回のPRで終わる大きさにする
- AIには「この issue をやって」と頼む
これで、チャットの気分依存が減った。
「昨日何言ったっけ?」より、「#196 をやって」のほうが強い。
issue があると、何が嬉しいか
初心者目線で言うと、嬉しいことはこれだけだ。
-
作業の置き場ができる
チャットに消えない -
完了の定義が書きやすい
「何ができたら終わりか」を本文に残せる -
AIへの依頼が簡単になる
長い説明の代わりに issue 番号を渡せる -
あとから振り返れる
何をマージしたかが残る
最初は「issueって正式なチーム開発のやつでしょ?」と思っていた。個人開発でも、AIと二人三脚するなら、かなり相性がよかった。
タスクリストから issue への進化
振り返ると、進化はこうだった。
チャットで「作って」
-> チャット内タスクリスト
-> issue に仕事を切り出す
-> issue を順番に消化する
-> その外側で方針ループを回す
いきなりループエンジニアリングには行けなかった。途中に「リスト化」と「issue化」があったから、ループが回るようになった。
ハーネスエンジニアリング(レールを敷く)
ループに憧れて始めたのに、いちばん時間を使ったのはハーネスだった。
ここで言うハーネスは、「AIが暴走しにくいレール」のことだ。
AIは賢い。だからこそ、檻が要る
賢いモデルほど、善意でショートカットする。だから、ルールを「お願い」ではなく「守らないなら止まれ」に近い形で置いた。
最初は自分で書けなかったので、AIに書かせた。
同じ失敗をまたしないように、ルールにして
次からこの手順で動くスキルにして
同じ指摘が二回出たら、自動化して
これを繰り返すうちに、リポジトリの中に「置き場所」が増えていった。
ハーネスの実体は、ファイルの置き方だった
| 層 | ざっくり言うと | 例 |
|---|---|---|
| Rules | いつも守ること | 依存方向、禁止事項、テストの回し方 |
| Skills | よくやる作業の手順書 | issueからマージまで、文字化け防止 |
| Memory | 設計の正解メモ | 何が実装済みか、何が足りないか |
| Handoff | 作業の引き継ぎメモ | 前回どこまで終わって、次は何をするか |
大事なのは、きれいなドキュメントを作ることではない。
次のAIが読んで、同じ失敗をしないことだ。
地味な事故ほど、レールになる
たとえば文字コード。このプロジェクトでは、ある文字が無言で ? に化ける事故があった。一度踏むと怖い。だから「書いたあと検証する」手順までスキルにした。
初心者ほど、派手なアーキテクチャより、こういう地味な再発防止が効く。AIは同じミスを平気で繰り返す。繰り返させない仕組みがハーネスだ。
テストは、感想ではなく結果
「動いた気がする」は危険語だった。
だから完了条件を単純にした。ビルドして、テストを回して、件数を報告する。それまでは完了と言わせない。
ハーネスの本質は、AIを賢くすることではない。AIの出力を、自分の品質チェックにつなぐことだ。
オーケストレーション(一人に全部やらせない)
ある程度回せるようになると、次の壁が来た。
一人のAIに、調査も実装もレビューも全部やらせると、どうしても甘くなる。自分で書いたコードを、自分で「問題なし」と言っているのと同じ空気になる。
そこで入れたのがオーケストレーションだ。難しそうな言葉だが、やっていることは単純だった。
要するに「役割分担」
一人の万能アシスタントに頼むのをやめて、役割を分けた。
- 調べる係
- 実装する係
- 壊し方を探す係(レッドチーム)
- テスト観点を見る係
- 最後にまとめる係
同じモデルでも、役割を変えて別々に動かす。親(自分のメインチャット)は、全部を自分でやらず、交通整理役に回る。
なぜ初心者に効くのか
初心者ほど、「AIがそう言っているから正しい」と思いやすい。
オーケストレーションは、その思い込みを壊すためにある。
たとえば、
- 実装担当「これでいけます」
- レビュー担当「依存方向が壊れてます」
- テスト担当「この確認が足りません」
と分かれて出てくると、「はい完成」で終わりにくい。面倒だが、その面倒さが品質になる。
親は薄く、子に仕事を渡す
長く一つのチャットで全部やると、途中から判断が溶ける。何を守る話だったのか、だんだん曖昧になる。
だから、大きな作業は子エージェントに渡し、親は次を見るだけにした。
- 今はどの issue か
- テストは通ったか
- 止めるべきか
オーケストレーションと聞くと高度に聞こえるが、初心者向けに言い直すとこうだ。
一人に全部やらせず、役割を分けて、親は進行管理に徹する。
ループエンジニアリング
ループエンジニアリングと書いたものの、私が行ったものは少しずれているだろう。
世間のイメージは、「寝ている間に全部やってくれる」に近い。私が作ったのは、もう少し地味で、もう少し厳格だった。
二重ループにした
外側(外周)は、方針から再方針までのサイクル。
方針を決める
-> issue を切る
-> 優先順位を付ける
-> issue を順番に消化する
-> まとめて振り返る
-> また方針に戻る
内側(内周)は、issue 1件をマージまで運ぶ手順。
issue確認 -> ブランチ -> 設計 -> 実装
-> テスト -> レビュー -> コミット -> PR -> マージ
つまり、「何を作るか」を回すループと、「どう出し切るか」を回すループを分けた。
止まらないことより、正しく止まること
自律で回すときは、毎回許可を求めなくても進めるようにした。ただし、危ないときは必ず止める。
- 方針と矛盾している
- レビューで重大指摘が残っている
- テストできない
- 何か壊しそう
「止まらないループ」は魅力的だが、個人プロジェクトでも、「壊す前に止まるループ」のほうが嬉しい。
だから、これは半自動だった
正直に言うと、完全放置ではなかった。
最初にレールを敷き、失敗をスキルに戻し、タスクリストを issue に育て、役割分担を入れ、そのあとに初めて「回せる」状態になった。
私がやったループエンジニアリングは、魔法のovernightではなく、品質チェック付きの半自動工場に近かった。憧れた姿とは少し違う。だが、朝起きて壊れたコードを見る恐怖より、朝起きて「次はこれ」と書かれた引き継ぎを見る安心のほうが、よほど欲しかったものだった。
おわりに
寝ている間に実装が進む未来は、確かに近づいている。ただしその本体は、すごいプロンプト一発ではなく、タスクリスト、issue、地味なハーネス、役割分担、そして正しく止まるループだった。