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

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

Sponsored · SiteGround - Reliable hosting with speed, security, and support you can count on.
Avatar for Kota Minato Kota Minato
January 20, 2026

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レビュー時にコードの妥当性を確認 すれば良いのでレビュー時の負荷は 減っているとの言葉をいただいた。 自己視点 他者視点