blueprint-development

/blueprint:development

PRD（製品要件定義書）から、プロジェクト固有の動作ルールとワークフローコマンドを生成する Blueprint Development 手法のガイドとリファレンスです。

このスキルを使用するタイミング

このスキルを使用する場合...	代替手段を使用する場合...
プロジェクトで Blueprint Development を開始するとき	プロジェクトですでに Blueprint を使用している場合（/blueprint:status を使用）
PRD からルールを生成する必要があるとき	PRD のない新しいプロジェクトを開始するとき
プロジェクト固有の動作ガイドラインが必要なとき	汎用的な開発手法を使用するとき
プロジェクトのワークフローを自動化するとき	プロジェクトのコンテキストを必要としない個別タスクに取り組むとき

ルールテンプレート、コマンドテンプレート、生成ガイドラインの詳細については、REFERENCE.md を参照してください。

コンテキスト

• Blueprint の初期化状況：!find . -path '*/docs/blueprint/*' -maxdepth 3 -name 'manifest.json' -type f
• PRD の有無：!find . -path '*/docs/prds/*' -name "*.md" -type f
• ルールディレクトリ：!find . -path '*/.claude/rules' -maxdepth 2 -type d
• 既存のルール：!find . -path '*/.claude/rules/*' -maxdepth 3 -name "*.md"
• プロジェクトの種類：!find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' -o -name 'go.mod' \) -type f -print -quit

実行

Blueprint Development のセットアップとルール生成のワークフローをすべて実行します。

ステップ 1：プロジェクトの準備状況を確認する

上記のコンテキスト値を確認します。

1. Blueprint の初期化状況が「NO」の場合 → エラー：「Blueprint が初期化されていません。まず /blueprint:init を実行してください」
2. PRD の有無が「0」の場合 → エラー：「PRD が見つかりません。ルールを生成する前に、docs/prds/ に PRD を少なくとも 1 つ作成してください」
3. ルールディレクトリが「NO」の場合 → 作成：mkdir -p .claude/rules

ステップ 2：PRD を分析してパターンを抽出する

docs/prds/ にあるすべての PRD ファイルを読み、以下を抽出します。

1. アーキテクチャパターン：プロジェクト構造、依存性注入、エラー処理、モジュール境界、レイヤー構造、コード構成
2. テスト戦略：TDD ワークフロー、テストの種類（ユニット、統合、E2E）、モックのパターン、カバレッジ要件
3. 実装ガイド：機能の種類（API、UI、データベース、外部サービス）ごとの実装パターン
4. 品質基準：コードレビューのチェックリスト、パフォーマンスの基準、セキュリティ要件、スタイル基準

各カテゴリの具体的な抽出パターンについては、REFERENCE.md を参照してください。

ステップ 3：.claude/rules/ に動作ルールを 4 つ生成する

開発中の Claude の動作を導く、プロジェクト固有のルールを作成します。

必須のコアルール 3 つ：

1. architecture-patterns.md - プロジェクト構造、デザインパターン、依存関係の管理、エラー処理、統合パターン
2. testing-strategies.md - TDD ワークフロー、テスト構造、テストの種類、モックのパターン、カバレッジ要件
3. quality-standards.md - コードレビューのチェックリスト、パフォーマンスの基準、セキュリティ基準、スタイル、ドキュメント

任意の高度なルール 1 つ（該当する場合）：

4. implementation-guides.md - PRD に記載された特定の機能の種類を実装するための段階的なパターン

各ルールファイルについて：

• REFERENCE.md のテンプレートを使用する
• PRD から内容を直接抽出する
• コード例と具体的な参照情報を含める
• アーキテクチャ上の選択の根拠を記録する
• 命令形の表現（「使用する」「従う」「確認する」）を使う

効果的なルールを作成するための詳細なガイドラインについては、REFERENCE.md を参照してください。

ステップ 4：ワークフローコマンドを生成する

.claude/skills/ または docs/blueprint/ に、プロジェクト固有のワークフローコマンドを作成します。

6 つのコアコマンド：

