アクター一覧の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、本システムに関わるすべての人間アクター(関係者)を一覧化する文書。TOGAFのActor Catalog相当。BRDの下流に位置する成果物。後続の成果物であるプロダクト要求仕様書やユーザーストーリー一覧、C4モデルレベル1、C4モデルレベル2、L1シーケンス、L2シーケンスなど、様々な成果物から参照される。BRD策定後、アクター整理の段階で呼び出す。
d1-domain-definition-document
ドメイン定義書の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、本プロダクトを構成する業務領域(ドメイン)を網羅・分類する文書。問題空間(プロダクトが扱う業務領域)の整理であり、DDDにおけるBounded Context(解空間としての実装上の境界)とは別レイヤーで扱う。
BRDの下流に位置する成果物。後続のプロダクト要求仕様書、ドメイン要求仕様書群(各ドメインごとに1つ)など、様々な成果物から参照される。BRD策定後、ドメイン整理の段階で呼び出す。
含まれるファイル(2)
- SKILL.md6.4 KB
- template.md6.6 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
D1: ドメイン定義書
inputする成果物
| 成果物のパス | 内容 |
|---|---|
docs/D1.business-requirements/business-requirement-document.md | 上流のBRD(スコープ・対象業務・将来拡張性 等を参照) |
docs/D1.business-requirements/domain-definition-document.md | 既存ドメイン定義書(更新・レビュー時のみ参照。新規作成時は未存在) |
outputする成果物
| 成果物のパス | 内容 |
|---|---|
docs/D1.business-requirements/domain-definition-document.md | ドメイン定義書本体 |
使用するテンプレート
出力時は以下のテンプレートを読み込み、その章構成・分類軸・書き方ヒントに従う。
| テンプレートのパス | 内容 |
|---|---|
.claude/skills/d1-domain-definition-document/template.md | ドメイン定義書テンプレート(章構成・分類軸・書き方ヒント) |
新規作成時の振る舞い
新規作成時(docs/D1.business-requirements/domain-definition-document.md 未存在)は ユーザーへのヒアリングを行わず、上流の BRD と業界一般知識からドメインを抽出して直接生成する。
- BRD(
docs/D1.business-requirements/business-requirement-document.md)を読み込み、対象業務・スコープから 業務工程ドメイン候補 を抽出する。BRD の「スコープ」表に列挙された業務単位を起点にしつつ、スコープ表に明示されていない準備工程(顧客との初期対話・意向把握・要件聴取 等の最上流工程)および 事後業務 が業務として存在しないかを業界一般知識から検証する。BRD のスコープ表の粒度がそのままドメイン粒度になるとは限らない点に注意する - BRD・業界知識から、業務工程をまたがって参照される 横断ドメイン候補 を抽出する(顧客情報・商品マスタ・本人確認・反社チェック・電子署名 等)。「将来のビジネスの拡張性を担保するためのシステム的要求」セクションに記載の領域(マルチチャネル対応・データ活用基盤連携 等)も拾い上げる。規制対応系の領域(意向把握・情報提供・適合性原則・本人確認・告知 等)を扱うときは、「業務プロセスそのもの」(業務工程ドメインとして配置)と「証跡の収集・保全」(横断ドメインとして配置)に分けて捉え、両者を同一ドメインに混在させない
- 各ドメインを2軸で分類する:
- 区分: コア / サポート / 汎用(プロダクトの差別化に直結するか、業務上不可欠か、業界横断で汎用化されているか)
- 種別: 業務工程ドメイン / 横断ドメイン
- テンプレート(
.claude/skills/d1-domain-definition-document/template.md)の形式に従って書き出す。BRD・業界知識から確定できない値には要確認マーカーを付ける - 「ドメイン間の主な連携」(Mermaid 図)は、業務工程の前後関係(実線矢印)と横断ドメインへの参照関係(破線矢印)を主要な関係に絞って描く。BRD のスコープ表で業務フローが十分に表現されており、横断ドメインへの参照も「概要」列で読み取れる場合は省略してよい
留意事項
- 問題空間に留まる: 機能名・画面名・テーブル名・サービス名・API 名などは混入させない。これらは下流の PRD・ドメイン要求仕様書群・C4 モデル等に降ろす
- MECE性: BRD のスコープを過不足なくカバーする。業務工程ドメインだけでなく横断ドメインの取りこぼしに注意する。BRD スコープ表の業務単位粒度がそのままドメイン粒度になるとは限らないため、準備工程・事後業務の取りこぼし、および 規制対応領域における業務プロセス/証跡管理の混在 に特に注意する
- Bounded Context との混同を避ける: 本書は問題空間の整理であり、「1ドメイン=1サービス」「1ドメイン=1Bounded Context」を前提として設計してはならない。マッピングは下流フェーズで決定する
- BRD との整合性: 上流の BRD のスコープ・対象業務と整合させる
完成時のセルフチェック
執筆完了時に以下の観点で出力を検査し、不備があれば修正したうえで出力を完了とする。
- BRD のスコープを過不足なくカバーしているか(MECE に分解できているか)
- BRD スコープ表に明示されていない準備工程(初期対話・意向把握 等)・事後業務の取りこぼしがないか
- 業務工程ドメインだけでなく、横断ドメインも挙げられているか
- 規制対応系の領域で「業務プロセス」と「証跡管理」が同一ドメインに混在していないか(同一ドメインに2つ以上の異なる性質の責務を混在させない)
- 機能・画面・テーブル名・サービス名が混入していないか(問題空間に留まっているか)
- 各ドメインの区分(コア/サポート/汎用)がプロダクト戦略と整合しているか
{{や XXX のプレースホルダが残っていないか
下流への伝搬関係
作成・更新時は以下の下流成果物との整合を意識する:
| 下流成果物 | ドメイン定義書から何を引く |
|---|---|
| プロダクト要求仕様書(PRD) | スコープのドメイン分割の根拠、ドメインごとの戦略上の位置づけ(コア/サポート/汎用) |
| ドメイン要求仕様書群 | 各冊の構成単位(1ドメイン=1つ) |
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
ビジネス要件定義書(BRD)の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)の中でも最上流に位置する成果物であり、ドメイン定義書・プロダクト要求仕様書(PRD)本体・ドメイン要求仕様書群すべての根拠となる業務観点の要求文書。新規プロジェクト立ち上げ時の最初の成果物作成、戦略・スコープの大きな変更、KPI見直しのタイミングで呼び出す。
ドメイン共通要求仕様書の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、プロダクト要求仕様書(PRD)が方針・概念を扱うのに対し、本書は **3 ドメイン以上で横断的に効く具体的な要求(水準・方針・原則)** を集約する文書。**ドメイン要求仕様書群(個別)とは並列の関係にあり、横断的な水準・方針・原則は本書が単独で責務を持つ(=厳密な MECE。個別ドメインで言い換えない)。** 機能要求・非機能要求・UI/UX 方針・セキュリティ要求・データアクセス要求・法務/コンプライアンス要求 の各節を持つ。PRD・アクター一覧・ドメイン定義書 を上流とし、PRD策定後、ドメイン要求仕様書群(個別)の作成前に呼び出す。
ドメイン要求仕様書の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、プロダクト要求仕様書(PRD)を親文書とし、ドメイン定義書で定義された各ドメインごとに1冊作成される。**ドメイン共通要求仕様書(横断的な水準・方針・原則)とは並列の関係にあり、当該ドメイン固有の業務ルール・業務状態遷移・業務運用(イレギュラー対応)のみを扱う(共通要求と内容が重なる要求は本書に書かない=厳密な MECE)。** PRD・ドメイン定義書の策定後、ドメインごとの業務要求を具体化する段階で呼び出す。下流のユーザーストーリー一覧・ユースケース一覧・機能一覧(D2)・画面要件群(D2)・L1/L2シーケンス図の起点となる。
プロダクト要求仕様書(PRD)の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、方針・概念・体験設計・制約・受け入れ基準を扱う文書。具体的な横断要求(機能要求・非機能要求・UI/UX・セキュリティ・法務 等)は独立成果物のドメイン共通要求仕様書に集約し、PRD は要求 ID を持たない。BRD・アクター一覧・ドメイン定義書 を上流とし、BRD策定後、ドメイン共通要求仕様書の作成前に呼び出す。
画面コンセプト集の新規作成・更新・レビューを支援する。AI駆動開発成果物フローのビジネス要求(D1)に位置する成果物で、プロダクト全体の画面体験コンセプト(体験方向性・体験原則・トーン&マナー方針)と、それを体現する代表シーン2-3を、ビジネスサイドが議論・合意できるサイズに整理する文書。業界を問わず利用可能(業務アプリ・ゲーム・コンシューマー向けサービス・SaaS 等)。プロダクト要求仕様書(PRD)・アクター一覧・ユーザーストーリー一覧を上流とし、下流のワイヤーフレーム・画面遷移図・画面要件群(D2)の判断基準となる画面体験の方向性を定める。全画面の網羅は D2 画面要件群に降ろし、本書はコンセプトと代表シーンに集約する。PRD・ユーザーストーリー一覧の策定後、D2 画面要件群の作成前、もしくはデザイン会社への発注前に呼び出す。