wiki-ingest-all

wiki-ingest-all

現在の作業ディレクトリ ($(pwd)) にあるプロジェクトを網羅的に読み取り、claude-brain Wiki ($OBSIDIAN_VAULT/wiki/) に知見を書き込むスキル。

いつ使うか

• 既存プロジェクトの知見を 初めて Wiki に取り込む時 (backfill)
• プロジェクトの全体像を 1 回で Wiki に記録したい時
• 新しいプロジェクトを始めて、最初に構造を Wiki に固定したい時

同じプロジェクトに対して 2 回目以降の実行は 更新モード として扱い、既存ページを置き換えずに追記・補強する。

前提

• $OBSIDIAN_VAULT が設定され、$OBSIDIAN_VAULT/wiki/ が存在すること
• 現在のカレントディレクトリが対象プロジェクトのルートであること
• 初回実行なら、Wiki は空か最小限の状態を想定 (qmd/重複チェックはその前提で動く)

ワークフロー

Step 0: 環境確認と既存 Wiki 監査

最初に以下を全て実行する。1 つでも欠けたらユーザーに指示を仰いで中断。

# 0-1. Vault 確認
test -n "$OBSIDIAN_VAULT" || echo "ERROR: OBSIDIAN_VAULT not set"
test -d "$OBSIDIAN_VAULT/wiki" || echo "ERROR: wiki/ missing; run setup-vault.sh first"

# 0-2. プロジェクト名の決定
PROJECT_NAME=$(git config --get remote.origin.url 2>/dev/null | sed -E 's#.*/([^/]+)(\.git)?$#\1#' | sed 's/\.git$//')
test -n "$PROJECT_NAME" || PROJECT_NAME=$(basename "$(pwd)")
echo "Project: $PROJECT_NAME"

# 0-3. 既存 Wiki の監査 (重複回避のため)
ls "$OBSIDIAN_VAULT/wiki/projects/" 2>/dev/null
ls "$OBSIDIAN_VAULT/wiki/concepts/" 2>/dev/null
ls "$OBSIDIAN_VAULT/wiki/patterns/" 2>/dev/null
ls "$OBSIDIAN_VAULT/wiki/decisions/" 2>/dev/null
ls "$OBSIDIAN_VAULT/wiki/analyses/" 2>/dev/null
cat "$OBSIDIAN_VAULT/wiki/index.md"

判断: wiki/projects/${PROJECT_NAME}.md が既に存在する場合は 更新モード。新規作成ではなく既存ページに追記/補強する (既存内容を破壊しない)。

Step 0.5: qmd 検索 (利用可能な場合のみ)

qmd MCP ツール (mcp__qmd__query) が利用可能なら、プロジェクト名や主要ディレクトリ名で事前検索して既存の関連ページを発見する:

mcp__qmd__query(
  collection: "brain-wiki",
  searches: [{type: "lex", query: "<PROJECT_NAME>"}],
  intent: "find existing wiki pages about this project"
)

qmd が使えない/0 件でも失敗扱いにしない。Step 0-3 の ls だけでも重複回避は成立する。

Step 1: プロジェクト全体の俯瞰

以下を順に読む。node_modules, .git, dist, build, .next, .venv, pycache, target, vendor, .DS_Store は除外。

# ファイル全体像
git ls-files 2>/dev/null || find . -type f \
  -not -path '*/node_modules/*' \
  -not -path '*/.git/*' \
  -not -path '*/dist/*' \
  -not -path '*/build/*' \
  -not -path '*/__pycache__/*' \
  -not -path '*/target/*' \
  -not -path '*/.venv/*'