Intent

Intentとは？

Intentは、エージェントを連携して仕様をコードベースと同期させながら変更を実装するための開発ワークスペースです。仕様を真実の源とし、エージェントが作業を完了するたびに更新することで、要件の進化に伴うプロジェクトのずれを防ぎます。

一般的なワークフローのほか、IntentはクロスサービスJWT認証に焦点を当てたデモでエージェント連携をサポートすると説明されています。その例では、別々のエージェントがシステムの異なる部分を担当し、一方が認証サービスでトークンの発行、リフレッシュ、取り消しを、もう一方がAPIゲートウェイでJWT検証ミドルウェアと関連動作を追加します。ページではワークスペースが分離されていること、IntentがApple Silicon対応macOSで利用可能であることも記載されています。

主な機能

• 仕様優先の開発ワークフロー： Intentは生きた仕様を真実の源として設計され、進化するコードベースと常に整合性を保ちます。
• 開発ワークスペース内でのエージェント連携： 複数のエージェントが連携して変更を実装し、作業を孤立したステップとして扱いません。
• 生きた仕様の同期： エージェントが作業を完了するたびに仕様が更新され、プロジェクトが要件からずれません。
• 分離されたワークスペース： 各ワークスペースは分離されており、同時進行の作業フローを分離します。
• エージェントベースの実装例（JWT認証）： デモではサービス間での連携実装を示し、認証サービスでのトークンライフサイクル作業とAPIゲートウェイでのJWT検証動作を例にしています。

Intentの使い方

1. 仕様を真実の源として開始。 実装したい機能や変更を仕様で定義します。
2. ワークスペースでエージェント作業を連携。 エージェントが同一ワークスペース内で異なる実装責任を担い、出力が仕様とつながります。
3. 仕様を同期させながら変更を実装。 作業完了時に生きた仕様がコードベースの実施内容を反映して更新されます。
4. 連携コンポーネント間の動作を検証。 クロスサービスJWT認証のようなシナリオでは、トークンライフサイクル責任（発行/リフレッシュ/取り消し）とゲートウェイ検証責任が連携作業でカバーされることを確認します。

ユースケース

• 要件進化時のずれ防止： 仕様変更時、Intentは実装進行中にコードと仕様を整合させます。
• クロスサービス機能実装： JWT認証デモは認証サービスとAPIゲートウェイ間の変更連携を示します。
• サブシステムごとの作業分割： エージェントに別領域（例: 一サービスでのトークン管理と他でのリクエスト検証）を割り当てつつ、単一の同期仕様下で進めます。
• 複数タスクの分離作業： 分離ワークスペースが同時変更の並行作業をサポートします。

FAQ

Q: Intentが解決する問題は何ですか？
A: 仕様を真実の源とし、エージェントが作業完了時に仕様をコードと同期させることでプロジェクトの「ずれ」を解決します。

Q: この文脈での「生きた仕様」とは？
A: 実装完了時に仕様が更新され、要件が現在のコードベースと整合を保ち、古くならない状態を指します。

Q: Intentは複数サービス間の作業を連携できますか？
A: はい。クロスサービスJWT認証デモでは、一方のエージェントが認証サービスでトークン発行/リフレッシュ/取り消しを、もう一方がAPIゲートウェイでJWT検証ミドルウェアと関連動作を担当します。

Q: ワークスペースは分離されていますか？
A: ページでは各ワークスペースが分離されていると記載されています。

Q: IntentはmacOSで利用可能ですか？
A: ページではApple Silicon対応macOSでの利用可能が記載されています。

代替案

• 従来の開発ツールによる仕様と実装のワークフロー： チームは、ドキュメントツールや標準的なバージョン管理慣行を使って、手動またはツール経由で生きているドキュメントや要件ファイルを同期させることができます。
• エージェントオーケストレーションフレームワーク： 専用の「開発ワークスペース」製品の代わりに、チームは自律的なワーカーを調整するエージェントオーケストレーションツールを使用し、独自の仕様同期プロセスを組み合わせることができます。
• 人間レビュー付きAI支援コード生成： プロンプトからコードを生成するツールは機能の実装を支援しますが、仕様同期はチームのレビューとドキュメント慣行で処理されます。
• CI/CDとコードレビューを使った手動クロスサービス実装： JWT認証のような調整された機能の場合、チームは標準的なエンジニアリングワークフローで各サービスに変更を実装し、コンポーネント間の整合性を確保できます。