blueprint-status

3 層アーキテクチャの内訳とともに、現在のブループリント設定状況を表示します。

このスキルを使用する場合

次の場合はこのスキルを使用します…	次の場合は blueprint-execute を使用します…
読み取り専用の状況レポート（PRD／ADR／PRP の件数、トレーサビリティ）が必要な場合	レポートだけでなく、次のアクションを自動検出したい場合
3 層アーキテクチャの内訳が必要な場合	FR／フェーズの進捗状況を確認するには、代わりに blueprint-feature-tracker-status を使用します
孤立したドキュメントや古くなった生成コンテンツを監査したい場合	実行可能な差分の調整には、代わりに blueprint-sync を使用します
対話なしで監査するために --report-only を指定して実行する場合	アップグレードが必要だとすでに判断している場合は、代わりに blueprint-upgrade を使用します

フラグ

フラグ	説明
--report-only	状況レポートを表示し、次のアクションを促さずに終了します

手順

1. blueprint が初期化されているか確認します：

   • docs/blueprint/manifest.json を探します
   • 見つからない場合は、次の内容を報告します：

     Blueprint not initialized in this project.
     Run `/blueprint:init` to get started.
     

2. マニフェストを読み取り、情報を収集します：

   • manifest.json を解析して、バージョンと設定を取得します
   • id_registry を解析して、トレーサビリティの指標を取得します
   • docs/prds/ 内の PRD の数を数えます
   • docs/adrs/ 内の ADR の数を数えます
   • docs/prps/ 内の PRP の数を数えます
   • ADR について、次の数も数えます：
     • ドメインタグが付いているもの（grep -l "^domain:" docs/adrs/*.md | wc -l）
     • 関係性の宣言（supersedes、extends、related）があるもの
     • ステータス別（Accepted、Superseded、Deprecated）
   • 作業指示書の数を数えます（保留中、完了、アーカイブ済み）
   • 設定されているルールのパスを解決します：jq -r '.structure.generated_rules_path // ".claude/rules/"' docs/blueprint/manifest.json
   • 設定されたパス（デフォルトは .claude/rules/）内の生成ルールの数を数えます
   • .claude/skills/ 内のカスタムスキルの数を数えます
   • .claude/commands/ 内のカスタムコマンドの数を数えます
   • .claude/rules/ ディレクトリの有無を確認します
   • CLAUDE.md ファイルの有無を確認します
   • docs/blueprint/feature-tracker.json の有無を確認します
   • フィーチャートラッカーが存在する場合は、統計情報と last_updated を読み取ります
   • マニフェストから task_registry を読み取ります（存在する場合）
   • 各タスクについて、スケジュール状況を計算します：
     • ok：スケジュール上の期限前です
     • due：スケジュール上、実行期限です
     • overdue：スケジュール期間を 1 回以上過ぎています（例：日次タスクが 2 日以上実行されていない）
     • disabled：enabled: false です
     • never：last_completed_at が null です（追跡されたことがありません）

3. アップグレードが利用可能か確認します：

   • マニフェストの format_version を現在のプラグインバージョンと比較します
   • 現在のフォーマットバージョン：3.3.0
   • マニフェストのバージョン < 現在のバージョンの場合、アップグレードが可能です

3a. モノレポのポートフォリオを更新します（v3.3.0+）：

• workspaces.role == "root" の場合、レポートの表示前に /blueprint:workspace-scan を実行して、workspaces.children とキャッシュされた統計情報を更新します。過去 1 時間以内にスキャン済みの場合はスキップします（last_scanned_at）。
• workspaces.role == "child" の場合、workspaces.root_relative_path を解決し、状況レポートで親を示します。ただし、スキャンは実行しません。

4. 生成コンテンツの状況を確認します：

   • マニフェスト内の生成ルールごとに、次の処理を行います：
     • 現在のファイル内容のハッシュを計算します
     • 保存されている content_hash と比較します
     • 状況を判定します：current（変更なし）、modified（ユーザーが編集済み）、stale（ソース PRD が変更済み）

5. 状況レポートを表示します：

   Blueprint Status
   
   Version: v{format_version} {upgrade_indicator}
   Initialized: {created_at}
   Last Updated: {updated_at}
   
   Project Configuration:
   - Name: {project.name}
   - Type: {project.type}
   - Stack: {project.detected_stack}
   - Rules Mode: {structure.claude_md_mode}
   
   Project Documentation (docs/):
   - PRDs: {count} in docs/prds/
   - ADRs: {count} in docs/adrs/
     - With domain tags: {count}/{total} ({percent}%)
     - With relationships: {count}
     - Status: {accepted} Accepted, {superseded} Superseded, {deprecated} Deprecated
   - PRPs: {count} in docs/prps/
   
   Work Orders (docs/blueprint/work-orders/):
   - Pending: {count}
   - Completed: {count}
   - Archived: {count}
   
   Three-Layer Architecture:
   
   Layer 1: Plugin (blueprint-plugin)
   - Commands: /blueprint:* (auto-updated with plugin)
   - Skills: blueprint-development, blueprint-migration, confidence-scoring
   - Agents: requirements-documentation, architecture-decisions, prp-preparation
   
   Layer 2: Generated ({structure.generated_rules_path or .claude/rules/})
   - Path: {structure.generated_rules_path} (default: .claude/rules/)
   - Rules: {count} ({status_summary})
     {list each with status indicator: ✅ current, ⚠️ modified, 🔄 stale}
   
   Layer 3: Custom (.claude/skills/, .claude/commands/)
   - Skills: {count} (user-maintained)
   - Commands: {count} (user-maintained)
   
   {If feature_tracker enabled:}
   Feature Tracker:
   - Status: Enabled
   - Source: {feature_tracker.source_document}
   - Progress: {statistics.complete}/{statistics.total_features} ({statistics.completion_percentage}%)
   - Last Sync: {last_updated}
   - Phases: {count in_progress} active, {count complete} complete
   
   {If workspaces.role == "root":}
   Monorepo Portfolio ({workspaces.children|length} workspaces, scanned {last_scanned_at}):
   | Workspace | Format | Progress | Phase |
   |-----------|--------|----------|-------|
   {for each child:}
   | {child.path} | v{child.manifest_format_version} | {child.cached_stats.complete}/{child.cached_stats.total} ({child.cached_stats.completion_percentage}%) | {child.cached_stats.current_phase or "—"} |
   
   {If workspaces.role == "child":}
   Workspace: child of blueprint at {workspaces.root_relative_path}
   
   {If task_registry exists:}
   Task Health:
   - derive-plans        last: {age}  schedule: {schedule}  status: {status}
   - derive-rules        last: {age}  schedule: {schedule}  status: {status}
   - generate-rules      last: {age}  schedule: {schedule}  status: {status}
   - adr-validate        last: {age}  schedule: {schedule}  status: {status}
   - feature-tracker-sync last: {age}  schedule: {schedule}  status: {status}
   - sync-ids            last: {age}  schedule: {schedule}  status: {status}
   - claude-md           last: {age}  schedule: {schedule}  status: {status}
   - curate-docs         disabled
   
   Traceability (ID Registry):
   - Total documents: {count} ({x} PRDs, {y} ADRs, {z} PRPs, {w} WOs)
   - With IDs: {count}/{total} ({percent}%)
   - Linked to GitHub: {count}/{total} ({percent}%)
   - Orphan documents: {count} (docs without GitHub issues)
   - Orphan issues: {count} (issues without linked docs)
   - Broken links: {count}
   
   {If orphans exist:}
   Orphan Documents (no GitHub issues):
   - {PRD-001}: {title}
   - {PRP-003}: {title}
   
   Orphan GitHub Issues (no linked docs):
   - #{N}: {title}
   - #{M}: {title}
   
   Structure:
   ✅ docs/blueprint/manifest.json
   {✅|❌} docs/prds/
   {✅|❌} docs/adrs/
   {✅|❌} docs/prps/
   {✅|❌} docs/blueprint/work-orders/
   {✅|❌} docs/blueprint/feature-tracker.json
   {✅|❌} .claude/rules/
   {✅|❌} CLAUDE.md
   
   {If upgrade available:}
   Upgrade available: v{current} → v{latest}
      Run `/blueprint:upgrade` to upgrade.
   
   {If modified generated content:}
   Modified content detected: {count} files
      Run `/blueprint:sync` to review changes.
      Run `/blueprint:promote [name]` to move to custom layer.
   
   {If stale generated content:}
   Stale content detected: {count} files (PRDs changed since generation)
      Run `/blueprint:generate-skills` to regenerate.
   
   {If up to date:}
   Blueprint is up to date.
   

6. 追加チェック：

   • 期限を過ぎたタスクがある場合は警告します（例：「メンテナンスタスクが3件期限を過ぎています。追いつくには /blueprint:execute を実行してください」）
   • feature-tracker.json が古い場合（最終更新から 1 日超過）は警告します
   • PRD が存在するのに生成済みルールがない場合は警告します
   • モジュール化されたルールが有効なのに .claude/rules/ が空の場合は警告します
   • 生成されたコンテンツが変更されているか、古い場合は警告します
   • feature-tracker.json が 7 日より前のものの場合（同期が必要）は警告します
   • TODO.md が前回の同期後に変更されている場合は警告します
   • ADR に問題の可能性がある場合は警告します：
     • 同じドメインに複数の「Accepted」ADR がある（競合の可能性）
     • ドメインタグのない ADR がある（競合を検出しにくくなります）
     • 双方向リンクがない（例：対応する superseded_by がない supersedes）
   • トレーサビリティチェック：
     • ID のないドキュメントがある場合は警告します（/blueprint:sync-ids を実行してください）
     • 孤立したドキュメントがある場合は警告します（GitHub issue に紐付いていないドキュメント）
     • 孤立した issue がある場合は警告します（リンクされたドキュメントがない GitHub issue）
     • リンク切れが検出された場合は警告します（参照先のドキュメントや issue が存在しません）

7. --report-only の場合：手順 5～6 のステータスレポートを出力して終了します。以下の対話プロンプトはスキップします。

8. 次のアクションを確認する（AskUserQuestion を使用）：

   状態に応じて選択肢を動的に作成します：

   • アップグレードが可能な場合 → 「v{latest} にアップグレード」を含めます
   • コンテンツが変更されている場合 → 「生成済みコンテンツを同期」を含めます
   • コンテンツが古い場合 → 「スキルを再生成」を含めます
   • PRD が存在するのに生成済みスキルがない場合 → 「PRD からスキルを生成」を含めます
   • スキルがあるのにコマンドがない場合 → 「ワークフローコマンドを生成」を含めます
   • CLAUDE.md が古い場合 → 「CLAUDE.md を更新」を含めます
   • feature tracker が存在するものの古い場合 → 「feature tracker を同期」を含めます
   • ADR に問題の可能性がある場合 → 「ADR を検証」を含めます
   • ID のないドキュメントがある場合 → 「ドキュメント ID を同期」を含めます
   • 孤立したドキュメントまたは issue がある場合 → 「ドキュメントを GitHub にリンク」を含めます
   • 期限を過ぎたタスクがある場合 → 「期限超過のメンテナンスタスクを実行」を含めます
   • 常に「開発を続ける」と「終了する」を含めます

   question: "What would you like to do?"
   options:
     # Dynamic - include based on state detected above
     - label: "Upgrade to v{latest}" (if upgrade available)
       description: "Upgrade blueprint format to latest version"
     - label: "Sync generated content" (if modified)
       description: "Review changes to generated skills/commands"
     - label: "Regenerate from PRDs" (if stale)
       description: "Update generated content from changed PRDs"
     - label: "Generate rules from PRDs" (if PRDs exist, no rules)
       description: "Extract project-specific rules from your PRDs"
     - label: "Update CLAUDE.md" (if stale or missing)
       description: "Regenerate project overview document"
     - label: "Sync feature tracker" (if feature tracker stale)
       description: "Synchronize tracker with TODO.md"
     - label: "Validate ADRs" (if ADR issues detected)
       description: "Check ADR relationships, conflicts, and missing links"
     - label: "Sync document IDs" (if documents without IDs)
       description: "Assign IDs to all documents missing them"
     - label: "Link documents to GitHub" (if orphans exist)
       description: "Create/link GitHub issues for orphan documents"
     - label: "Run overdue tasks ({N} due)" (if overdue tasks exist)
       description: "Execute overdue maintenance tasks"
     # Always include these:
     - label: "Continue development"
       description: "Run /project:continue to work on next task"
     - label: "I'm done for now"
       description: "Exit status check"
   

   選択内容に応じて：

   • 「アップグレード」→ /blueprint:upgrade を実行します
   • 「同期」→ /blueprint:sync を実行します
   • 「再生成」→ /blueprint:generate-rules を実行します
   • 「ルールを生成」→ /blueprint:generate-rules を実行します
   • 「CLAUDE.md を更新」→ /blueprint:claude-md を実行します
   • 「feature tracker を同期」→ /blueprint:feature-tracker-sync を実行します
   • 「ADR を検証」→ /blueprint:adr-validate を実行します
   • 「ドキュメント ID を同期」→ /blueprint:sync-ids を実行します
   • 「ドキュメントを GitHub にリンク」→ 孤立したものごとに、issue の作成またはリンクを確認します
   • 「期限超過のタスクを実行」→ 期限を過ぎたタスクに対して /blueprint:execute を実行します
   • 「開発を続ける」→ /project:continue を実行します
   • 「終了する」→ 終了します

出力例：

Blueprint Status

Version: v3.0.0
Initialized: 2024-01-10T09:00:00Z
Last Updated: 2024-01-15T14:30:00Z

Project Configuration:
- Name: my-awesome-project
- Type: team
- Stack: typescript, bun, react
- Rules Mode: modular

Project Documentation (docs/):
- PRDs: 3 in docs/prds/
- ADRs: 5 in docs/adrs/
  - With domain tags: 4/5 (80%)
  - With relationships: 2
  - Status: 3 Accepted, 2 Superseded
- PRPs: 2 in docs/prps/

Work Orders (docs/blueprint/work-orders/):
- Pending: 5
- Completed: 12
- Archived: 2

Three-Layer Architecture:

Layer 1: Plugin (blueprint-plugin)
- Commands: 13 /blueprint:* commands (auto-updated)
- Skills: 3 (blueprint-development, blueprint-migration, confidence-scoring)
- Agents: 3 (requirements-documentation, architecture-decisions, prp-preparation)

Layer 2: Generated (.claude/rules/blueprint/)
- Path: .claude/rules/blueprint/ (configured; default is .claude/rules/)
- Rules: 4 (3 current, 1 modified)
  - ✅ architecture-patterns.md (current)
  - ⚠️ testing-strategies.md (modified locally)
  - ✅ implementation-guides.md (current)
  - ✅ quality-standards.md (current)

Layer 3: Custom (.claude/skills/, .claude/commands/, .claude/rules/)
- Skills: 1 (my-custom-skill)
- Commands: 0
- Rules: 0 (user-maintained)

Feature Tracker:
- Status: Enabled
- Source: REQUIREMENTS.md
- Progress: 22/42 (52.4%)
- Last Sync: 2024-01-14
- Phases: 1 active, 2 complete

Task Health:
  derive-plans        last: 5d ago   schedule: weekly      status: due
  derive-rules        last: 3d ago   schedule: weekly      status: ok
  generate-rules      last: 1d ago   schedule: on-change   status: ok
  adr-validate        last: 4d ago   schedule: weekly      status: ok
  feature-tracker-sync last: 3d ago  schedule: daily       status: overdue
  sync-ids            last: 3d ago   schedule: on-change   status: ok
  claude-md           last: 2d ago   schedule: on-change   status: ok
  curate-docs         disabled

Traceability (ID Registry):
- Total documents: 22 (3 PRDs, 5 ADRs, 2 PRPs, 12 WOs)
- With IDs: 22/22 (100%)
- Linked to GitHub: 18/22 (82%)
- Orphan documents: 4 (PRD-002, ADR-0004, PRP-001, WO-008)
- Orphan issues: 2 (#23, #45)
- Broken links: 0

Structure:
✅ docs/blueprint/manifest.json
✅ docs/prds/
✅ docs/adrs/
✅ docs/prps/
✅ docs/blueprint/work-orders/
✅ docs/blueprint/feature-tracker.json
✅ .claude/rules/
✅ CLAUDE.md

Modified content detected: 1 file
   Run `/blueprint:sync` to review or `/blueprint:promote testing-strategies` to preserve.

Blueprint is up to date.