伝説のDevOpsリードが説く：Cursorの「深淵」を制御し、開発体験を極限まで高める技術
CursorはVS Codeのフォークである以上、VS Code由来の強力なエコシステムと、LLMによるコード生成という強力な武器を併せ持つ。しかし、「AIがコンテキストを読み解くためのIndexing」という強力なエンジンが、時に巨大なリポジトリや複雑な依存関係の中で迷走し、エディタを死に至らしめることがある。
これは「バグ」ではない。AIがコードベースを理解するためのバックグラウンド・プロセスが、環境と衝突して起こる「物理的限界の露呈」だ。
今回は、Cursorを単なるエディタとして使うのではなく、「制御可能なAI開発プラットフォーム」として飼いならすための、実務直結の深層メンテナンス術を伝授する。
—
1. Indexingループの断絶：エンジンの再起動と最適化
CursorのIndexingがハングアップすると、CPU使用率が100%に張り付き、予測変換が止まり、AIチャットが「context too large」あるいは無応答になる。この時、盲目的に再起動を繰り返すのは時間の無駄だ。
現場で使う「緊急修復コマンド」
Indexingのメタデータが破損した際、物理的に強制クリーンアップを行う必要がある。以下のディレクトリを削除し、インデックスを再構築させるのが最も安全かつ迅速な解決策だ。
macOS/Linuxの場合：Indexingキャッシュの強制削除
以下のパスはCursorのグローバルストレージとワークスペースごとのキャッシュを指す
rm -rf ~/Library/Application\ Support/Cursor/User/workspaceStorage/
必要に応じて、プロジェクト直下の .cursor フォルダもクリアする
rm -rf .cursor/
なぜこれが必要か：
CursorのIndexingエンジンは、`LevelDB`を利用してAST（抽象構文木）を保持している。競合や予期せぬ中断によってこのDBがロックされると、プロセスがゾンビ化する。この削除処理は、脳の記憶領域を一度クリアにして、再学習させるプロセスと同義である。
—
2. チーム開発を加速させる「Cursor設定のコード化」
「個人の設定」で終わらせてはいけない。チームの生産性は、「誰がどの環境でも同じAIコンテキストを参照できるか」で決まる。
プロジェクトルートに `.cursorrules` を配置するのは今や常識だが、重要なのはその「構造化」だ。以下は、LLMがプロジェクトの設計思想を逸脱しないためのベストプラクティスである。
`.cursorrules` 推奨構成
プロジェクトの設計原則（LLMへの指示）
rules:
- rule: “型定義には必ずTypeScriptのinterfaceを優先し、typeは計算プロパティに限定する”
- rule: “コンポーネントは機能単位でディレクトリを分割し、index.tsで公開する”
- rule: “外部API呼び出しは必ず専用のhooks/client.tsを経由させること”
コンテキストの除外（Indexingの負荷軽減・機密保持）
ignore_paths:
- “/dist/“
- “/node_modules/“
- “/.lock”
- “/coverage/“
アーキテクトの視点：
このファイルをリポジトリに含めることで、新人エンジニアがAIに「雑なコード」を生成させることが激減する。これはCI/CDにおけるリントルールと同じく、「AIの振る舞いをガバナンスする」という新たなDevOpsの形だ。
—
3. 生産性を極限まで高める「隠れたショートカット」
Cursorには、VS Codeにはない「AI特化の高速操作」が存在する。これを体に染み込ませれば、タイピングの速度よりも、「思考の速度」でコードが書ける。
| アクション | ショートカット (Mac) | 役割 |
| :— | :— | :— |
| Composerを開く | `Cmd + I` | 複数ファイルを横断したAI生成の司令塔 |
| チャットへのコンテキスト追加 | `Cmd + Enter` | 開いているタブを即座にAIの「脳」に追加 |
| コードの適用 (Accept) | `Cmd + K` → `Cmd + Enter` | AIの提案を差分として一発確定 |
| インラインの修正 | `Cmd + K` | 範囲選択して「リファクタリング」を指示 |
—
4. 絶対に入れるべき「神プラグイン」
CursorはVS Code互換だが、AIがすべてを解決してくれるわけではない。「AIが生成したコードの品質を担保するためのツール」を併用するのが、プロの流儀だ。
1. Error Lens: AIが生成したコードに微細な型エラーがあった場合、行末に即座に表示させる。これがないと、AIのミスに気づかずデバッグ地獄に陥る。
2. GitLens: CursorのAIは素晴らしいが、「誰が、なぜこの変更を入れたか」というヒストリーを理解させるには、Gitのコンテキストが不可欠だ。
3. Prettier – Code formatter: AIの出力は整形が崩れることが多い。保存時に自動整形する設定は必須（`editor.formatOnSave: true`）。
—
最後に：なぜ「ツール」にこだわるのか
私は多くのプロジェクトを見てきたが、「エディタの不調を環境のせいにするエンジニア」と「エディタの深淵を理解し、自ら修理して走り続けるエンジニア」では、生産性に数倍の開きがある。
Cursorのバグやハングアップは、単なるストレスではない。「あなたのAIエディタが、今どのコードベースに負荷を感じているか」を教えてくれるサインだ。ログを確認し、キャッシュを整理し、ルールを定義する。その過程こそが、真のDevOpsスキルを養う訓練になる。
ツールに使われるな。ツールを制御し、あなたのコード生成能力を限界まで引き上げろ。それが、次のステージへ進むための唯一の道だ。