フリーランスで複数のクライアントを抱えていると、必ず来る連絡がある。
「ここの文字を少し大きくしてほしい」「ボタンの色が違います」「このセクション、もう少し上に移動できますか」——見た瞬間に軽くため息が出る、あの感じ。
修正内容だけ見れば確かに小さい。コードにすれば5行も書かない。しかし実際にやってみると、なぜかいつも20〜30分ほど経過している。プロジェクトを開き直して、該当ファイルを探して、ローカルで確認して、コミットして、プッシュして、デプロイして、クライアントに「対応しました」と連絡する。この往復を全部合計すると、「2分の修正」が20〜30分になる。
自分はAIを使ったコンテンツ生成システムを副業で運用しているが、こういった「本作業より段取りの方が重い」という構造は、何度もぶつかる問題だ。本体の処理が2分で終わっても、前後のチェックと後片付けで15分かかる、みたいなことが普通に起きる。フリーランスの小さな修正依頼も、この構造と同じだ。修正そのものではなく、前後の段取りが時間を食っている。
ここに注目した「feedback2code」というツールが最近登場した。アプローチが面白かったので紹介したい。
「2分の修正」が30分に膨らむ本当の理由
この問題の核心は、修正作業そのものではなく、コンテキストスイッチのコストにある。コンテキストスイッチとは、今やっていることを止めて別のことに頭を切り替えることを指す。
プログラミングには「フロー状態」という言葉がある。問題に深く集中できている状態のことで、この状態に入るまでに通常15〜20分かかると言われている。「ちょっとした修正」の依頼が来るたびに、このフロー状態が強制終了される。修正を終えて元の作業に戻ると、またゼロからウォームアップが必要になる。
実際のコストを分解するとこうなる。
以下は「2分の修正」1件あたりの時間内訳だ。
- 修正前の中断：頭の切り替え
- 修正本体：2〜5分
- 環境準備（プロジェクトを開く、ファイルを探す、確認する）：10〜15分
- デプロイと報告：5〜10分
- 元の作業への復帰：15〜20分
合計すると40〜50分のロスになることもある。これが1日に5件来ると、集中作業できる時間はほぼなくなる。高単価の仕事——設計、提案、新しい案件の開拓——には、まとまった集中時間が必要だ。コンテキストスイッチが頻発する環境では、稼ぎを増やすための仕事そのものができなくなる。
フィードバックをそのままGitHub PRに変えるfeedback2code
この問題に対して、具体的なアプローチを提示しているのが「feedback2code」（feedback2code.dev）だ。フリーランス開発者が自分自身の課題を解決するために作ったツールで、仕組みはこうだ。
クライアントが確認するステージング環境——本番に公開する前の確認用サイト——に、小さなフィードバックウィジェットを埋め込む。ウィジェットとは、ページの隅に表示されるコメント送信ボタンのことだ。クライアントはページを見ながら、気になった箇所に直接コメントを残せる。「このボタンを緑にして」「ここの誤字を修正して」「スマホで余白が変に見える」——そういった具体的なフィードバックをページ上で直接書き込む形になる。
そのフィードバックをAIコーディングエージェント（opencode + Minimax 2.7）が読み取る。クラウド上のサンドボックス——隔離された実行環境——でコードベースを分析し、適切な修正を加えて、GitHubのプルリクエスト（PR）を自動で作成する。
プルリクエストとは、修正したコードを本番環境に適用する前に「このコードを取り込んでいいですか?」と申請する仕組みだ。GitHubを使った開発では標準的なフローで、ここでコードのレビューを行う。
プロジェクトを開き直す。ファイルを探す。修正する。確認する。デプロイする。報告する。——その一連の作業が全部なくなる。開発者がやることは「PRを確認してマージする」だけになる。
「自動マージしない」設計が、AIと人間の正しい分担を作る
feedback2codeの設計で特に重要なのは、PRを自動でマージしないという点だ。
完全自動化——フィードバックが来たらそのまま本番反映——にしたくなる気持ちはわかる。手間が一番少ない。しかし実際の現場ではこれが難しい。
AIが不得意なことがある。文脈を読むことだ。「このボタンを緑にして」という依頼に対して、AIはCSSの色指定を変えるだろう。しかしクライアントが本当に意図していたのは「ブランドカラーの緑に合わせてほしい」かもしれないし、「このボタンが目立つようにしてほしい」かもしれない。文字通りの指示と本当の意図がずれることは、クライアントワークでは日常茶飯事だ。
もう一つは、コードの変更には意図しない副作用が出やすいことだ。CSSの修正が別のページのレイアウトに影響したり、JavaScriptの変更が特定のブラウザで動かなくなったりする。AIは変更の影響範囲を完全には追えない。
自分がAIシステムを組む時にも共通する原則だ。AIが出力したものをそのまま使うのではなく、必ず確認のステップを入れる。完全自動化に踏み込んだ部分ほど、後からエラーの修正コストが大きくなる経験を繰り返してきた。気づくのは毎回遅い。
「AIが実装、人間が判断」という分担が、速さと品質を両立する現実的な線になる。自動化ツールを評価する時、「どこで人間が判断を持つか」という設計が一番重要な観点だと思う。
自動化の本当の効果は「浮いた時間の使い方」にある
仮にfeedback2codeのような仕組みで月に10時間が浮いたとして、その10時間で何をするかが収益の差を生む。
よくある失敗パターンは「浮いた時間がそのまま休息になる」ことだ。疲れているから休む、というのは理解できる。しかし自動化の目的が「稼ぎを増やすこと」であれば、浮いた時間を意図的に稼げる仕事に振り向ける設計が必要だ。
月10時間を、新しい案件の提案に使うのか。技術力を上げる学習に使うのか。既存クライアントとの関係を深めることに使うのか。この設計なしに自動化だけ進めても、時間が空白のまま埋まらない。
「仕組みは作れたのに稼げない」という状況のほとんどは、自動化の先にある「稼ぐための行動」が設計されていないことが原因だ。ツールを作ること自体に達成感があるのはわかる。しかし道具は使って初めて意味を持つ。自動化で浮いた時間に何を入れるか——これを先に決めてから、自動化する対象を選ぶのが正しい順序かもしれない。
フィードバック管理の一元化という副次効果
feedback2codeにはもう一つの価値がある。クライアントとのやり取りを一元化できる点だ。
通常のフリーランスワークでは、修正依頼はメール・Slack・チャット・電話など、バラバラな経路で来る。どの修正がどの状態にあるのか、開発者もクライアントも把握しにくい状態になりやすい。
ウィジェットを通じてフィードバックを集約すると、クライアントも「自分のフィードバックがどう扱われているか」を一か所で確認できる。開発者側も、対応すべき依頼の優先順位をつけやすくなる。フリーランスのコミュニケーションコストは意外に重い部分で、修正依頼を受けて確認して報告する往復だけで1件あたり5〜10分消えることがある。コードの修正を自動化するだけでなく、「やり取りの摩擦」まで対象に入れている点が、この設計として面白い。
実際に使う前に確認しておきたいこと
feedback2codeを仕事に組み込む前に、いくつか確認しておきたい点がある。
一つは、コードを外部サービスに渡すことへの対応だ。AIエージェントがコードを分析するために、コードベースをクラウドの実行環境に送る必要がある。NDA（秘密保持契約）があるプロジェクトや機密情報を含むシステムの場合、どの範囲のコードが外部に送られるかは事前に確認が必要だ。
もう一つは、AIが扱える修正の複雑さだ。「テキストを変える」「CSSで色を変える」程度のシンプルな修正ならほぼ問題なく処理できると思うが、ビジネスロジックが絡む変更になるほど、AIの出力精度が下がる可能性がある。使い始めるとしたら、まずシンプルな案件で試して、AIが出すPRの品質を確認した上で本格的に運用に組み込む判断をするのが現実的だ。
現時点でfeedback2codeは開発中・フィードバック募集中の段階にある。ただ「フィードバックをAIが処理してPRとして出力し、人間が最終判断する」というアーキテクチャは、フリーランスの定型業務を変える可能性のある方向性だと思う。
まとめ
- 小さなクライアント修正依頼の本当のコストは、修正時間ではなくコンテキストスイッチによる集中の断絶にある
- feedback2codeは、ウィジェットでフィードバックを集約 → AIエージェント（opencode + Minimax 2.7）がPRを自動作成 → 開発者が確認してマージ、という流れで定型修正の段取りコストを削るツール
- 「自動マージしない」設計は、AIと人間の正しい役割分担を守るためのもの
- 自動化で浮いた時間を何に使うか先に設計しなければ、収益には直結しない
AIと自動化に関する実験ログをXで発信しています。
【PR】フリーランスエンジニアにおすすめのツール
フリーランスのサーバー環境構築に。安定性と価格のバランスが取れたVPSサービス。
副業・個人開発のドメイン取得に。低コストで始められる。
Pythonスキルを体系的に学ぶためのオンライン講座。自動化スキルの土台作りに。
【PR】おすすめの書籍
記事の内容に関連する書籍を紹介させてほしい。
副業や独立を検討している方向けに、Amazon輸入ビジネスの仕組みと実務を体系的にまとめた一冊です。
Google Apps Script目的別リファレンス 実践サンプルコード付き 第3版
Google Apps Scriptを使った業務自動化を、目的別のサンプルコードで実践的に学べるリファレンスです。
コメント