Cursor Composer活用（複数ファイル編集を安全に）

学習ゴール

Composer（複数ファイルをまたぐ編集フロー）を、束ねるファイル数を制限しながら使える。
変更計画→部分適用→動作確認の順で、巻き戻しコストを管理できる。

前提知識

単一ファイルでのチャット編集に慣れていること。
Gitのブランチとコミットが分かると安全域が広がります（未習ならバックアップ必須）。

キーコンセプトと用語

マルチファイルパッチ：関連ファイルにまたがる一括提案。
プラン先行：どのファイルをどう変えるか文章化してから生成させる手法。
部分適用：提案のうち安全なチャンクだけ取り込む。
ブレークポイント：ここまでを一旦コミット/バックアップする区切り。

手順（ステップバイステップ）

トピックブランチを切るか、フォルダ丸ごとコピー。
目的と完了条件を1段落で書く（例：ヘッダーのリンク追加＋フッター同期）。
触ってよいパスを列挙し、それ以外は触らないと明示。
プラン生成：まず変更対象ファイルリストと概要diffを文章で得る。
小さな塊で適用：スタイル→マークアップ→スクリプトの順など依存の浅い順。
各塊でビルド/表示確認：壊れたらすぐ巻き戻し。
最終diffレビュー：ノイズや秘密情報が混ざっていないか。

実践ミニ演習

演習1：2ファイルだけの小機能（ナビ項目追加）でComposerを使い、触ったファイル数を記録。
演習2：プランのみ依頼→実行は別チャンクに分け、行数を比較。
演習3：意図的に禁止ディレクトリを書き、AIが守るか確認。

セルフチェックリスト

[ ] ブランチまたはバックアップがある
[ ] 変更ファイルリストを人が承認した
[ ] 部分適用後に毎回 smoke テストした
[ ] 秘密情報・環境依存値が混入していない
[ ] 最終diffを第三者が1人見た

つまずきポイントと対処

広範囲に壊れる → ファイル数上限を決め、フォルダごとにタスク分割。
コンフリクト → 手作業マージ箇所を先に印付け、AIには白黒をはっきりさせた範囲だけ渡す。
時間がかかる → 先に型定義やインタフェースだけ合意し、実装は後追い。

深掘り：Composer向き／向きでない改修

名前変更・インポートパス変更・関連テスト薄いレガシー一括置換はリスク大。逆に、コンポーネント抽出や繰り返しHTMLのテンプレ化はComposerが得意です。

運用ノート：大規模リファクタとの境界

Composerは迅速ですが、アーキテクチャ方針の転換までは任せず、人間でADR（Architecture Decision Record）を書いてからが安全です。複数サービスにまたがる変更は、インタフェース合意の前にComposerを使うと巻き戻しコストが跳ね上がります。設計レビューが必要な案件では「プランモードのみ」をルール化し、コード生成は合意後に開始。夜間バッチで触るようなクリティカル領域は、Composer出力でも二人レビュー必須にしてください。

（学習の定着）

組織学習の観点では、週次15分の振り返りをカレンダーに固定し、うまくいった依頼文や依頼テンプレは共有ドライブへコピーして資産化します。四半期ごとに公式の利用規約と社内ポリシーを突き合わせ、差分があれば短いチケットで追記してください。個人メモでも「日付・用途・入力の要点・出力の使い道」を1セットで残すと検索性が上がり、異動時の引き継ぎもスムーズです。ステークホルダー別の典型的な懸念（経営はROI、情シスは漏洩、現場は手間と心理的負担）を箇条書きで持っておくと、同じ学びを説明する場面でも言い換え疲れが減ります。公開可否が曖昧な資料はそもそもAIに入力しない、と自分で宣言しておく線引きメモがあると、日々の判断が速くなります。

なお学習効率を上げるには、「読む→15分で演習→翌週に同じ手順でもう一度」をカレンダーに3連続で置き、忘却曲線を意識するのがコツです。複数人で進めるときは教え合うペアと日時を先に仮押さえし、片方が欠席しても演習PDFだけで進められるようにリンク集を1枚添えておくと属人化が進みにくくなります。最後に、成果が出た週は短いログ（良かった依頼1行）を残し、出なかった週は「阻害要因」を1語だけメモして次週の設計に回すと改善が続きます。

まとめ：次に何をするか

来週の改修で「2〜3ファイルまで」を上限にComposerを1本試し、失敗したらファイル数を減らす方針にしてください。

ツール情報（公式リンク）

Cursor（公式）

権利表記・引用について

Cursorは各社の商標または登録商標です。本記事は各社の公式提供ではなく、一般的な情報提供を目的としています。機能や提供条件は変更される場合があるため、最新情報は公式ページをご確認ください。

画像クレジット

サムネイル/本文画像はUnsplashの写真を使用しています（ライセンス：Unsplash License）。

お問い合わせ

AIツールの導入・活用支援のご相談はお気軽にどうぞ

📞 090-6262-3842