1. /blueprint:init - Blueprint Development の構造を初期化します
2. /blueprint:generate-rules - PRD からプロジェクトのルールを生成します（主なエントリーポイント）
3. /blueprint:generate-commands - プロジェクトの種類に基づいてワークフローコマンドを生成します
4. /blueprint:work-order - サブエージェントの実行用に独立した作業指示書を作成します
5. /project:continue - 状態を分析して開発を再開します
6. /project:test-loop - 自動化された TDD サイクルを実行します

各コマンドについて：

• プロジェクトの種類と言語を特定します
• テストランナー、ビルドコマンド、開発ワークフローを抽出します
• REFERENCE.md を使用してコマンドの実装をカスタマイズします
• 想定される allowed-tools 権限で動作することを確認します

ステップ 5：マニフェストにマッピングを作成する

docs/blueprint/manifest.json を次の内容で更新します。

{
  "generated": {
    "rules": [
      "architecture-patterns.md",
      "testing-strategies.md",
      "quality-standards.md",
      "implementation-guides.md"
    ],
    "commands": [
      "blueprint-init.md",
      "blueprint-generate-rules.md",
      "blueprint-generate-commands.md",
      "blueprint-work-order.md",
      "project-continue.md",
      "project-test-loop.md"
    ]
  },
  "source_prds": ["project-overview.md"],
  "last_generated": "ISO-8601-timestamp"
}

これにより、自動生成されたものと手動で作成されたものを追跡しながら再生成できます。

ステップ 6：テストして検証する

ルールとコマンドが正しく動作することを確認します。

1. ルールの適用をテストする：開発中に Claude が architecture-patterns、testing-strategies、quality-standards に従うことを確認します
2. コマンドの実行をテストする：各コマンドを実行し、想定どおりに動作することを確認します
3. 出力品質を検証する：生成されたルールが PRD の要件に合致し、具体例を含んでいることを確認します
4. 必要に応じて調整する：フィードバックや実際のプロジェクト開発に基づき、ルールとコマンドを更新します

ステップ 7：結果と次のステップを報告する

概要レポートを作成します。

• 生成されたルール：.claude/rules/ に {count} 件
• 作成されたコマンド：{count} 件（開発を開始するには /project:continue を使用します）
• マニフェストを追跡メタデータで更新済み
• 次のステップ：
  1. 生成されたルールの正確性を確認します
  2. プロジェクト固有の追加事項や明確化事項を加えます
  3. /project:continue を実行して Blueprint Development ワークフローを開始します
  4. /blueprint:work-order を使用してチームメンバー向けの独立したタスクを作成します

Blueprint Development との統合

このスキルにより、Blueprint Development の中核となるワークフローを実行できます。

PRD（要件）- ルール（行動指針）- コマンド（ワークフローの自動化）- 作業指示書（独立したタスク）

PRD からプロジェクト固有のルールとコマンドを生成することで、Blueprint Development は、行動指針、パターン、品質基準を第一級の要素として扱う、自己文書化された AI ネイティブな開発環境を作成します。

GitHub 作業指示書との統合

作業指示書を GitHub の Issue にリンクすることで、透明性の高い協調開発が可能になります。ワークフローモード（--no-publish、--from-issue N）、ラベルの設定、完了ワークフロー、作業指示書のファイル形式については、REFERENCE.md を参照してください。

エージェント向け最適化

コンテキスト	アクション
ルールが存在するか確認する	find .claude/rules -maxdepth 1 -name "*.md" | wc -l
既存のルールを一覧表示する	ls -1 .claude/rules/*.md 2>/dev/null
PRD の数を数える	ls docs/prds/*.md 2>/dev/null | wc -l
PRD のセクションを抽出する	見出しのパターンを指定して、Grep で該当セクションを検索します
迅速に生成する	手動レビューの手順を省略し、標準テンプレートを使用して進めます

例

完全なワークフローのドキュメントと例については、.claude/docs/blueprint-development/ を参照してください。

---

詳細なルールのテンプレート、コマンドの例、抽出パターン、プロジェクト固有のカスタマイズについては、REFERENCE.md を参照してください。