読み込み中

プロダクトオーナーがintent.mdを承認すると、Claudeはそれを受け取り、要件と設計の仕様書を作成します。これは、ブランド、セキュリティ、コンプライアンス、UXに関する組織のスキルによって導かれます。

プロダクトオーナーはその仕様書をレビューしますが、自分で書くことはありません。このプロセスの目標は、エンジニアリングチームが計画を立てられる仕様書を、懸念事項をフラグ付けした状態で作成することです。

フロントエンドの作業が最も分かりやすい例です。intent.mdが承認されると、プロダクトオーナーはintent.mdからClaude Designでデザインのモックアップを作成し、モックを反復改善した後、それをClaude Codeに書き出して構築します。

変わること

従来型AIネイティブ
要件と設計は、別々のチームが実行する別々のフェーズです。アナリストがアイデアを要件として形式化し、デザイナーがそれをデザインへと解釈し直します。この分離は責任の所在を明確にするために存在しますが、遅く、情報が失われやすいものです。両方のフェーズが単一のプロンプトセッションで行われます。Claudeはintent.mdを受け取り、組織のスキルによって制約された要件と設計の仕様書を作成し、懸念事項をフラグ付けします。

はじめに

  • 前提条件: ブランド、セキュリティ、コンプライアンス、UXのポリシーをスキルとして記述したintent.mdファイルを作成します。
  • インフラストラクチャ: Claudeへのアクセス権を持つプロダクトオーナー。エンジニアリングのスキルは不要です。

実行方法

  1. プロダクトオーナーは、組織のスキルが利用可能な状態でセッションを開き、intent.mdを添付します。
  2. プロダクトオーナーのプロンプトはintentを指し示し、制約を明示し、懸念事項のフラグ付けを要求します。最初は手動で実行し、その後組織レベルのスラッシュコマンドとして体系化します。そこから、intentホームでのintent.mdの承認をトリガーとし、マージ時に発火する非対話型ジョブを設定して、組織のスキルを読み込んだ状態でパスを実行し、spec.mdをプルリクエストとしてコミットします(CI/CDの手順はステージ5:デプロイで配管部分を扱います)。この時点から、プロダクトオーナーの最初の関与はレビューになります。
  3. 同じプロダクトオーナーが、アイデアに対して仕様書をレビューします。仕様書は提示された問題を解決しているか、intent.mdからの未解決の質問は回答されているか、あるいは引き継がれているか。
  4. フラグ付けされた懸念事項は、アナリストであればエスカレーションしていたであろう点なので、最初に取り組みます。プロダクトオーナーは、エンジニアリングが仕様書を見る前に、各懸念事項をそのポリシー所有者と共に解決します。
  5. spec.mdをintent.mdと一緒にコミットします。このファイルのペアは、何が求められ、何が決定されたかを記録します。
  6. プロダクトオーナーは、仕様書とintentを構築に進めるかどうかを決定し、組織がより高リスクと分類するものについては技術リードに相談します。この判断は常に人間のチームメンバーが行い、仕様書を承認することがステージ3:構築のプランモードの手順を開始させます。

実際の様子

プロンプト:

添付のintent.mdを読み、既存のコードベースへの統合のための要件と設計の仕様書を作成してください。利用可能なスキルを適用し、計画が当社のブランドガイドライン、セキュリティポリシー、UX標準に準拠するようにしてください。仕様書をspec.mdとして完全に文書化し、エンジニアリングチームに渡せる状態にしてください。懸念事項があれば明確に記述してください。特に、矛盾するポリシーを満たせない場合はその点を明記してください。

この例の背後にあるintent.mdは、顧客がポータルでクレームのステータスを確認できるようにしたいと考える保険会社のものです。ここで、claims-apiはポータルのバックエンドであり、claims-coreはクレームを保持する古い内部システムです。上記のプロンプトは、これを次のspec.mdに変換します:

markdown
# 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ログから直接これを得られます。