1.0ハイブリッドテクノロジーズhttps://hybrid-technologies.co.jp/blogHT Blog Adminhttps://hybrid-technologies.co.jp/blog/author/ht_admin_blog/rich600338<blockquote class="wp-embedded-content" data-secret="qkuZ8Rba7H"><a href="https://hybrid-technologies.co.jp/blog/case-study/20220711_03-2/">アジャイル開発に設計書は必要？バックログとの役割の違いも解説</a></blockquote><iframe sandbox="allow-scripts" security="restricted" src="https://hybrid-technologies.co.jp/blog/case-study/20220711_03-2/embed/#?secret=qkuZ8Rba7H" width="600" height="338" title="“アジャイル開発に設計書は必要？バックログとの役割の違いも解説” — ハイブリッドテクノロジーズ" data-secret="qkuZ8Rba7H" frameborder="0" marginwidth="0" marginheight="0" scrolling="no" class="wp-embedded-content"></iframe><script type="text/javascript"> /* <![CDATA[ */ /*! This file is auto-generated */ !function(d,l){"use strict";l.querySelector&&d.addEventListener&&"undefined"!=typeof URL&&(d.wp=d.wp||{},d.wp.receiveEmbedMessage||(d.wp.receiveEmbedMessage=function(e){var t=e.data;if((t||t.secret||t.message||t.value)&&!/[^a-zA-Z0-9]/.test(t.secret)){for(var s,r,n,a=l.querySelectorAll('iframe[data-secret="'+t.secret+'"]'),o=l.querySelectorAll('blockquote[data-secret="'+t.secret+'"]'),c=new RegExp("^https?:$","i"),i=0;i<o.length;i++)o[i].style.display="none";for(i=0;i<a.length;i++)s=a[i],e.source===s.contentWindow&&(s.removeAttribute("style"),"height"===t.message?(1e3<(r=parseInt(t.value,10))?r=1e3:~~r<200&&(r=200),s.height=r):"link"===t.message&&(r=new URL(s.getAttribute("src")),n=new URL(t.value),c.test(n.protocol))&&n.host===r.host&&l.activeElement===s&&(d.top.location.href=t.value))}},d.addEventListener("message",d.wp.receiveEmbedMessage,!1),l.addEventListener("DOMContentLoaded",function(){for(var e,t,s=l.querySelectorAll("iframe.wp-embedded-content"),r=0;r<s.length;r++)(t=(e=s[r]).getAttribute("data-secret"))||(t=Math.random().toString(36).substring(2,12),e.src+="#?secret="+t,e.setAttribute("data-secret",t)),e.contentWindow.postMessage({message:"ready",secret:t},"*")},!1)))}(window,document); //# sourceURL=https://hybrid-technologies.co.jp/blog/wp-includes/js/wp-embed.min.js /* ]]> */ </script> https://hybrid-technologies.co.jp/blog/wp-content/uploads/2022/03/22826033_s.jpg640427アジャイル開発とは アジャイル開発とは、システムやソフトウェア開発における手法のひとつです。従来のウォーターフォール開発はあらかじめ全工程にわたる計画を立ててからそれを実行する、というプロセスでした。それに対しアジャイル開発は、途中で生じる状況の変化へ適宜対応しながら開発を進めていくという手法です。 ”素早い”、”機敏な” という意味がある 「アジャイル(agile)」は、頭の回転が速いというニュアンスも含まれています。「計画・設計・実装・テスト」といった工程を機能単位の小さなサイクルで繰り返すことができるアジャイル開発は、まさに開発〜サービスインまでを素早く実行できる手法です。 アジャイル開発については、こちらの記事でより詳細にご紹介していますのであわせてご覧ください。 「アジャイル開発とは？」   アジャイル開発に設計書は必要？ アジャイル開発において、設計書などのドキュメントは不要と考えられる傾向にあります。効率とスピード感を重視し、個人間で対話をしながら開発を進めていく場合が多いからです。 また、アジャイル開発という概念が生まれるきっかけとなった「アジャイルソフトウェア開発宣言」では、「包括的なドキュメントよりも動くソフトウェアを価値とする」という一文があります。この内容も相まって、「アジャイル開発＝設計書(ドキュメント)は不要」という認識が強くなっています。 ただし設計書をまったく用意せず、口頭でのやりとりだけで開発を進めていけばチーム内で要件に関する認識の齟齬が生じる恐れがあります。言った・言わないによる混乱で開発が滞れば、アジャイル開発の大きなメリットである「スピード感」や「効率性」を損ないかねません。 アジャイル開発における設計書作成には、メリットとデメリットのどちらも存在します。それらを理解したうえで、チームにとって適した対策を取ることが大切です。 設計書を作成するメリット アジャイル開発で設計書を作成することのメリットとしては、以下の3つを挙げることができます。 ・要件に関する認識齟齬の防止 ・開発遅延の防止 ・運用の負担を軽減 先述の通り、設計書がまったく用意されていない中で開発を進めていくと要件に関する認識の齟齬が生じるリスクは高まります。そうなると、実装までのスピード感が失われ、アジャイル開発を採用する意味もなくなってしまいます。 また、何らかの事情があり別チームや新たなメンバーへの引継ぎが必要となった際、資料がなければ十分な引継ぎを行うことは困難です。開発者が運用をしない場合、または将来的に引継ぎの可能性が考えられる場合も設計書は作成するべきと言えます。 設計書を作成するデメリット アジャイル開発においても設計書が役立つとはいえ、以下のようなデメリットも潜んでいるため注意しましょう。 ・設計書の作成に時間がかかる ・柔軟に内容を変更することが難しい 設計書を作成するにあたり、多少なりとも時間を割く必要があるため実装までのスピード感が失われることになります。 また、短いスパンで改変を繰り返す前提にあるシステムは、設計書を作成してもリリースの度に内容が古くなってしまいます。 上記のデメリット、そして先ほど挙げたメリットを踏まえて考えると、設計書を作成してもしなくてもスピード感が失われる懸念は拭いきれません。では、どのように対応すればチーム内におけるコミュニケーションの円滑性と開発のスピード感を両立できるのでしょうか。   設計書とスピード感を両立させるポイント アジャイル開発のスピード感、そして設計書のような「認識齟齬対策」を両立するには、以下のポイントを押さえることが大切です。 テキストファイルにラフな設計書を記す APIのIF仕様書やDBテーブル設計書のように、しっかりとしたフォーマットをもとに設計書の内容を詰めても良いでしょう。しかしこれでは時間がかかるうえにハードルも高く感じやすいため、テキストファイルにラフな設計書を書き記す程度から始めてみることをおすすめします。 「設計書は詳細な内容を整えながら作るもの…」という意識は一度手放し、開発者間で作業内容をすり合わせる際のたたき台として使うメモといった感覚で作ってみましょう。それだけでも、開発のイメージを具体的にするための手助けになります。 チケット管理ツールを使う 「Redmine」や「Backlog」などのチケット管理ツールは、アジャイル開発におけるプロダクトバックログの管理に役立ちます。チケット管理ツールにてタスク単位で完了条件を記載しておけば、認識の齟齬を防ぐ対策として効果を発揮します。 しっかりと内容を詰めた設計書を作成するとなると、相応に時間がかかるものです。しかしチケット管理ツールで「メモ程度」にタスクを設定する形であれば、開発者の間で会話しながら記載できるため少ない時間でまとまります。 なお、ツールは好きなものを選んでも問題ありません。ただし「Google スプレッドシート」は導入しやすいものの、短いスパンで内容を更新する必要がある場合にはおすすめできません。更新の際に通知する機能がないため、誰かが行った追加・変更・削除などの編集を見落とす可能性があるからです。 タスクを細分化して設定する ラフな設計書作成やチケット管理ツールの利用を試しても効果が望めなかったり、継続が難しい場合は必要な作業を細かく区切ってリストにしてみても良いでしょう。 設計書ほど内容の詰まったドキュメントは残りませんが、作業の工程をタスク名として一言でまとめておくだけでも何をすれば良いのかすぐに把握できます。ただしタスクをまとめる際、ひとつのタスク名に対して複数の作業工程を詰め込むと混乱しやすくなるため注意しましょう。 「設計書」と「プロダクトバックログ」を使い分ける チケット管理ツールなどを用いたタスク管理は、どちらかというと「プロダクトバックログ」に分類される手段です。これだけでも開発をスムーズに進めるための効果はある程度期待できますが、設計書とはまた違う役割があり、プロダクトバックログだけではカバーしきれないケースも存在します。そのため、両者の役割を理解したうえで使い分けることが作業の効率性を上げるポイントです。 設計書とプロダクトバックログのどちらも作成すると、更新時に伴うスピード感の低下が危惧されるものです。しかし内容を変更する際、リアルタイムに更新をするのはプロダクトバックログだけで問題ありません。設計書は「長期的な保守をしやすくする」というのが主な役割なので、ある程度の仕様が固まってから反映するなど更新のタイミングを工夫するとスピード感も損なわれません。 デザインツールを使う ブラウザ上で簡単にデザインできる「Figma」や、Webサイトやモバイルアプリ等のデザインに使用できる「Adobe XD」を利用することもおすすめです。ツールを使いワークフローを作成したり、プロトタイプを作成しながら進める方法も効果的です。   プロダクトバックログの限界とは プロダクトバックログは設計書よりも作成に時間がかからず、チケット管理ツールなどを上手に利用すれば更新状況もリアルタイムで把握できるという点がメリットです。しかしプロダクトバックログを用意するだけでは、将来的な運用をスムーズにするための準備が万全であるとは言えません。 […]