こんにちは、白々さじきです。
本番DB/開発DB分離の作業をClaude Codeに渡す前に、READMEを確認させようとしたときの話です。小さなつまずきでしたが、「完全委任でもツールの動作をある程度知っておくと詰まらない」という気づきがあったので書き残しておきます。
何をやろうとしていたか
本番DBと開発DBを分離する作業をClaude Codeに渡す前に、プロジェクトのREADMEを参照させてから進めようとしていました。「READMEある？」と聞いたのが始まりです。
教訓：大きな作業を渡す前にREADMEを確認させるのは良い習慣。ただし確認できているかどうかを人間側も把握しておく必要がある。
何が起きたか
Claude
CodeがGlobツールでREADME*パターンを使って検索しました。返ってきた結果がこちらです。
node_modules\.pnpm\eslint-plugin-react-refresh@...\README.md
node_modules\.pnpm\@types+react-dom@...\README.md
node_modules\.pnpm\@types+react@...\README.md
node_modules\.pnpm\vite@...\README.md
...（以下100件以上続く）
プロジェクトルートのREADME.mdはどこにも見当たらず、node_modules配下の各パッケージのREADMEで結果が埋め尽くされていました。
教訓：GlobツールはパスをREADME*のように指定するだけでは、node_modulesを含むディレクトリ全体を検索する。結果が多すぎてルートのファイルが埋もれる。
原因
GlobでREADME*パターンをパス指定なしで実行したため、node_modulesを含むプロジェクト全体が検索対象になっていました。このプロジェクトはpnpmを使っているためnode_modules内のパッケージ数が多く、結果が100件以上ヒットしてルートのREADME.mdが事実上見えない状態になっていました。
解決策
フルパスを直接指定して読み込むよう伝えたら即解決しました。
C:\Users\pc_name\Project\guided-scheduler\README.mdReadツールで絶対パスを直接渡すと、Globを使わずにファイルを読み込むため、node_modulesの件数に関係なく正常に取得できました。
教訓：特定のファイルを読ませたいときはGlobではなく絶対パス直接指定が確実。Globはパターンマッチが必要なときに使い、既知のパスには使わない。
学び
完全委任中でも「ツールの動作の仕組み」をざっくり知っておくと、謎挙動が起きたときに原因をすぐ特定できます。今回はGlobがnode_modulesを拾う仕様を把握していたので、「パス指定の問題だな」とすぐわかり、解決策も即答できました。
SIerの現場でも、ツールやフレームワークをブラックボックスとして使っていると、予期しない挙動に詰まったときの原因特定に時間がかかります。完全委任するにしても、使っているツールの基本的な動作は把握しておくべきだと改めて感じました。
サポートのお願い
下記リンクからお買い物いただけると、ブログ運営のための費用が増え、有料サービスを利用した記事作成が可能になります。ご協力よろしくお願いします！
コメント