Claude Codeのハーネスは最初は2つでよい

みやっち氏の整理は、混同されやすい2つの概念を分けている。ナレッジとはAIに与える情報そのもので、判断基準やルール、方針、手順書を業務フォルダ内のmarkdownファイルとして保持する。同氏はこれを、戦略・マーケティング・営業・財務などの部門を持つ「AI会社」と呼ぶ。ハーネスとは、その中身をどう効かせるか——いつ読み込まれ、AIが従うかどうかを自分で判断できるか——である。

この区別が推奨される順番を決める。CLAUDE.mdは毎回のセッション開始時に全文が読み込まれるため、どこでも適用したいルールを置く場所であり、公式ドキュメントでは200行以内に収め、増えてきたら仕事固有の内容はSkillsに移すことが推奨されている。Skillsは通常、名前と説明だけが読み込まれ、本体は関連する作業が出てきたときや名前で呼び出されたときに読まれる。そのため、固まった手順を置く場所として自然なのだ。

みやっち氏はまた、ハーネスを7つのステップのうち6番目に位置づけている。ナレッジを整理しツールをつないだ後、スケジュールで動くルーティンの前である。同氏自身のルーティンは毎週日曜8時にYouTubeのレポートを生成するもので、会社サイトのアクセス分析は、方法とレポート形式が固まってからルーティンにした。同じ理屈がサブエージェントとフックにも当てはまると同氏は言う。仕事の型がはっきりする前に追加すると、止めるべきでない作業を止めたり、メインの会話にまだ必要なコンテキストを切ってしまったりする恐れがあるからだ。