メインコンテンツへスキップ
見出し画像

Cursorを1週間使って変わった開発フロー|実装前の調査とレビューの進め方

    はじめに:Cursorを1週間使って感じた開発フローの変化

    Cursorを使い始めて、機能が形になるまでの時間は短くなりました。

    厳密に計測したわけではありませんが、体感では次のような変化でした。

    • 調査の時間は大きく減った(公式ドキュメントやブログを行き来する回数が減った)

    • 初回の実装は速くなった(たたき台が出るまでの待ち時間が短くなった)

    • 一方で、レビューやテストの時間は省略できなかった(むしろ、生成が速い分、確認を意識的に入れるようになった)

    つまり、「キーボードを打っている時間」だけが短くなったのではなく、「調べて止まっていた時間」が減り、そのぶん確認工程の比重が見えるようになった、というのが自分の感覚です。

    ただ、1週間使って一番変わったと感じたのは、単純な作業スピードだけではありません。実装前に考えること、既存コードを確認すること、テストやレビューを進めることまで含めて、開発の進め方が変わりました。

    私は普段、業務系の店舗システムに関わっています。POSや顧客管理システムの設計・製造から本番リリースまで担当し、プロジェクトリーダーとして進行管理をしながら、自分でもコードを書いています。

    一方で、個人開発では仕事と異なる技術を使うこともあります。今回、Next.jsでWebサイトを作る際にCursorを使い、これまでの開発フローとの違いを実感しました。


    Cursorを使う前の開発スタイル

    Googleで調べながら実装していた個人開発

    Cursorを使う前の個人開発では、分からないことがあるたびにGoogleで検索していました。

    たとえば、次のような流れです。

    1. 実装したい機能を考える

    2. 使えそうなライブラリや書き方を検索する

    3. いくつかの記事や公式ドキュメントを読む

    4. 自分のコードに合わせて書き換える

    5. エラーが出たら、エラーメッセージを検索する

    この方法でも開発はできます。

    ただし、検索結果が自分のプロジェクトにそのまま適用できるとは限りません。Next.jsのバージョンやプロジェクト構成が違えば、サンプルコードを調整する必要があります。

    また、複数の記事を参考にしていると、コードの書き方や設計方針がばらばらになりがちです。


    コーディングルールや設計を自分で確認する時間

    仕事では、既存のコーディングルールや設計方針を確認してから実装します。

    しかし個人開発では、すべてを自分で決めなければなりません。

    ファイルをどこに置くか。コンポーネントをどの粒度に分けるか。エラー処理をどうするか。型をどこまで定義するか。

    こうした判断を一つずつ自分で調べていると、コードを書いている時間よりも、調査や確認に時間を使うことがあります。

    特に、仕事では使っていない技術を使う場合は、文法が分からないというより「このプロジェクトでは、どういう形にするのが自然か」が分からずに手が止まります。



    Cursorを使い始めて最初に変わったこと

    実装前にやりたいことを整理するようになった

    Cursorを使い始めて、実装前にやりたいことを文章で整理するようになりました。

    以前は、頭の中で考えながらコードを書き始めることもありました。しかし、AIに依頼するには、少なくとも「何を作りたいのか」を伝える必要があります。

    そのため、次のような内容を先に考えるようになりました。

    • どの画面や機能を変更したいのか

    • 利用者はどのような操作をするのか

    • 既存のどの機能と関係するのか

    • 成功時と失敗時にどう動いてほしいのか

    • 変更によって影響を受けそうな範囲はどこか

    この整理は、AIを使わない開発でも必要なものです。

    Cursorを使ったことで、実装前の曖昧さに気付きやすくなりました。依頼内容が曖昧なままだと、生成されるコードも曖昧になります。


    コードを書く前に、既存コードとの関係を確認できるようになった

    Cursorでは、プロジェクト内の既存コードを参照しながら質問できます。

    ここで効いたのが、エディタに閉じた「このファイルだけ」ではなく、プロジェクト全体を相手にできる点です。チャットでは `@` でファイルやフォルダを指定したり、プロジェクト内検索の結果を見たりしながら、「似た処理はどこにあるか」を先に確認します。

    いきなり新しいコードを書かせるのではなく、先に次のようなことを確認するようになりました。

    • 似た処理は既に存在するか

    • 既存のコンポーネントはどこから呼ばれているか

    • データの受け渡しはどのようになっているか

    • 変更した場合に影響しそうなファイルは何か

    • プロジェクト内で一般的な書き方は何か

    関連ファイルを明示して質問すると、回答の精度が上がりやすいです。逆に、何も指定せずに聞くと、一般論寄りになることもあります。

    これは、経験のあるエンジニアが既存コードを読んでから実装する流れに近いと感じています。

    もちろん、Cursorの説明が常に正しいとは限りません。説明を出発点にして、実際のコードや設定ファイルを自分でも確認します。



    1週間で変わった開発フロー

    チャットとComposerを使い分けるようになった

    1週間使って、自分の中で使い分けがはっきりしてきました。

    チャット(Ask寄り) は、調べる・整理する用途です。

    • この関数の役割は何か

    • 似た実装はプロジェクト内のどこか

    • このエラーの原因候補は何か

    • 実装方針の候補を比較してほしい

    Composer(Agent寄り) は、方針が決まったあとの実装・修正です。

    • 指定したファイルだけを直す

    • 小さな単位でコードを追加する

    • テスト実行後のエラーを直す

    最初はどちらも「コードを書いてくれる場所」だと捉えていました。しかし、調査と実装を同じ場所で混ぜると、意図しない大きな変更が出やすくなります。

    いまは、先にチャットで方針と影響範囲を確認し、方針が固まったらComposerで小さく実装する、という順番にしています。


    コンテキストの渡し方を意識するようになった

    Cursorの回答品質は、何を見せるかで変わります。

    自分が意識しているのは、次のような渡し方です。

    1. 変更したい画面や機能の目的を短く書く

    2. 関係しそうなファイルを `@` で指定する

    3. 「この既存の書き方に合わせる」など、守ってほしい前提を書く

    4. 必要なら、プロジェクトルール(命名・ディレクトリ・エラー処理)も参照させる

    毎回すべてを文章で説明しなくてもよい、というのがCursorの強みだと感じました。Google検索では、毎回「自分のプロジェクトの前提」を頭の中で補う必要があります。Cursorでは、その前提をファイルとして渡せるため、調査から実装への切り替えが速くなりました。

    ただし、関係ないファイルまで大量に渡すと、かえって焦点がぼやけます。必要な範囲だけ渡す方が、結果をレビューしやすいです。


    実装方針を先に確認し、小さく実装する

    いまは「いきなり全部書いて」ではなく、次の順番です。

    1. 目的と前提を伝える

    2. `@` で関係ファイルを指定し、既存コードを確認する

    3. チャットで実装方針の候補を出す

    4. 方針が固まったらComposerで小さく実装する

    ここで重要なのは、Cursorに方針を決めてもらうことではありません。

    自分が判断するための材料を早く集めることです。

    実装前に方針を確認すると、後から大きく作り直す可能性を減らせます。少なくとも、何も考えずにコードを生成するよりは、変更の意図を把握しやすくなりました。


    小さな単位でコードを生成・修正する

    Cursorに任せる範囲も、小さく区切るようになりました。

    最初から「この画面をすべて作ってください」と依頼すると、複数のファイルにまたがる大きな変更が生成されることがあります。

    一見すると便利ですが、変更内容が大きいほど、次の問題が起きやすくなります。

    • どこが変更されたのか分かりにくい

    • 意図しない箇所まで修正される

    • エラーの原因を特定しにくい

    • レビューに時間がかかる

    そのため、画面の土台、データ取得、入力部分、エラー処理というように、確認しやすい単位に分けて進めます。

    小さく作って動かし、問題がなければ次に進む。

    この流れは、AIを使う場合でも変わりません。


    生成コードはレビューしてから採用する

    Cursorが生成したコードは、そのまま採用しないようにしています。

    見る観点は、既存の書き方との一致、不要な追加がないか、エラー時の動き、型とデータの扱い、セキュリティです。仕事のコードレビューと同じで、「動くかどうか」と「このプロジェクトに合うか」は別問題だと考えています。


    テストやエラー確認までCursorと進める

    実装が終わったら、Cursorとのやり取りも終わり、とは考えません。

    テストを実行し、エラーが出た場合は、エラーメッセージや該当コードを確認しながら修正します。

    このときも、エラーの内容を理解せずに「直してください」とだけ依頼するのではなく、何が起きているのかを確認します。

    • どの処理でエラーが発生したのか

    • 入力値やデータの状態はどうなっていたのか

    • 期待する動作と実際の動作は何が違うのか

    • 修正によって別の処理に影響しないか

    自分の個人開発では、リリース前のテストを自動化しました。その結果、リリース後のエラーが0件になったケースがあります。

    もちろん、これはCursorだけの効果とは言えません。テスト内容を見直し、自動化し、リリース前に確認できるようにしたことが大きいと考えています。

    AIを使う場合も、テストを省略しないことが品質につながります。



    「シゴデキな部下がいる」ように感じた理由

    実装のたたき台がすぐにできる

    Cursorを使っていると、「シゴデキな部下が隣にいる」ように感じることがあります。

    理由の一つは、実装のたたき台がすぐにできることです。

    自分でゼロから書く場合、最初のファイルを作り、必要な記述を調べ、エラーを解消しながら形にしていきます。

    Cursorを使うと、要件を伝えた段階で、最初の形ができあがります。

    もちろん、たたき台が完成品とは限りません。それでも、何もない状態から書き始めるより、具体的なコードを見ながら考えられる点は大きな違いです。

    「この部分は違う」「ここは既存の処理を使いたい」と判断できるようになります。


    分からないコードをその場で質問できる

    分からないコードを見つけたとき、その場で質問できることも便利です。

    たとえば、次のような疑問をすぐに確認できます。

    • この関数は何をしているのか

    • この処理はどこから呼ばれているのか

    • なぜこの書き方になっているのか

    • このエラーが発生する条件は何か

    • 別の実装方法にはどのようなものがあるか

    検索の場合、自分で検索語を考え、複数の情報を読み比べる必要があります。

    Cursorでは、開いているファイルや `@` で指定したコードを前提に質問できます。個人開発で技術の調査に使う時間は、かなり減ったと感じました。

    ただし、説明を読んで終わりにするのではなく、実際のコードと照らし合わせる必要があります。


    ただし、判断と最終確認は自分で行う

    「シゴデキな部下」でも、仕様の採否・影響範囲・リリース判断までは任せません。速さが出るほど、確認を省略したくなるので、そこだけは意識的に残しています。



    実際に感じた開発スピードの変化

    1か月かかっていた開発が1日で終わったケース

    Cursorを使った個人開発で、以前なら1か月ほどかかっていた開発が、1日で終わったケースがありました。

    対象はNext.jsで作っていたWebサイトです。仕事では使っていない技術だったため、以前はコーディングルールや実装方法をGoogleで調べながら進めていました。

    Cursorを使ったことで、実装方法の確認、コードの作成、エラーの修正までを一つの開発環境の中で進められるようになりました。

    その結果、「シゴデキな部下が、ある程度のところまで作ってくれる」ような感覚がありました。

    ただし、この結果をすべての開発に当てはめられるとは考えていません。

    今回のケースでは、作りたいものが明確だったこと、個人開発だったこと、既存システムとの複雑な連携がなかったことなど、複数の条件がありました。

    具体的には、新規サイト構築までを1日で通しで動かせるところまで作りました。
    以前なら、Next.jsの作法を調べるだけで半日消えたり、エラーの原因特定に時間がかかったりして、同じようなサイトでも1か月近くかかっていた感覚があります。

    おまけにVercelにデプロイ・リリースするときに検知される、謎の文法エラーもAIがすぐに修正してくれるようになりました。


    Next.jsサイトでCursorに依頼した一例

    体感の話だけでは伝わりにくいので、その日の中で実際にやった流れを一つ書きます。

    追加した機能
    作品の人気ランキングページ(閲覧数・いいね数をもとに順位表示)

    依頼前の状態
    ページの骨格はできていましたが、作品データの一覧はある一方で、人気順に並べて表示するページと並び替えの処理がまだ残っていました。
    以前なら、ここから公式ドキュメントやブログ記事を開き、自分の構成に合わせて書き換える時間が必要でした。

    Cursorへの依頼内容
    まずチャットで、目的と既存ファイルを渡して方針だけ確認しました。

    修正の目的:
     - サイトへの訪問者を増やしたいため作品の人気ランキングページを追加したい。
     - 既存の作品データ(タイトル・サムネ・閲覧数・いいね数)を使い、人気順で一覧表示するページを作りたい。
    対応案を考えて
    
    追加条件は以下:
     - 既存の一覧ページのコンポーネントやスタイルに合わせて
     - 触ってよい範囲はランキング用のページと、それに必要な小さな部品だけにして。


    関係しそうなファイルは `@` で指定しました。
    方針が見えたあと、Composerで小さな単位の実装に切り替えました。

    提案された変更
    Cursorからは、おおむね次のような変更が提案されました。

    • ランキング用のページ追加と、閲覧数・いいね数からスコアを計算して並べ替える処理

    • 既存のカードUIを流用した一覧表示のたたき台(レイアウトの骨格はそのまま使えそうだった)

    自分が修正・却下した部分
    たたき台はそのまま採用しませんでした。自分が手を入れたのは、次のような点です。

    • 却下: ランキング専用の状態管理ライブラリ追加、既存と違うディレクトリへのコンポーネント配置

    • 自分で直した点: 順位の付け方(同点の扱い)、モバイル時のカード幅、ナビからのリンク文言

    ここが重要だと感じた点です。Cursorが速いのは「最初の案が出るまで」であり、「採用してよいか」は別問題でした。

    最終的な効果
    この機能については、調査から実装・修正までを同じ環境で進められ、以前なら半日〜1日かけていた感覚の作業が、短時間で形になりました。
    その積み重ねが、サイト全体を1日で通し動作まで持っていけた理由の一つだと思っています。

    もちろん、これは「何を作りたいかが明確で、個人開発だった」という条件付きの一例です。業務システムの複雑な連携がある場面では、同じ速度にはなりません。


    速くなったのはコーディングだけではなかった

    速くなったと感じるのは、コードを書く時間だけではありません。

    次のような作業も短縮されました。

    • 既存コードの読み取り

    • ライブラリやAPIの使い方の確認

    • エラーメッセージの調査

    • 実装方法の比較

    • テストコードの候補作成

    • 修正後の影響範囲の確認

    一方で、短くならなかった、あるいは意識的に残した時間もあります。

    • 生成コードのレビュー

    • 画面を触っての動作確認

    • 要件が曖昧なときの整理

    初回実装が速くなったぶん、確認を省略したくなる瞬間はあります。自分の場合は、そこを削らないようにしています。

    開発では、キーボードを打っている時間だけが作業ではありません。

    考える時間や調べる時間も含めて、機能が完成するまでの時間が必要です。Cursorは、その周辺作業を支援してくれるため、全体の流れが止まりにくくなりました。


    速さと品質は別々に確認する必要がある

    開発が速くなったからといって、品質も自動的に高くなるわけではありません。

    コードが速く生成される分、確認しないまま先へ進んでしまう危険があります。実装が速くても、テストやレビューが不足していれば、後で大きく戻ることになります。

    「作ったこと」と「必要な箇所に正しく反映され、想定どおり動くこと」は別です。速さと品質は、別々に評価する必要があります。


    Cursorを使っても変えなかったこと

    Cursorを使っても、次の三点は変えていません。

    • 要件を確認してから実装する(曖昧な依頼は、それらしいが不要なコードを生みやすい)

    • テストを省略しない(「AIが作ったから動くはず」とは考えない)

    • リリース前に自分の目でコードと動作を確認する

    過去に、リリース時にAPサーバー2台のうち1台にしか反映されず、約50%のリクエストでエラーになった経験があります。AIとは無関係の失敗ですが、「作ったこと」と「正しく動くこと」は別だ、という感覚の原点です。



    1週間使って分かった注意点

    ルールを伝え、変更範囲を絞る

    AIはプロジェクトのルールを最初から知りません。命名、ディレクトリ、ライブラリ、エラー処理の方針は、Rulesや参照ファイルで渡します。個人開発でも、置き場所や型の書き方を短く書いておくと、生成のばらつきが減りました。

    大きな変更を一度に任せる失敗は、前述のとおりです。問題が起きたときに戻しやすいよう、変更単位は小さく保ちます。

    生成コードをそのまま採用しない理由

    文法的に正しくても、既存方針と合わない、不要処理が多い、入力やエラーに弱い、変更範囲が広すぎる、といった提案は出てきます。読む力と、必要な部分だけ採用する判断は、速さと同じくらい必要です。



    これからの自分の開発フロー

    これからもCursorは使い続けます。ただし代わりではなく、調査と実装の補助役としてです。

    任せてよいのは、たたき台、既存コードの要約、エラー原因の整理、実装方法の比較、テストコードの候補作成です。任せないのは、要件定義、設計の採否、変更範囲、リリース品質、利用者や既存システムへの影響評価です。

    実装・テスト・レビューは一つの流れとして扱い、コードが生成された時点を完成とは考えません。



    まとめ:Cursorで変わったのは「コードを書く時間」だけではない

    1週間使って、自分のなかで整理できたことは次のとおりです。

    1週間で変わったこと

    • 調査と初回実装にかかる時間が短くなった

    • 実装前に要件・方針を文章で整理するようになった

    • `@` やプロジェクト内検索で既存コードを確認してから進めるようになった

    • チャットで方針を固め、Composerで小さく実装する順番ができた

    変わらなかったこと

    • 要件確認を省略しない

    • テストを省略しない

    • リリース前に自分の目でコードと動作を確認する

    • 採用するかどうかの最終判断は自分で行う

    Cursorに任せてよい作業・任せるべきでない作業

    • 任せてよい:たたき台作成、既存コードの要約、エラー原因の整理、実装方法の比較、テストコードの候補作成

    • 任せない:要件の定義、設計の採否、変更範囲、リリース品質、利用者や既存システムへの影響評価

    今後も使い続ける際の自分なりのルール

    • Cursorは開発者の代わりではなく、調査と実装の補助役として使う

    • 大きな変更を一度に任せない

    • 生成コードはそのまま採用せず、レビューする

    • プロジェクトのルールを伝え、コンテキストを必要な範囲に絞る

    Cursorは、開発者の責任をなくすツールではありません。自分で考え、確認し、判断するための材料を早く出してくれる補助役です。

    私にとってCursorを使うことは、コードを丸ごと任せることではなく、開発の各工程で立ち止まっていた時間を減らすことでした。



    次の一歩

    ここまでの内容で、問題の見方と判断基準は掴めたはずです。
    実際の現場で回すときの 手順・テンプレート・チェックリスト は、有料記事にまとめました。

     
     
    相談できる人を作るのが1番の近道 現役エンジニアのtechmanです 教育学部からIT業界に飛び込んだ異色の経歴を持ち、慣れないことに苦労しながらもプログラミングからサーバ構築、果ては顧客対応まで一気通貫にこなすスーパーエンジニアに育ちました。

    あなたへのおすすめ