プロダクトオーナーがintent.mdを承認すると、Claudeはそれを受け取り、要件と設計の仕様書を作成します。これは、ブランド、セキュリティ、コンプライアンス、UXに関する組織のスキル(新しいタブで開きます)によって導かれます。
プロダクトオーナーはその仕様書をレビューしますが、自分で書くことはありません。このプロセスの目標は、エンジニアリングチームが計画を立てられる仕様書を、懸念事項をフラグ付けした状態で作成することです。
フロントエンドの作業が最も分かりやすい例です。intent.mdが承認されると、プロダクトオーナーはintent.mdからClaude Design(新しいタブで開きます)でデザインのモックアップを作成し、モックを反復改善した後、それをClaude Codeに書き出して構築します。
変わること
| 従来型 | AIネイティブ |
|---|---|
| 要件と設計は、別々のチームが実行する別々のフェーズです。アナリストがアイデアを要件として形式化し、デザイナーがそれをデザインへと解釈し直します。この分離は責任の所在を明確にするために存在しますが、遅く、情報が失われやすいものです。 | 両方のフェーズが単一のプロンプトセッションで行われます。Claudeはintent.mdを受け取り、組織のスキルによって制約された要件と設計の仕様書を作成し、懸念事項をフラグ付けします。 |
はじめに
- 前提条件: ブランド、セキュリティ、コンプライアンス、UXのポリシーをスキルとして記述した
intent.mdファイルを作成します。 - インフラストラクチャ: Claudeへのアクセス権を持つプロダクトオーナー。エンジニアリングのスキルは不要です。
実行方法
- プロダクトオーナーは、組織のスキルが利用可能な状態でセッションを開き、
intent.mdを添付します。 - プロダクトオーナーのプロンプトはintentを指し示し、制約を明示し、懸念事項のフラグ付けを要求します。最初は手動で実行し、その後組織レベルのスラッシュコマンドとして体系化します。そこから、intentホームでの
intent.mdの承認をトリガーとし、マージ時に発火する非対話型ジョブを設定して、組織のスキルを読み込んだ状態でパスを実行し、spec.mdをプルリクエストとしてコミットします(CI/CDの手順はステージ5:デプロイで配管部分を扱います)。この時点から、プロダクトオーナーの最初の関与はレビューになります。 - 同じプロダクトオーナーが、アイデアに対して仕様書をレビューします。仕様書は提示された問題を解決しているか、
intent.mdからの未解決の質問は回答されているか、あるいは引き継がれているか。 - フラグ付けされた懸念事項は、アナリストであればエスカレーションしていたであろう点なので、最初に取り組みます。プロダクトオーナーは、エンジニアリングが仕様書を見る前に、各懸念事項をそのポリシー所有者と共に解決します。
spec.mdをintent.mdと一緒にコミットします。このファイルのペアは、何が求められ、何が決定されたかを記録します。- プロダクトオーナーは、仕様書とintentを構築に進めるかどうかを決定し、組織がより高リスクと分類するものについては技術リードに相談します。この判断は常に人間のチームメンバーが行い、仕様書を承認することがステージ3:構築のプランモードの手順を開始させます。
実際の様子
プロンプト:
添付のintent.mdを読み、既存のコードベースへの統合のための要件と設計の仕様書を作成してください。利用可能なスキルを適用し、計画が当社のブランドガイドライン、セキュリティポリシー、UX標準に準拠するようにしてください。仕様書をspec.mdとして完全に文書化し、エンジニアリングチームに渡せる状態にしてください。懸念事項があれば明確に記述してください。特に、矛盾するポリシーを満たせない場合はその点を明記してください。
この例の背後にあるintent.mdは、顧客がポータルでクレームのステータスを確認できるようにしたいと考える保険会社のものです。ここで、claims-apiはポータルのバックエンドであり、claims-coreはクレームを保持する古い内部システムです。上記のプロンプトは、これを次のspec.mdに変換します:
# Spec: claims status self-service
From: intent.md (J. Ortiz, claims operations). Status: ready for product owner review.
Skills applied: secure-api-review, brand-voice, portal-ux.
## Requirements
- R1. A signed-in customer sees status, next step and expected date for each open claim.
- R2. Status is one of four states: received, in review, approved, paid.
- R3. The response carries those three fields and nothing else.
- R4. What the customer sees is at most 60 seconds old.
## Design
- New endpoint GET /claims/{id}/status in claims-api, behind the gateway JWT.
- claims-api reads the claim from claims-core. The portal never calls claims-core.
- New StatusPanel on the portal claims page. It caches each answer for 60 seconds.
## How each constraint in the intent is met
| Constraint | Met by |
| :---- | :---- |
| No new PII in the portal session | R3. None of the three fields is tagged pii in the schema. |
| Existing authentication only | The gateway JWT. No new login, token or role. |
## Open questions from the intent
- Do third-party loss adjusters need access too? Not answered. Carried forward as concern 1.
## Areas of concern
1. Loss adjusters have no portal account. Giving them access breaks "existing
authentication only", so they are left out of this spec. Owner: security.
2. The portal-ux skill says every status shows a date. The brand-voice skill says
never to state a payment date as a commitment. I cannot satisfy both as written.
Proposed label: "Estimated date". Owner: compliance.
3. claims-core allows 50 requests a second. The 60-second cache should keep the
portal under that, but nobody has load tested it. Owner: claims-core team.要件には番号が付けられており、計画とレビューでそれらを引用できます。懸念事項2は2つのスキルを互いに対立させており、これはプロンプトがClaudeにフラグ付けするよう指示している種類の衝突です。
ガバナンスに関する考慮事項
ポリシーの衝突が数週間後のレビューで発見されるのではなく、仕様書が書かれている間に最新のポリシーが読み込まれ、適用されます。組織のスキルは仕様書に対する制約として適用されます。仕様書、それを生成したプロンプト、そして有効だったスキルのバージョンはすべてバージョン管理に記録されます。プロダクトオーナーは仕様書を承認し、フラグ付けされた懸念事項を指名されたポリシー所有者に振り分けます。
測定方法
- 先行指標: 同じ変更に対する
intent.mdのコミットとspec.mdのコミットの間の経過時間(2つのGitタイムスタンプ)を、従来の要件プラス設計のサイクルと比較します。 - 遅行指標: 構築開始後の要件の再作業。同じ変更に対する最初の
plan.mdコミットより後の日付を持つspec.mdコミットの数を数えます。Gitログから直接これを得られます。