ソフトウェア開発プロセスを開始するintent.mdは、さまざまな経路を通じて生まれます。人がアイデアを思いつく場合、チケットが起票される場合、あるいはアラートを通じてインシデントが表面化する場合があります(ステージ6:維持を参照)。
人がアイデアを思いついたとき、その人はClaudeとブレインストーミングを行い、Markdown形式のプロト仕様書を作成します。従来のSDLCでは、同じ人がプロダクトチームのメンバーを説得し、一緒に、あるいは代わりにアイデアを文書化してもらう必要がありました。
Claudeが生成するプロト仕様書は人間が読める形式であり、バージョン管理され、次のステージですぐに利用できます。このプロト仕様書はintent.mdとして保存されます。
意図がイベントトリガーから生まれたものであれ、人から生まれたものであれ、適用される手順は同じです。プロダクトオーナーがエージェントによって書かれたintent.mdをレビューし、コミットする前に修正を加えます。
何が変わるのか
| 従来型 | AIネイティブ |
|---|---|
| アイデアは、バックログエントリ、ユーザーストーリー、ストーリーポイント、リファインメントミーティングを経てから、ようやく誰かが行動に移せるようになります。各引き継ぎのたびに所有権が移転するため、エンジニアリングに届く頃には、発案者が意図していた内容から何段階も離れたものになっています。 | 発案者はClaudeとブレインストーミングを行い、その結果を発案者自身の言葉でintent.mdというプロト仕様書として書き留めます。このアーティファクトには、何が求められているか、なぜそれが求められているか、どのような制約のもとでかが含まれます。繰り返し行われるプロセスはスキルとしてエンコードされます。 |
はじめに
- 前提条件:なし。
- インフラストラクチャ:エンジニアではない人々のためのClaudeアクセス(claude.aiまたはCowork)、合意された
intent.mdテンプレート、プロダクトオーナーが監視する、共有されバージョン管理された意図の保管場所。単一のプロダクトの場合、最もシンプルな保管場所はプロダクトリポジトリ内のintent/フォルダです。この設定により、アーティファクトの連鎖がそこから派生したコードのすぐ近くに保たれます。専用の意図リポジトリは、意図が多数のリポジトリにまたがる場合にのみオーバーヘッドに見合う価値があり、モノレポの場合はディレクトリとなります。ステージ3:構築のレガシーシステムのセクションでは、この保管場所が、すでに記録を保持しているJiraや要件管理ツールとどのように関連するかを扱っています。
この設定は、プラットフォームチームまたはエンジニアリングチームにとって一度限りの作業です。技術的なチームメンバーが意図の保管場所を立ち上げ、組織全体から多くの貢献者が参加することになるため、誰がそこに書き込めるかを決定する必要があります。
リポジトリが存在すれば、Gitの経験がない貢献者が直接Gitを使う必要はありません。代わりに、バージョン管理システム(例:GitHub)へのコネクタにより、Claudeがclaude.aiまたはCoworkから彼らに代わってMarkdownファイルをコミットできます。
実行方法
- 発案者は自分の言葉で問題をClaudeに説明します。発案者は、今日できないこと、そのアイデアによって影響を受ける人、より良い状態とはどのようなものか、あるいは対象外の範囲について説明してもよいでしょう。形式的な言葉遣いは必要ありません。
- アイデアが具体的になるまでブレインストーミングを行います。Claudeはアナリストが尋ねるような質問をします。範囲、ユーザー、制約、そして成功とは何かについてです。
- 組織のテンプレートを使って結果を
intent.mdとして書くようClaudeに依頼します。このテンプレートは、技術的なチームメンバーが設定し、リードが承認したスキルセットとしてエンコードできます。これには、問題、提案される成果、影響を受けるユーザーとシステム、制約、未解決の疑問点を含めることができます。 - 発案者はClaudeが誤解した点を修正します。
intent.mdを共有の保管場所にコミットします。作成者とタイムスタンプが記録に加わり、プロダクトオーナーがそこからアイデアを引き継ぎます。
実際の見え方
intent.md:
# Intent: claims status self-service
Author: J. Ortiz (claims operations). Status: draft.
## Problem
Customers phone the contact center to ask where their claim is.
Handlers spend roughly a third of call time on status-only queries.
## Proposed outcome
Customers see claim status, next step and expected date in the portal.
## Affected users and systems
Claims handlers, portal team, claims-core API.
## Constraints
No new PII in the portal session. Existing authentication only.
## Open questions
Do third-party loss adjusters need access too?ガバナンスに関する考慮事項
証拠となるのは、コミットされたintent.mdであり、作成者、タイムスタンプ、完全な改訂履歴が記載されています。これは意図の保管場所のGit履歴に記録されます。プロダクトオーナーが承認し、意図をステージ2:設計へと送る承認または却下の決定は、マージまたはクローズされたレビューとして記録されます。
測定方法
- 先行指標:最初の会話から
intent.mdがコミットされるまでの時間。これは意図の保管場所のGit履歴から読み取られ、作成者とタイムスタンプが記録されます。この時間が、数週間にわたる聞き取りとリファインメントのサイクルから数時間へと短縮されることが期待されます。 - 遅行指標:生存率、すなわちプロダクトオーナーがクローズするのではなくステージ2:設計へと受け入れる
intent.mdファイルの割合。承認または却下の決定は、アーティファクトのマージまたはクローズされたレビューとして記録されます。さらに、同じ変更に対する最初のspec.mdコミット後にintent.mdに加えられた変更の数も数えます。