DESIGN.md とは？AI時代の開発を劇的に変える「設計図」の書き方

Cursor契約者が Claude Desktop への乗り換えを検討する記事。IDE上での快適性を評価しつつも、ローカルファイルの RAG 処理と情報管理能力で Claude の可能性を評価。Obsidian × Claude の組み合わせで情報過多対策を実践予定。

ターミナルで動く AI コーディングツール「Claude Code」の実践的な使い方を解説。動作モード（Manual / Plan / Accept Edits / Auto）の選択、モデルの使い分け、CLAUDE.md によるプロジェクト管理、/init / /model / /usage などの頻出コマンド、GitHub 連携、セキュリティレビュー機能までを段階的に説明している。

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

紙の契約書をスキャンした画像から Claude Vision API を使って記入済みフィールドを自動読み取り、JSON で構造化データとして出力するパイプラインを Python で実装。Pillow による前処理（EXIF 回転補正、リサイズ）と pydantic によるバリデーションで、転記ミスなく DB 書き込みや CSV 生成に対応できる形に整える。