$ man context-wiki/taxonomy

基礎概念beginner

タクソノミー

ファイルの整理の仕方こそがコンテキストエンジニアリング


構造がコンテキストである

ファイルの整理の仕方がコンテキストエンジニアリングだ。リポジトリがめちゃくちゃなら、AI のアウトプットもめちゃくちゃになる。モデルが散らかったフォルダに混乱するからではない。散らかったフォルダは、モデルが必要なものを見つけられない、間違ったファイルを読み込む、コンテキストを完全にスキップすることを意味するからだ。予測可能な構造は予測可能な結果をもたらす。すべてのパートナーフォルダが同じサブフォルダ(research/、prompts/、workflows/、resources/)を持っていれば、Claude は ICP 定義、キャンペーンコピー、適格性判定プロンプトがどこにあるか正確に把握している。検索しない。推測しない。予測可能な場所に行ってファイルを読む。
パターン

私のリポジトリのタクソノミー

content/drafts/ は作業中のものを格納する。content/published/ は日付プレフィックス付きの公開済み記事を格納する。partners/{name}/research/ は ICP、ペルソナ、競合インテリジェンスを格納する。partners/{name}/prompts/ は Clay の適格性判定とリサーチプロンプトを格納する。partners/{name}/workflows/ はキャンペーンシーケンスとルーティングロジックを格納する。skills/ は再利用可能なすべてのワークフローを SKILL.md ファイルとして格納する。data/ はダッシュボードやプログレッション統計などの生成アセットを格納する。scripts/ は Python の自動化スクリプトを格納する。 すべてのフォルダに目的がある。すべてのファイルに予測可能な名前がある。Claude に「パートナーのリサーチを確認して」と言えば、すべてのパートナーで構造が同じなので、正確にどこを見ればいいか分かっている。この一貫性がタクソノミーだ。
プロのコツ

命名規則が重要な理由

日付プレフィックス付きの下書き:2026-02-16_topic-name.md。時系列で並び、Claude にいつ書かれたかを伝える。パートナーフォルダは小文字のスラッグ:partners/acme/、partners/contax/。スキルファイルは名前付きフォルダ内で常に SKILL.md:skills/deploy/SKILL.md、skills/tracker/SKILL.md。スクリプトはスネークケース:daily_scan.py、rpg_sprites.py。 命名規則は見た目のためではない。予測可能性のためだ。Claude がデプロイスキルを探す必要があるとき、skills/deploy/SKILL.md を見る。deploy-skill.md ではない。DeploySkill.md ではない。deploy.skill でもない。一つのパターン。毎回同じ。予測可能性が検索時間とハルシネーションによるファイルパスを排除する。
アンチパターン

アンチパターン:フラットなファイルの山

最悪なのは、すべてを一つのフォルダに放り込むことだ。ルートディレクトリに 200 ファイルあるリポジトリを見たことがある。サブフォルダなし。命名規則なし。ファイル名は「final_v2_ACTUAL.md」や「notes_old_backup.txt」。Claude にはそれを理解できない。あなたにもできない。フォルダツリーをたどって 5 秒以内にファイルを見つけられないなら、タクソノミーが壊れている。コンテンツを増やす前に構造を直すべきだ。整理された 20 ファイルのリポジトリは、散らかった 200 ファイルのリポジトリに勝る。

knowledge guide
See "Context" in Knowledge See "Agent" in Knowledge

関連記事
コンテキストリポジトリコンテキストエンジニアリングGitHub リポジトリグラウンディング
コンテキスト Wikiナレッジガイド
ShawnOS.ai|theGTMOS.ai|theContentOS.ai
built with Next.js · Tailwind · Claude · Remotion