Claude Code が作業前にナレッジを検索・追加する手順

確定 AI活用 更新 2026-09-25
要点

作業前にサイト名・URL・作業内容・ツール・エラー文で search.ps1 を実行し、上位の必要なMarkdownだけ読む。再利用価値の高い確定事項・解決策だけを追加し、build-index.ps1 で索引を更新する。

作業前(毎回)

いきなり作業せず、次の語で検索する。主役は知識なので、まず作業内容・ツール・症状で探し、案件名は変更禁止事項などの確認に使う(2026-09-25 方針改定)。

  1. 作業内容・やりたいこと(例: スマホ 2列、公開、画像 修正)
  2. 使用ツール・AI(例: Astra、Elementor、WP-CLI、Claude Code、画像生成AI)
  3. エラー文や特徴的なキーワード
  4. 対象サイト名・URL(例: guidepocket、kumonosu)→ 案件固有の決定・変更禁止事項の確認
powershell -NoProfile -File .\knowledge\tools\search.ps1 "guidepocket WP-CLI 公開"
powershell -NoProfile -File .\knowledge\tools\search.ps1 "Astra 戻るリンク" -Top 5

追加する価値がある情報

再利用できる/また起きそう/案件の重要な決定/変更禁止事項/最終採用デザイン/原因特定に時間がかかったトラブル/独自の運用方法/公開・バックアップ・検査の方法

細かい作業ログ、一時的な数値、1回きりの確認結果は保存しない。

追加・更新の手順

  1. 既存ナレッジを検索し、同じ知識があればそのファイルを更新する(使った案件は used_in に追記。重複ファイルを作らない)。再利用できる知識は general / implementation / design / ai / troubleshooting / operations / integrations に置き、projects/ には案件固有の情報だけを置く。
  2. 新規なら knowledge/templates/ から種類に合うテンプレートをコピーし、適切なフォルダに置く(tools\new.ps1 でも作れる)。
  3. frontmatter(id・title・type・project・status・priority・keywords・related・updated・summary)を埋める。
  4. 別の観点からも参照したい場合は、本文を複製せず related と [[id]] リンクでつなぐ。
  5. powershell -NoProfile -File .\knowledge\tools\build-index.ps1 で index.tsv と INDEX.md を更新。
  6. powershell -NoProfile -File .\knowledge\tools\check.ps1 でリンク切れ・重複・必須項目を確認。