Claude Code が作業前にナレッジを検索・追加する手順
要点
作業前にサイト名・URL・作業内容・ツール・エラー文で search.ps1 を実行し、上位の必要なMarkdownだけ読む。再利用価値の高い確定事項・解決策だけを追加し、build-index.ps1 で索引を更新する。
作業前(毎回)
いきなり作業せず、次の語で検索する。主役は知識なので、まず作業内容・ツール・症状で探し、案件名は変更禁止事項などの確認に使う(2026-09-25 方針改定)。
- 作業内容・やりたいこと(例: スマホ 2列、公開、画像 修正)
- 使用ツール・AI(例: Astra、Elementor、WP-CLI、Claude Code、画像生成AI)
- エラー文や特徴的なキーワード
- 対象サイト名・URL(例: guidepocket、kumonosu)→ 案件固有の決定・変更禁止事項の確認
powershell -NoProfile -File .\knowledge\tools\search.ps1 "guidepocket WP-CLI 公開"
powershell -NoProfile -File .\knowledge\tools\search.ps1 "Astra 戻るリンク" -Top 5
- 結果の上位から、必要な Markdown だけ Read で読む。knowledge 全体を読み込まない。
criticalのルール(例: gp-noindex-rule)が出たら必ず従う。- status が
rejected/failed/deprecatedのものは履歴として扱う(確定事項の優先順位(最終・採用 > 案・試行、新しい明示指示が最優先))。
追加する価値がある情報
再利用できる/また起きそう/案件の重要な決定/変更禁止事項/最終採用デザイン/原因特定に時間がかかったトラブル/独自の運用方法/公開・バックアップ・検査の方法
細かい作業ログ、一時的な数値、1回きりの確認結果は保存しない。
追加・更新の手順
- 既存ナレッジを検索し、同じ知識があればそのファイルを更新する(使った案件は
used_inに追記。重複ファイルを作らない)。再利用できる知識は general / implementation / design / ai / troubleshooting / operations / integrations に置き、projects/ には案件固有の情報だけを置く。 - 新規なら
knowledge/templates/から種類に合うテンプレートをコピーし、適切なフォルダに置く(tools\new.ps1でも作れる)。 - frontmatter(id・title・type・project・status・priority・keywords・related・updated・summary)を埋める。
- 別の観点からも参照したい場合は、本文を複製せず
relatedと[[id]]リンクでつなぐ。 powershell -NoProfile -File .\knowledge\tools\build-index.ps1でindex.tsvとINDEX.mdを更新。powershell -NoProfile -File .\knowledge\tools\check.ps1でリンク切れ・重複・必須項目を確認。