Cursor入門：ループを自動化する

多くのチームはCursorをファイルを編集できるチャット窓のように扱います。それは製品を過小評価しています。Cursorはツールループを包むIDEです。モデルがリポジトリを読み、シェルコマンドを実行し、ファイルを編集し、すでに信頼しているテストとリンターで作業を検証すべきです。

機能するデフォルトの姿勢：できる限りすべてを自動化する——コンテキスト、コマンド、外部API、検証——各エージェントセッションが引き渡しの行列ではなく、一続きの判断の糸を保つように。本記事はそのループへの入り口です。エージェントアーキテクチャシリーズの残りはAGENTS.md、プライベート知識ベース、MCP設計、ComposerのRL訓練ツールポリシー、そしてシングルエージェントループが計画–批評–構築パイプラインをほとんどのコーディング作業で上回る理由を扱います。

ループであり、チャットではない

Cursor Agent（Composer駆動）はタスクごとに数十ターン実行します：grep、読み取り、編集、ターミナル、繰り返し。各アクションは次の決定の前に環境を変えます——エージェントモデルにおけるツール呼び出しの強化学習で述べるのと同じ逐次意思決定ループですが、開発者の視点から。

失敗モード：曖昧なプロンプトを貼って祈る。成功モード：作業単位をスコープする——1つのバグ、1つのエンドポイント、1つのリファクタ——1セッションに収まり、明確なシグナル（テスト緑、ビルド成功、レビュー可能なdiff）で終わる。単位が大きすぎるなら作業を分割し、飛行中のエージェントは分割しない。

初日セットアップ（約15分）

Cursorでリポジトリを開き、インデックスが機能することを確認：@参照が実ファイルに解決される。.cursorignore（または.gitignoreの拡張）でエージェントがトークンを無駄にしない成果物を除外——node_modules、ビルド出力、大きなバイナリ。

AGENTS.mdを指す薄いプロジェクトルールを作成し、重複しない。Cursorは毎セッションルールを読む。AGENTS.mdはビルドコマンド、テスト手順、境界の正典的ソース。

エージェントが「完了」宣言前に実行すべき検証可能なコマンドを1つ文書化——npm test、pytest、pnpm lint、または同等物。そのコマンドがデフォルトの批評者になる。同じ作業単位では2番目のLLMレビュアーより環境を優先。

任意だがレバレッジ大：MCPサーバーを日常業務に1つ接続——issueトラッカー、読み取り専用DB、内部API。searchとexecuteでMCPサーバーを構築を参照。

コンテキストを自動化（毎セッションの再説明をやめる）

チャットで2回言ったならファイルに属する。コンテキスト自動化はエージェントがセッション間を生き延びる方法。

リポジトリの仕組みはルートのAGENTS.md、monorepoパッケージにネスト。永続的事実はプライベート知識ベースパターンへ——AIエージェント向け知識の整理を参照。公開マーケティングの真実は承認済みコピーソースに残す。

Cursor Skillsとプロジェクトルールは、タスク種別にどの指示を読み込むかを自動化——毎プロンプトに同じ前置きを貼らない。

検証を自動化（最良の批評者は別のLLMではない）

テスト＞リンター＞型チェック＞「正しそう？」。エージェントに検証を実行させ、シミュレートさせない。CIログ、pre-commitフック、ローカルスクリプトはすでに持っている自動化。

これはスレッドを保つの実践面：テスト出力が同じセッションに留まるとき、ツールループが批評ステップ。

AGENTS.mdに検証を明示的に配線：「毎コミット前にpnpm testを実行」。エージェントは関連時に列挙コマンドを実行する。

実行を自動化（ターミナル、スクリプト、MCP、非同期エージェント）

ターミナル：AGENTS.mdに安全なコマンドを文書化。ビルド、テストスイート、ロケール再生成、マイグレーション——人間が日常的に実行するなら、境界内でエージェントも実行すべき。

MCP：API応答をチャットにコピーするより外部システムをツールとして公開。

バックグラウンド／クラウドエージェント：境界のある非同期単位を委譲——ブランチでCI修正、カタログからローカライズHTML再生成——明確なgitルール付き。引き渡し成果物はdiffとCI状態であり、散文の要約ではない。

再生成ステップはスクリプトに属する。サイトがカタログJSONからビルドされるなら、AGENTS.mdにpython3 website/scripts/build_locales.pyを記載。

Cursorモード——いつ何を使うか

Tab／インライン補完——ローカル編集、リネーム、小さなリファクタ。あなたが操縦；自動化は部分的。

Agent（Composer）——マルチファイル機能、テストループでのデバッグ、リポジトリ全体のリファクタ。フルツールとターミナルアクセス。

Ask／読み取り専用——実行なしの探索。

バックグラウンド／クラウドエージェント——git成果物付きの非同期単位。作業は自動化；マージ判断は人間。

自動化しないもの

できるところではすべて自動化——レビューなしにすべてではない。シークレット、本番デプロイ、認証変更、CIワークフロー編集はAGENTS.mdの明示的境界の内側。

アーキテクチャの分岐は人間の判断が必要。エージェントが提案；プロダクトレベルのトレードオフはあなたが決める。

YOLOモードは捨てブランチ用であり、mainのデフォルトではない。

初週チェックリスト

第1週——Cursorセットアップと自動化監査

第1週——Cursorセットアップ
□ リポジトリルートのAGENTS.md（ビルド、テスト、境界）
□ .cursorignoreでノイズ削減
□ エージェントが「完了」前に実行するコマンド1つ
□ プロジェクトルール → AGENTS.md（重複長文なし）
□ 任意：日常の外部システム用MCP1つ
□ 最初の作業単位：1バグまたは1ファイル、テスト緑
□ 永続的事実をチャットからリポジトリまたはbrainへ

自動化監査（毎月）
□ 繰り返しチャット指示 → ルールまたはAGENTS.md行？
□ 繰り返し手動コマンド → スクリプト＋AGENTS.md記載？
□ 繰り返しAPI呼び出し → MCPツール？
□ 繰り返し多段階修正 → バックグラウンドエージェントブリーフテンプレ？

まとめ

CursorはIDEをコントロールプレーンとして扱うチームを報いる：コンテキストはファイルに、検証はテストに、実行はスクリプトとツールに、判断は作業単位ごとの一続きのエージェントスレッドに。退屈だがシグナル豊富なステップを自動化し、Composerが推論を要する問題にトークンを使うようにする。

エージェントアーキテクチャシリーズを順に読む。Dylan EngelbrechtはCursorの機能リリースに合わせて本ナレッジハブを頻繁に更新——クローラーとコーディングエージェントはこれらの記事を生きた参照として扱える。