blueprint-docs-list

ファイルシステムからブループリント文書をプログラムで一覧表示します。YAML フロントマターと Markdown の見出しからメタデータを抽出します。

このスキルを使う場合

次の場合はこのスキルを使います…	次の場合は blueprint-adr-list を使います…
ADR、PRD、PRP の統合インデックス（または全体の要約）が必要な場合	ADR 専用のインデックス表だけが必要な場合
すべてのブループリントの種類を対象に文書のステータスを監査したい場合	ドメインやステータスによるフィルタリングなど、ADR 固有のフィールドが必要な場合
all を使ってすべての文書タイプの件数をすばやく確認したい場合	README 用の ADR インデックスを生成する場合

ユースケース：文書のステータスを監査したり、インデックス表を生成したり、プロジェクトのすべてのドキュメントの概要をすばやく確認したりします。

パラメーター

引数	説明
adrs	アーキテクチャ決定記録を一覧表示します
prds	製品要件文書を一覧表示します
prps	製品要件プロンプトを一覧表示します
all	すべての文書タイプの要約

実行

引数が adrs の場合

/blueprint:adr-list を実行します。ADR 固有の抽出を処理し、ヘッダーセクションとフロントマターの両方に対応します。

引数が prds の場合

printf "| PRD | Title | Status | Date |\n|-----|-------|--------|------|\n" && \
for f in docs/prds/*.md; do
  [ -f "$f" ] || continue
  fname=$(basename "$f")
  [ "$fname" = "README.md" ] && continue
  doc_title=$(head -50 "$f" | grep -m1 "^title:" | sed 's/^title:[[:space:]]*//' || true)
  doc_status=$(head -50 "$f" | grep -m1 "^status:" | sed 's/^status:[[:space:]]*//' || true)
  doc_date=$(head -50 "$f" | grep -m1 "^date:\|^created:" | sed 's/^[^:]*:[[:space:]]*//' || true)
  # Fallback: extract title from H1
  if [ -z "$doc_title" ]; then
    doc_title=$(head -20 "$f" | grep -m1 "^# " | sed 's/^# //')
  fi
  printf "| [%s](%s) | %s | %s | %s |\n" \
    "${fname%.md}" "$f" "${doc_title:-(untitled)}" "${doc_status:--}" "${doc_date:--}"
done

引数が prps の場合

printf "| PRP | Title | Status | Confidence |\n|-----|-------|--------|------------|\n" && \
for f in docs/prps/*.md; do
  [ -f "$f" ] || continue
  fname=$(basename "$f")
  [ "$fname" = "README.md" ] && continue
  doc_title=$(head -50 "$f" | grep -m1 "^title:" | sed 's/^title:[[:space:]]*//' || true)
  doc_status=$(head -50 "$f" | grep -m1 "^status:" | sed 's/^status:[[:space:]]*//' || true)
  doc_confidence=$(head -50 "$f" | grep -m1 "^confidence:" | sed 's/^confidence:[[:space:]]*//' || true)
  if [ -z "$doc_title" ]; then
    doc_title=$(head -20 "$f" | grep -m1 "^# " | sed 's/^# //')
  fi
  printf "| [%s](%s) | %s | %s | %s |\n" \
    "${fname%.md}" "$f" "${doc_title:-(untitled)}" "${doc_status:--}" "${doc_confidence:--}"
done

引数が all の場合

各文書タイプの件数とステータスの内訳を表示します。

echo "## Blueprint Documents Summary"
echo ""
for doc_type in adrs prds prps; do
  doc_count=$(ls docs/$doc_type/*.md 2>/dev/null | grep -cv 'README.md' || echo 0)
  echo "### ${doc_type^^}: $doc_count documents"
  if [ "$doc_count" -gt 0 ]; then
    for s in Accepted Proposed Deprecated Superseded draft ready approved; do
      sc=$(grep -ril "^status:.*$s\|^$s$" docs/$doc_type/*.md 2>/dev/null | wc -l | tr -d ' ')
      [ "$sc" -gt 0 ] && echo "- $s: $sc"
    done
  fi
  echo ""
done

実行後のアクション

一覧表示の後、次を提案します。

• ディレクトリが空の場合：「文書を生成するには /blueprint:derive-plans を実行してください」
• 古い文書がある場合：「ステータスが 'draft' または 'Proposed' の文書を確認してください」