AIに調査を頼むとき、自分の仮説を伝えてはいけない

AI コーディングアシスタントで実装したコードが動作しても、翌日に自分で読み直すと内容が追えない問題に直面。原因は使用ツールが「現在のファイルのみ」を参照しており、プロジェクト全体の依存関係や命名規則を無視していたこと。Cursor、Claude、GitHub Copilot、Amazon Q Developer など各ツールのコンテキスト認識範囲は異なり、プロジェクト構造に応じた選択が重要。

複数の観点（セキュリティ・保守性・スコープなど）を1回のプロンプトに詰め込むと、Claude などのモデルは注意を分配し指摘が浅くなる。対策として「1呼び出し1人格」設計を採用し、各人格に「担当外の指摘は禁止」と制約を明示することで、狭い領域内での検出力が向上する。コスト増加とリスクレベルに応じた使い分けの目安も示される。

プログラミング初心者が Claude と Codex を使い、英語・中国語の動画をその場で日本語字幕に翻訳する Chrome 拡張を開発。Chrome 内蔵の翻訳機能とローカルの Whisper で完全オンデバイス化し、外部 API への課金や動画内容の送信を排除。Manifest V3 での tabCapture 非対応や音声取得など複数の技術課題を getDisplayMedia で突破した実装記録。

プログラミング経験の浅い著者が Claude と Codex の支援を受けながら、Whisper で動画をローカル文字起こしし、ChatGPT 要約用にワンタップコピーできる Web アプリ「もじおこし」を制作。API キー管理やランニングコストゼロに保ちながら、バッファリング問題や HTTPS 制限といった技術課題を解決した実装記録。