<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="0" class="code-line">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<p data-line="2" class="code-line">弊社ではカスタマーサポート、ロジスティクス、メディアなど<strong>開発部署以外のメンバーが<a href="https://docs.devin.ai/get-started/devin-intro" target="_blank" rel="nofollow noopener noreferrer">Devin</a>を活用してプロダクト開発を行っている</strong>点が特徴です。<br>
この記事では実施している開発フロー、実績と現時点での限界と課題、過去の課題を説明します。</p>
<h1 id="devin%E3%82%92%E7%94%A8%E3%81%84%E3%81%9F%E9%96%8B%E7%99%BA%E3%83%95%E3%83%AD%E3%83%BC" data-line="5" class="code-line">
<a class="header-anchor-link" href="#devin%E3%82%92%E7%94%A8%E3%81%84%E3%81%9F%E9%96%8B%E7%99%BA%E3%83%95%E3%83%AD%E3%83%BC" aria-hidden="true"></a> Devinを用いた開発フロー</h1>
<p data-line="6" class="code-line">開発フローはシンプルで、以下の手順に沿って進めています。<br>
各工程を説明します。</p>
<span class="embed-block zenn-embedded zenn-embedded-mermaid"><iframe id="zenn-embedded__7ec1190b9e152" src="https://embed.zenn.studio/mermaid#zenn-embedded__7ec1190b9e152" data-content="flowchart%20LR%0A%20%20%20%20A%5BPRD%E3%81%AE%E4%BD%9C%E6%88%90%3Cbr%2F%3E%2B%20issue%E8%B5%B7%E7%A5%A8%5D%20--%3E%20B%5BDevin%E3%81%AB%E4%BE%9D%E9%A0%BC%5D%20--%3E%20C%5B%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D%5D%20--%3E%20D%5BPR%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%5D%20--%3E%20E%5B%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9%5D" frameborder="0" scrolling="no" loading="lazy"></iframe></span><h3 id="1.-prd%E3%81%AE%E4%BD%9C%E6%88%90" data-line="14" class="code-line">
<a class="header-anchor-link" href="#1.-prd%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> 1. PRDの作成</h3>
<p data-line="15" class="code-line">各部署のメンバーがPRD(Product Requirements Document)<sup class="footnote-ref"><a href="#fn-16b1-1" id="fnref-16b1-1">[1]</a></sup>を作成します。<br>
PRD作成はDevinの<a href="https://docs.devin.ai/work-with-devin/ask-devin" target="_blank" rel="nofollow noopener noreferrer">Ask Devin</a>という機能を使用して行っています。</p>
<p data-line="18" class="code-line">PRD作成までの簡易的な流れは以下のとおりです。</p>
<ol data-line="20" class="code-line">
<li data-line="20" class="code-line">Ask Devinのチャット画面を開く</li>
<li data-line="21" class="code-line">指定のプロンプトを送ってPRD作成を開始</li>
<li data-line="22" class="code-line">URLやスクショを共有しながら背景情報を提供</li>
<li data-line="23" class="code-line">Ask Devinの質問に答えてPRDを段階的に構築</li>
<li data-line="24" class="code-line">受け入れ条件まで確認して最終版を生成</li>
</ol>
<details><summary>出力されるPRDのサンプル</summary><div class="details-content">
<ol data-line="27" class="code-line">
<li data-line="27" class="code-line">背景</li>
</ol>
<p data-line="29" class="code-line">廃止済みの旧サービスに関連するページ・導線・パンくずがプロダクト内に残っており、ユーザー混乱・SEOリスク・運用負荷が発生している。</p>
<ol start="2" data-line="31" class="code-line">
<li data-line="31" class="code-line">現状の課題</li>
</ol>
<p data-line="33" class="code-line">旧サービス向けのリンクやページが残存している</p>
<p data-line="35" class="code-line">パンくずやナビゲーションに一貫性がない</p>
<p data-line="37" class="code-line">旧URLがインデックスされ続ける可能性によるSEOリスク</p>
<p data-line="39" class="code-line">管理画面の構造が旧仕様前提のままで保守しにくい</p>
<ol start="3" data-line="41" class="code-line">
<li data-line="41" class="code-line">目的</li>
</ol>
<p data-line="43" class="code-line">不要な機能・導線の整理によるプロダクト構造の健全化</p>
<p data-line="45" class="code-line">必要な企画ページのみを残し、URL体系を再設計</p>
<p data-line="47" class="code-line">一覧ページと詳細ページの構造に再整理し、保守性と将来拡張性を高める</p>
<ol start="4" data-line="49" class="code-line">
<li data-line="49" class="code-line">対象ユーザー</li>
</ol>
<p data-line="51" class="code-line">一般ユーザー（迷わず目的のページにたどり着ける）</p>
<p data-line="53" class="code-line">運用・開発チーム（複雑化した構造を減らし保守性を確保したい）</p>
<ol start="5" data-line="55" class="code-line">
<li data-line="55" class="code-line">提供価値</li>
</ol>
<p data-line="57" class="code-line">適切に整理された導線と分かりやすいナビゲーション</p>
<p data-line="59" class="code-line">サイト構造の一貫性向上</p>
<p data-line="61" class="code-line">不要機能削除による保守コストの削減</p>
<p data-line="63" class="code-line">旧URLの残存によるSEO悪影響の抑制</p>
<ol start="6" data-line="65" class="code-line">
<li data-line="65" class="code-line">対応方針（What）<br>
(1) 不要ページの削除</li>
</ol>
<p data-line="68" class="code-line">旧サービス配下のカテゴリ・ブランド・特集ページなど、運用不要な一連のページを削除</p>
<p data-line="70" class="code-line">(2) 新しい構造の作成</p>
<p data-line="72" class="code-line">企画一覧ページ /campaigns</p>
<p data-line="74" class="code-line">企画詳細ページ /campaigns/{id}<br>
※旧サービス配下の詳細ページは原則廃止し、新構造へ統合</p>
<p data-line="77" class="code-line">(3) リダイレクト対応</p>
<p data-line="79" class="code-line">/old-feature/* → /campaigns へ統合</p>
<p data-line="81" class="code-line">旧詳細ページ /old-feature/.../{id} → /campaigns/{id} へ301リダイレクト<br>
（IDが引き継げる範囲のみ）</p>
<p data-line="84" class="code-line">(4) 内部リンクと文言の更新</p>
<p data-line="86" class="code-line">旧サービスに関する文言・パンくず・UI内リンクを全て最新構造に合わせて更新</p>
<p data-line="88" class="code-line">管理画面URLも現行体系に揃える</p>
<ol start="7" data-line="90" class="code-line">
<li data-line="90" class="code-line">受け入れ条件（Definition of Done）</li>
</ol>
<p data-line="92" class="code-line">旧サービス関連の導線・ページがすべて削除済み</p>
<p data-line="94" class="code-line">/campaigns および /campaigns/{id} が正常に表示される</p>
<p data-line="96" class="code-line">リダイレクトが正しく機能し、404が発生しない</p>
<p data-line="98" class="code-line">パンくず・ナビゲーション・内部リンクが新構造に統一されている</p>
<p data-line="100" class="code-line">SEO上問題となる旧URLの残存がない</p>
</div></details>
<h3 id="2.-devin%E3%81%AB%E4%BE%9D%E9%A0%BC" data-line="103" class="code-line">
<a class="header-anchor-link" href="#2.-devin%E3%81%AB%E4%BE%9D%E9%A0%BC" aria-hidden="true"></a> 2. Devinに依頼</h3>
<p data-line="104" class="code-line">1.で作成したPRDをGitHub Issueとして起票し、SlackからDevinへ実装依頼を送ります。</p>
<p data-line="106" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/03a2489a7905-20251127.png" alt="" class="md-img" loading="lazy"></p>
<h3 id="3.-%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D" data-line="108" class="code-line">
<a class="header-anchor-link" href="#3.-%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D" aria-hidden="true"></a> 3. 動作確認</h3>
<p data-line="109" class="code-line">dev環境へのdeployもDevinが実施し、依頼者がdev環境での動作確認を実施します。<br>
ここで期待する動作にならない場合は追加の指示をDevinに送ります。</p>
<h3 id="4.-pr%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC" data-line="112" class="code-line">
<a class="header-anchor-link" href="#4.-pr%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC" aria-hidden="true"></a> 4. PRレビュー</h3>
<p data-line="113" class="code-line">Devinが実装したPRのレビューを行います。ここからはエンジニアが担当します。<br>
ここで修正が必要な場合もレビュワーがDevinにプロンプトを投げて修正します。<br>
修正が多い、根本的な設計方針が適切でない場合はDevinで対応できる範囲外としてPRをcloseします。<br>
<a href="https://www.coderabbit.ai" target="_blank" rel="nofollow noopener noreferrer">CodeRabbit</a>を入れており、botのレビューコメントは自動でDevinが対応します。</p>
<h3 id="5.-%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9" data-line="118" class="code-line">
<a class="header-anchor-link" href="#5.-%E3%83%AA%E3%83%AA%E3%83%BC%E3%82%B9" aria-hidden="true"></a> 5. リリース</h3>
<p data-line="119" class="code-line">レビューを担当したエンジニアがリリースします。</p>
<h1 id="%E5%AE%9F%E7%B8%BE" data-line="121" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E7%B8%BE" aria-hidden="true"></a> 実績</h1>
<p data-line="122" class="code-line">2025年6月19日のDevin導入開始から2025年11月19日までの実績は下記になります。<br>
※アカウント名はマスクしています。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/d3b6224b754a-20251119.png" alt="" class="md-img" loading="lazy"></p>
<h3 id="avg-cost-of-merge" data-line="126" class="code-line">
<a class="header-anchor-link" href="#avg-cost-of-merge" aria-hidden="true"></a> Avg Cost of Merge</h3>
<p data-line="127" class="code-line">マージされたPRが作成されたセッションの平均コストです。<br>
平均$19.74です。エンジニアに依頼していたものをDevinが大部分肩代わりしてくれていると考えると安いと思います。が一概には言えません。</p>
<h3 id="merged-prs-co-authored-by-devin-all-time" data-line="130" class="code-line">
<a class="header-anchor-link" href="#merged-prs-co-authored-by-devin-all-time" aria-hidden="true"></a> Merged PRs co-authored by Devin all time</h3>
<p data-line="131" class="code-line">Devinがco-authoredになったマージ済みプルリクエストの合計は137件でした。<br>
5ヶ月で137件なので <code>137 ÷ (20 * 5) = 1.37/日</code> は多いように思います。<br>
また27Contributorsのうち8割が開発部署以外のメンバーが作成したPRです。</p>
<h3 id="%E4%BD%9C%E6%88%90%E3%81%95%E3%82%8C%E3%81%9Fpr%E3%81%AE%E3%83%9E%E3%83%BC%E3%82%B8%E7%8E%87" data-line="135" class="code-line">
<a class="header-anchor-link" href="#%E4%BD%9C%E6%88%90%E3%81%95%E3%82%8C%E3%81%9Fpr%E3%81%AE%E3%83%9E%E3%83%BC%E3%82%B8%E7%8E%87" aria-hidden="true"></a> 作成されたPRのマージ率</h3>
<span class="embed-block zenn-embedded zenn-embedded-mermaid"><iframe id="zenn-embedded__8c8dea5dc1f63" src="https://embed.zenn.studio/mermaid#zenn-embedded__8c8dea5dc1f63" data-content="%25%25%7Binit%3A%20%7B'theme'%3A'dark'%2C%20'themeVariables'%3A%20%7B%20'pie1'%3A'%2362f181'%2C%20'pie2'%3A'%23f16262'%2C%20'pie3'%3A'%236298f1'%7D%7D%7D%25%25%0A%0Apie%0A%20%20%20%20%22%E3%83%9E%E3%83%BC%E3%82%B8%22%20%3A%2038%0A%20%20%20%20%22%E3%82%AF%E3%83%AD%E3%83%BC%E3%82%BA%22%20%3A%2020%0A%20%20%20%20%22%E3%82%AA%E3%83%BC%E3%83%97%E3%83%B3%22%20%3A%202" frameborder="0" scrolling="no" loading="lazy"></iframe></span><p data-line="144" class="code-line">クローズされているPRは複雑な改修や大きな改修、期待する振る舞いを詳細化できていなかったことにより、期待する動作にならなかったものが多いです。</p>
<h1 id="%E5%8A%B9%E6%9E%9C" data-line="146" class="code-line">
<a class="header-anchor-link" href="#%E5%8A%B9%E6%9E%9C" aria-hidden="true"></a> 効果</h1>
<h3 id="%E6%94%B9%E4%BF%AE%E3%81%8C%E9%80%B2%E3%82%80%E3%82%88%E3%81%86%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F" data-line="147" class="code-line">
<a class="header-anchor-link" href="#%E6%94%B9%E4%BF%AE%E3%81%8C%E9%80%B2%E3%82%80%E3%82%88%E3%81%86%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F" aria-hidden="true"></a> 改修が進むようになった</h3>
<p data-line="148" class="code-line">最大の効果は、エンジニアの工数がボトルネックとなって停滞していた改修が進むようになった点です。また欲しい物が明確に分かっている(ここが難しくもある)方が指示だしすることで調整もとてもスムーズです。</p>
<p data-line="150" class="code-line">実際に実装できた事例を下記に列挙します。</p>
<ul data-line="152" class="code-line">
<li data-line="152" class="code-line">文字列の置き換え</li>
<li data-line="153" class="code-line">既存のドメインモデルにシンプルなロジックの追加や変更</li>
<li data-line="154" class="code-line">ビジネスロジックの少ないシンプルなCRUDを実施するAPIの実装</li>
<li data-line="155" class="code-line">デザイン仕様が存在しない管理画面のUI変更</li>
<li data-line="156" class="code-line">互換性の必要ない機能の削除</li>
</ul>
<h3 id="%E7%A4%BE%E5%86%85%E3%81%AE%E3%82%B9%E3%83%86%E3%83%BC%E3%82%AF%E3%83%9B%E3%83%AB%E3%83%80%E3%83%BC%E3%81%AE%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E7%90%86%E8%A7%A3%E3%81%8C%E9%80%B2%E3%82%93%E3%81%A0" data-line="158" class="code-line">
<a class="header-anchor-link" href="#%E7%A4%BE%E5%86%85%E3%81%AE%E3%82%B9%E3%83%86%E3%83%BC%E3%82%AF%E3%83%9B%E3%83%AB%E3%83%80%E3%83%BC%E3%81%AE%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E7%90%86%E8%A7%A3%E3%81%8C%E9%80%B2%E3%82%93%E3%81%A0" aria-hidden="true"></a> 社内のステークホルダーのシステム理解が進んだ</h3>
<p data-line="159" class="code-line">副次的な効果ですが、Devinを介してPRD作成+実装+動作確認を行なってもらうことで要件の詳細化、開発のフロー、処理への理解が進み、人間を介した開発でもコミュニケーションがより円滑になりました。</p>
<p data-line="161" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/b0ff0f6801d1-20251127.png" alt="" class="md-img" loading="lazy"></p>
<h1 id="%E7%8F%BE%E6%99%82%E7%82%B9%E3%81%A7%E3%81%AE%E9%99%90%E7%95%8C%E3%81%A8%E8%AA%B2%E9%A1%8C" data-line="163" class="code-line">
<a class="header-anchor-link" href="#%E7%8F%BE%E6%99%82%E7%82%B9%E3%81%A7%E3%81%AE%E9%99%90%E7%95%8C%E3%81%A8%E8%AA%B2%E9%A1%8C" aria-hidden="true"></a> 現時点での限界と課題</h1>
<h3 id="%E5%A4%A7%E8%A6%8F%E6%A8%A1%E3%83%BB%E8%A4%87%E9%9B%91%E3%81%AA%E9%96%8B%E7%99%BA%E3%81%AF%E3%82%84%E3%81%AF%E3%82%8A%E9%9B%A3%E3%81%97%E3%81%84" data-line="165" class="code-line">
<a class="header-anchor-link" href="#%E5%A4%A7%E8%A6%8F%E6%A8%A1%E3%83%BB%E8%A4%87%E9%9B%91%E3%81%AA%E9%96%8B%E7%99%BA%E3%81%AF%E3%82%84%E3%81%AF%E3%82%8A%E9%9B%A3%E3%81%97%E3%81%84" aria-hidden="true"></a> 大規模・複雑な開発はやはり難しい</h3>
<p data-line="166" class="code-line">一定規模を超える開発では、期待どおりの成果が得られないケースが多くあります。<br>
トライしたが期待通りにならなかった事例を下記に列挙します。</p>
<ul data-line="169" class="code-line">
<li data-line="169" class="code-line">memoryやCPU負荷の改善</li>
<li data-line="170" class="code-line">複数のAPIを組み合わせて実現する機能</li>
<li data-line="171" class="code-line">既存機能のテーブル設計を含む根本的な改修</li>
</ul>
<p data-line="173" class="code-line">Devinに最も適したタスクは初級エンジニアレベルの難易度で、十分な指示があればインターンでも解決できるレベルのタスクが進められている<sup class="footnote-ref"><a href="#fn-16b1-2" id="fnref-16b1-2">[2]</a></sup>ため、大規模または複雑な開発を進める場合はいかにタスクを平易で検証可能な形で分割できるかが重要になってくると考えています。</p>
<p data-line="175" class="code-line">しかし一方で、タスクを分解できるということは、実装におけるシステム的な問題を理解できていることに繋がり、システムを理解することが必要になります。そのため、エンジニアの完全な代替としてのDevin活用は、まだ一定の距離があると感じています。</p>
<h1 id="%E9%81%8E%E5%8E%BB%E3%81%AE%E8%AA%B2%E9%A1%8C" data-line="177" class="code-line">
<a class="header-anchor-link" href="#%E9%81%8E%E5%8E%BB%E3%81%AE%E8%AA%B2%E9%A1%8C" aria-hidden="true"></a> 過去の課題</h1>
<h3 id="dev%E7%92%B0%E5%A2%83%E3%81%AE%E7%A0%B4%E5%A3%8A" data-line="178" class="code-line">
<a class="header-anchor-link" href="#dev%E7%92%B0%E5%A2%83%E3%81%AE%E7%A0%B4%E5%A3%8A" aria-hidden="true"></a> dev環境の破壊</h3>
<p data-line="179" class="code-line">dev環境はGitHub Actionsを通してdev用のbranchでpushされたイベントを検知してdeployを行なっていました。会社で共通の環境を使用していることもありDevinの実装した変更がdev環境とコンフリクトを起こした際に、force pushしてdev環境を壊してしまうことがありました。</p>
<p data-line="181" class="code-line">こちらはDevinで制御するのではなく、GitHub側の設定でDevinからのforce pushを制限しました。その結果、ナレッジに記載している手順でdev環境へ反映してくれるようになりました。</p>
<p data-line="183" class="code-line">ヒューマンエラーと同様に、望ましくない行動をシステム側で防ぐという方針が有効であると考えています。</p>
<h3 id="%E6%A4%9C%E8%A8%BC%E3%81%BE%E3%81%A7%E3%81%8C%E5%A4%A7%E5%A4%89%E3%81%A0%E3%81%A3%E3%81%9F" data-line="185" class="code-line">
<a class="header-anchor-link" href="#%E6%A4%9C%E8%A8%BC%E3%81%BE%E3%81%A7%E3%81%8C%E5%A4%A7%E5%A4%89%E3%81%A0%E3%81%A3%E3%81%9F" aria-hidden="true"></a> 検証までが大変だった</h3>
<p data-line="186" class="code-line">dev環境に都度上げていたので、デプロイ待ちと出力が期待通りではなかった場合に修正してまたdev環境にデプロイする必要がありました。時間がかかるのでlocal環境を各メンバー構築して素早く検証できるようにしました。みんなエンジニアにどんどん近づいています！</p>
<section class="footnotes">
<span class="footnotes-title">脚注</span>
<ol class="footnotes-list">
<li id="fn-16b1-1" class="footnote-item">
<p data-line="188" class="code-line"><a href="https://www.atlassian.com/agile/product-management/requirements" target="_blank" rel="nofollow noopener noreferrer">https://www.atlassian.com/agile/product-management/requirements</a> <a href="#fnref-16b1-1" class="footnote-backref">↩︎</a></p>
</li>
<li id="fn-16b1-2" class="footnote-item">
<p data-line="189" class="code-line"><a href="https://docs.devin.ai/get-started/devin-intro#what-are-devin%E2%80%99s-strengths" target="_blank" rel="nofollow noopener noreferrer">https://docs.devin.ai/get-started/devin-intro#what-are-devin’s-strengths</a><br>
<img src="https://storage.googleapis.com/zenn-user-upload/2f416bed76bc-20251126.png" alt="" class="md-img" loading="lazy"> <a href="#fnref-16b1-2" class="footnote-backref">↩︎</a></p>
</li>
</ol>
</section>


みんなでDevin開発の現在地

社内のステークホルダーのシステム理解が進んだ

大規模・複雑な開発はやはり難しい

Discussion