Upgrade to Pro — share decks privately, control downloads, hide ads and more …

design docで開発効率を向上させる

design docで開発効率を向上させる

Avatar for Kota Minato

Kota Minato

January 20, 2026
Tweet

More Decks by Kota Minato

Other Decks in Technology

Transcript

  1. © 2025 Wantedly, Inc. 01 自己紹介 02 抱えていた課題 03 design

    docとは 04 どのように作成しているのか 05 design doc導入後の変化 CONTENTS
  2. © 2025 Wantedly, Inc. 名前:湊 航太 / Kota Minato 入社:2025年2月

    ポジション:iOSエンジニア 性格診断:ハーモナイザー MBTI:ISFP(冒険家) 自己紹介
  3. © 2025 Wantedly, Inc. design docとは 上長に相談した(12月初旬) Design Docは、 👉「この機能を

    なぜ・何を・どうやって 作るかを事前に 整理・共有する設計ドキュメント」です。 プロダクト開発におけるdesign docってなん ですか? 端的に教えて下さい! AIに聞いてみた 実装前にdesign doc作ってみたら? 1.マージまでのリードタイムが長い 2.問題の原因が特定できてない という課題があります、、、
  4. © 2025 Wantedly, Inc. どのように作成しているのか STEP 01 背景、目的 STEP 02

    仕様の不明点 STEP 03 設計方針 STEP 04 完了条件 以下4項目をIssueに記載
  5. © 2025 Wantedly, Inc. どのように作成しているのか Issue上に書き起こす 目的、仕様不明点、設計方針、完了条 件をIssueに記載。 Issue上に書き起こし、上長にレビュー をもらう。

    チームの資産にする チームメンバー誰が見ても理解できる ように記載する。 チームの資産として残す意識。 自分の言葉で書く 自分の言葉で言語化 することで 理解できていない箇所に気づける。 AIはレビュー時に使用する
  6. © 2025 Wantedly, Inc. design doc導入後の変化 問題の原因が特定できていない 「ここを直せば動きそう 」で実装   詳細な原因調査を飛ばしてしまう

    PRで別の原因では?との指摘 手戻りが発生 Befor after 自分の言葉で説明できるまで調査 レビューを通し原因の認識が揃う     結果的に適切な howで実装可能に 実装後手戻りがなくなる
  7. © 2025 Wantedly, Inc. design doc導入後の変化 問題解決の視座が上が る design docのレビューを継続している

    と、「これ指摘されそうだな、、、」がわ かってくる 上長からみてどうか? PRレビュー時にコードの妥当性を確認 すれば良いのでレビュー時の負荷は 減っているとの言葉をいただいた。 自己視点 他者視点