project-init について
SDD ワークフロー向けに新規プロジェクトを初期化するスキャフォールディングスキルです。ドメインを選び、文書用ディレクトリやインデックスを作成して、用語と適応設定を反映します。
主な機能
- 01プロジェクトのドメイン選択
- 02階層化された文書フォルダーの作成
- 03ドメイン用語マッピングの適用
- 04各レイヤーのインデックス生成
- 05適応設定の反映
活用シーン
- 01新規プロジェクトの SDD 文書を初期化
- 02ドメインに応じた文書用語の設定
- 03有効なレイヤーに合わせた構成調整
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ vladm3105/ aidoc-flow-framework --skill project-initインストール後、Claude Code で/project-initを入力して読み込まれたか確認します。
詳細
project-init
目的
SDD フロー用に新しいプロジェクトのひな形を作成します。ドメインを選択し、8 層のフォルダー構造とインデックスファイルを作成して、ドメイン用語を適用します。これはワークフローの実行前に一度だけ行う必要があるセットアップです。
レイヤー:横断的なユーティリティ(BRD より前に実施)。
使用するタイミング
次の場合に使用します:
- グリーンフィールドプロジェクトを開始する場合。
docs/構造がまだありません。 - ドメインがまだ選択されていない場合。
次の場合は使用しないでください:
docs/01_BRD/などがすでに存在する場合は、../doc-flow/SKILL.mdに進んでください。
動作
手順を順番に実行します。ドキュメントを作成する前にフォルダーを作成してください。
1. ドメインの選択(最初に実施)
プロジェクトの対象ドメインを尋ねて、選択内容を記録します。この選択は、手順 3 で適用する用語のマッピングに影響します。
| 選択肢 | ドメイン |
|---|---|
| 1(デフォルト) | 金融サービス |
| 2 | ソフトウェア/SaaS |
| 3 | ヘルスケア |
| 4 | E コマース |
| 5 | IoT |
| 6 | その他/汎用 |
2. フォルダー構造
8 つの成果物ディレクトリに加えて、サポートフォルダーを作成します。
mkdir -p docs/{01_BRD,02_PRD,03_EARS,04_BDD,05_ADR,06_SPEC,07_TDD,08_IPLAN}
mkdir -p docs/08_IPLAN/tmp plans
3. ドメイン設定
選択したドメインの用語マッピングを適用します(例:金融:
[RESOURCE_ITEM]→Position、[USER_ROLE]→Trader。ソフトウェア:
[RESOURCE_ITEM]→Resource、[USER_ROLE]→Account Admin。汎用:
[RESOURCE_ITEM]→Entity)。ドメイン固有のサブディレクトリがあれば作成します。
4. インデックスファイル
touch docs/01_BRD/BRD-00_index.md docs/02_PRD/PRD-00_index.md \
docs/03_EARS/EARS-00_index.md docs/04_BDD/BDD-00_index.md \
docs/05_ADR/ADR-00_index.md docs/06_SPEC/SPEC-00_index.md \
docs/07_TDD/TDD-00_index.md docs/08_IPLAN/IPLAN-00_index.yaml
後で作成する各成果物には、ドキュメント管理セクション(名前、バージョン、日付、所有者、ステータス、改訂履歴)を必ず含めてください。
5. 検証
8 つのディレクトリ、インデックスファイル、ドメインのサブディレクトリ、および plans/ が存在することを確認します。不足しているものがあれば、該当する手順を再実行してください。
6. 引き継ぎ
初期化の完了を報告し、doc-brd から始めるために ../doc-flow/SKILL.md に進むようユーザーに案内します。テンプレートは ${CLAUDE_PLUGIN_ROOT}/framework/layers/NN_<X>/ を参照します。プロジェクトへのコピーは任意です。
適応
ひな形の作成前に、プロジェクト適応プロファイル(.aidoc/profile.yaml)を読み込みます。active_layers に従い、有効なレイヤーの構造だけを作成してください。無効化されたスキップ可能なレイヤーのひな形は作成しないでください。未知のキーや対象範囲外のキーは無視してください。
権限の根拠:${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md。
関連リソース
- 次の手順:
../doc-flow/SKILL.md(doc-brdから開始) - レイヤーレジストリ:
${CLAUDE_PLUGIN_ROOT}/framework/registry/LAYER_REGISTRY.yaml - テンプレートと README:
${CLAUDE_PLUGIN_ROOT}/framework/layers/NN_<X>/ - 図:
../charts-flow/SKILL.md