【ITニュース解説】Our coding agent prompts live in the ticket, reviewed like PRs
2026年10月21日に「Dev.to」が公開したITニュース「Our coding agent prompts live in the ticket, reviewed like PRs」について初心者にもわかりやすく解説しています。
ITニュース概要
コーディングエージェントへの指示(プロンプト)や生成コード、開発者のレビューやフィードバック、コスト情報など、作業の全履歴を開発チケットに集約する。チケットごとに独立環境で動くため、指示内容のレビューや改善、透明な履歴管理、効率的な開発が実現できる。
ITニュース解説
Oizomのソフトウェア開発チームは、AIを利用した「コーディングエージェント」を開発プロセスに組み込んでいる。このエージェントへの指示(プロンプト)とそれによって行われた作業の管理方法に、彼らは非常に独創的なアプローチを取り入れている。それは、開発者がエージェントに何かを依頼する際に使う「チケット」の中に、すべてのやり取りを記録するというものだ。この仕組みは、システム開発の効率性、透明性、そして学習効果を大きく向上させる可能性を秘めている。
開発者がエージェントに作業を依頼する際、特別な開発環境や専用のプロンプトウィンドウは必要ない。彼らは通常のタスク管理システムにおける「チケット」の中に、平易な英語で作業内容を記述し、そのチケットを「承認済み」というステータスにドラッグするだけだ。このチケットのテキストが、そのまま開発の「仕様書」となる。次に、「orch」と呼ばれるオーケストレーターが自動的に動き出す。orchは、そのチケット専用の孤立した開発環境(スタック)を構築する。このスタックには、関連する全てのソースコードリポジトリの専用ブランチ、バックエンドやフロントエンドのサービス、データベースのコピー、さらには作業結果を確認するためのプライベートなプレビューURLまでが含まれる。この専用環境の中で、コーディングエージェントは実際にコードを生成したり、設定を行ったりする。作業が完了すると、エージェントは作成した機能のプレビューリンクを元のチケットのスレッドに投稿し、チケットのステータスを「QAQC」(品質保証・品質管理)へと変更する。
開発者は、エージェントが提供したプレビューリンクを開いて、実際に機能が意図通りに動作するかをテストする。もし修正が必要な点や、追加したい要望があれば、開発者は同じチケットのスレッド内に返信としてそのフィードバックを記述し、チケットを再びエージェントに差し戻す。このとき、エージェントは以前の対話履歴や作業の文脈を全て記憶しているため、最初からやり直すことなく、前回の作業の続きから修正や追加作業を行うことができる。このように、初期の指示から最終的な完了に至るまでの全てのやり取り、つまり開発者の質問、エージェントの作業結果、それに対するフィードバック、そしてさらなる修正指示が、全て同じチケットのスレッド内に時系列で保存されるのだ。これにより、一連の開発プロセス全体が、後から誰でも簡単に追跡できる「会話記録」となる。
このシステムにおいて特に注目すべきは、開発者がエージェントに与える「プロンプト」自体がレビューの対象となる点だ。プロンプトが作業内容と紐付けられて全て記録されているため、チームリーダーは各メンバーがどのようにエージェントに指示を出しているかを具体的に確認できる。これは、ソフトウェア開発における「プルリクエスト」(他の開発者が書いたコードをレビューするプロセス)に似ている。一般的なプロンプトガイドが抽象的な「良いプロンプト」の例を示すのに対し、このシステムでは「このメンバーは特定の変更を依頼するのに、どのような言葉を使い、エージェントはそれに対して何を作り、最終的に満足するまでに何回やり取りが必要だったか」という具体的な事例を基に指導ができる。特定のメッセージを指して、「ここをこう変えれば、もっと早く正確な結果が得られたはずだ」といった実践的なコーチングが可能になるのだ。
さらに、各エージェントの作業(一連の指示に対する応答)にかかったコストも、その指示が書き込まれたスレッドの中に自動的に記録される。開発者は自分の指示がどれくらいの計算資源(コスト)を消費したのかを、その場で視覚的に確認できる。この透明性は、開発者の行動に直接的な影響を与える。コストが見えることで、開発者はより効率的で明確なプロンプトを作成しようと意識するようになる。例えば、曖昧な指示が何度も修正作業を発生させ、結果的に高コストになることが分かれば、次からはより具体的で一発で通るような指示を出すよう工夫するだろう。これは、コスト意識を高めながら、プロンプト作成スキルを向上させる効果的な仕組みと言える。
プロンプトと、それによって生まれた作業成果が常に一緒に記録されるという設計目標を達成するためには、チケットごとに完全に独立した開発環境(スタック)が不可欠だ。もし複数のチケットが同じ開発環境を共有していたら、それぞれの作業履歴や成果物が混ざり合い、どのプロンプトがどの成果物に対応するのかを正確に追跡することが困難になる。しかし、Oizomのシステムでは、各チケットが自身のソースコードブランチ、サービス群、そして開発データベースのコピーを持つため、そのチケットのスレッドは「何が要求され、その専用スタックで何が構築され、そのプレビュー上で何がテストされたか」という、完全に自己完結した記録となる。これにより、例えばあるチケットが長期間QA工程にとどまっていたとしても、他のチケットの進捗に影響を与えず、その履歴も他と混ざることなく一箇所に保持される。
この統合されたチケットスレッドは、単なるタスク管理ツール以上の価値を持つ。開発プロセスにおける全ての重要な情報が集約されているため、それはプロジェクトの「監査証跡」となる。具体的には、開発者からの初期要求、コーディングエージェントによって構築された機能、開発者によるテストとその結果、提供されたフィードバック、そして最終的にGitへのコミットやプルリクエストの承認・マージといった、全てのステップがこのスレッドに記録される。エージェントが関わらない最終的なデプロイプロセス(Gitへのプッシュ、CI/CDの実行、デプロイ、ヘルスチェック)の情報も、最終的にこの同じスレッドに戻って記録されるため、プロンプト、その結果、そしてレビューの過程全体が、一つのチケットの中で完全に完結するのだ。これにより、プロジェクトの透明性が飛躍的に向上し、後から問題が発生した場合の原因究明や、未来のプロジェクトのための学習データとして非常に価値のあるリソースとなる。
Oizomチームが構築したこのシステムは、AIコーディングエージェントを活用しながら、その指示と成果物を一元的に管理し、開発プロセスの透明性と学習効果を最大化している。プロンプトをプルリクエストのようにレビューし、コストを可視化することで、開発者個々のスキルアップを促し、最終的にチーム全体の生産性向上に貢献しているのだ。