Claude Codeは自分の問題を直せるか。+構成備忘録

前回の記事で、Claude Codeの「忘れる」問題と、記憶・トークン・スキルの関係を整理した。今回はその続き。「じゃあ実際に直してみよう」と思った話だ。

道具で道具を直す

Claude Codeは、コードを書いたりファイルを操作したりするためのAIツールだ。ということは、Claude Codeの設定ファイルやコマンドを作ることも、Claude Code自身にやらせることができる。

「記憶がない」という問題を、記憶がないClaude Codeに直させる。なかなかメタな状況だ。

でも実際にやってみると、意外とうまくいく。理由は単純で、Claude Codeは「今日の会話」を忘れるが「ファイル」は忘れない。だから、記憶の代わりになるファイルを作らせれば、結果的に記憶が持続する仕組みが作れる。設定ファイルに書いたことは、次のセッションでも読み込まれる。会話は消えても、ファイルは残る。

作ったもの(概念だけ書く)

一日でいくつかのコマンドとルールを作った。詳細の実装は省くが、概念として整理するとこうなる。

セッションを終わるときに「今日の作業を要約して保存する」コマンド。次に起動したときに「前回の続きを読み込む」コマンド。長い作業の途中で「今の状態を中間保存する」コマンド。全く新しい話をしたいときに「引き継ぎを無視して始める」コマンド。

加えて、毎回のセッション開始時に自動で読み込まれる「自分のプロフィールファイル」も作った。名前・使っているツール・好みのスタイルを書いておくと、毎回一から説明しなくていい。Gemini Gemsの「常時参照する指示書」に近い発想を、ローカルファイルで再現している。

作りながら気づいた別の問題

仕組みを整えていくうちに、想定していなかった問題が見えてきた。

ひとつは「スキルの管理」だ。Claude Codeには、特定の作業に特化した指示書を持てる「スキル」という仕組みがある。記事を書くスキル、法務チェックをするスキル、画像生成のスキル。これを増やしていくと、精度は上がる。でも「どのスキルをいつ使うか」という判断は、使う側に残り続ける。道具が増えると便利になるが、使い方を考える役割は消えない。

もうひとつは「ファイルの増殖」だ。記憶がないと、Claude Codeは「何がどこにあるか」をセッションごとに推測する。フォルダの使い分けルールが明文化されていないと、毎回少しずつ違う場所にファイルを作る。気づけば似たようなファイルが複数の場所に存在し、どれが正しいかわからなくなる。ファイル構造そのものも「記憶」だと気づいたのは、この問題に直面してからだった。

対策としてフォルダ構造を設定ファイルに明記した。「ブログ画像はここ、アルバムジャケットはここ」というルールをテキストで書いておくと、次のセッションからClaude Codeがそれを読んで従う。

この記事自体がメタだという話

今日の作業で、記事を書くためのスキルも作った。「テック体験記事ライター」として、執筆前にファクト確認を2往復して、それから書く、という手順を定義している。

そして前回の記事も、この記事も、今日作ったそのスキルで書かれている。

道具を作りながら道具を使って、その日の体験を同じ道具でまとめた。完全に解決したわけではない。セッションがクラッシュした瞬間は救えないし、スキルの組み合わせ方はまだ手探りだ。でも「AIツールの問題をAIツール自身に解決させる」という構造は、今後もっと一般的になっていくと思っている。

これからどうなるか

モデル自体が進化すれば、今日作った仕組みの一部は不要になるかもしれない。記憶の問題はツール側が吸収していく方向に進んでいると思う。

ただ「何を記憶させるか」「どう整理するか」という設計の判断は、しばらく使う側に残り続ける気がしている。ツールを「使う」から「設計する」に変わっていく感覚がある。

あなたは自分のAIツールを、どこまで設計していますか?

備忘録

.claude/

├── [Creative — art系]

│ │

│ ├── art-director 全体統括・方向決め

│ │ ◀▶ art-brief / art-trend-scout と相性◎

│ │ 先にこの2つを動かしてから指示を出す

│ │

│ ├── art-brief 前提整理・橋渡し役(起点)

│ │ ◀▶ 各 art 系スキルへ渡す前に必ず通す

│ │

│ ├── art-trend-scout デザイン・音楽トレンド調査

│ │ ◀▶ art-director と議論させる相性◎

│ │

│ ├── art-album-jacket ジャケット画像生成(Leonardo.ai

│ │ ◀ art-brief の出力を受け取る下流

│ │

│ ├── art-web-assets Web素材・ブログ画像生成(Leonardo.ai

│ │ ◀ art-brief の出力を受け取る下流

│ │ ◀▶ art-web-engineer と相性◎

│ │

│ └── art-web-engineer Web実装・コーディング

│ ◀▶ art-web-assets と組む(素材→実装)

├── [Publishing — 記事・コピー系]

│ │

│ ├── tech-blog-writer テック体験記事執筆(今日作成)

│ │ ▶ art-copywriter でタイトル磨き

│ │ ▶ art-legal-check で公開前チェック

│ │

│ ├── art-copywriter * コピー・キャッチコピー・説明文作成

│ │ ◀▶ art-legal-check と常にセット

│ │

│ ├── art-legal-check * 法務・著作権・誇大表現チェック

│ │ ◀▶ art-copywriter と常にセット

│ │

│ └── /copy-legal-loop ↑ 2つを自動でループさせるコマンド

├── [Knowledge RAG — /コマンド]

│ │

│ └── /extract → /structure → /tacit → /faq → /ask

│ 抽出 精緻化 暗黙知 FAQ 検索回答

└── [Session — /コマンド]

└── /resume /fresh /bye /checkpoint

前回再開 新規開始 終了保存 中間保存

* = agent(サブプロセスで独立して動く)

セットで使う組み合わせ(よく二人で会話させる)

┌───────────────────┬────────────────────────────────────────┐

│ ペア │ 使い方 │

├───────────────────┼────────────────────────────────────────┤

│ art-director ↔ │ トレンドを渡してディレクターが方針決定 │

│ art-trend-scout │ │

├───────────────────┼────────────────────────────────────────┤

│ art-copywriter ↔ │ コピー書いたら必ず法務に通す │

│ art-legal-check │ │

├───────────────────┼────────────────────────────────────────┤

│ art-brief → │ ジャケット前の情報整理 │

│ art-album-jacket │ │

├───────────────────┼────────────────────────────────────────┤

│ art-web-assets → │ 素材生成→実装 │

│ art-web-engineer │ │

├───────────────────┼────────────────────────────────────────┤

│ tech-blog-writer │ 記事→タイトル磨き │

│ → art-copywriter │ │

└───────────────────┴────────────────────────────────────────┘