Issue設計から始める仕様駆動開発 / 20260731 Mizuki Hirata

by SHIFT EVOLVE

Embed

Start on current slide

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

本発表の経緯背景・未経験メンバーへタスクを割り当てながら開発を推進・限られた期間で、進捗管理と成果物品質の両立が課題 →AI時代のジュニアエンジニアはアウトプットを量産できる一方、その粒度や品質には大きなばらつきがある。学び・何を作るかよりも「どの単位で仕事を渡すか」が重要・タスクの粒度や完了定義が曖昧だと開発効率が下がる AI駆動開発の課題・AIも人と同様に曖昧な指示では期待通りに動きにくい・開発品質の標準化が必要→Issue駆動開発で解決！ Copyright SHIFT Inc., All Rights Reserved. 3

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

「いきなりAI駆動開発」がもたらす悲劇抽象的な指示暴走する実装差分の肥大化「○○機能を実装して」とAIに丸投げ不要なリファクタリング実装者・レビュアー共に理解不能なPRに既存実装との乖離コードが書かれる速度は圧倒的に向上したが、検証・修正し、手戻りに対応するコストが最大のボトルネック開発の主戦場は「早く書かせる」から「手戻りなく制御する」へ →開発品質の標準化この課題を解決するアプローチ SpecからIssue設計に落とし込む Copyright SHIFT Inc., All Rights Reserved. 6

Slide 7

Slide 7 text

ソフトウェア開発における「Issue」の定義『イシューからはじめよ』※における “イシュードリブン”とは別物 ✕ ビジネス書のIssue ✓ AI開発におけるIssue ・漠然とした「問い」「仮説」・AIが迷わず自律実行・完遂できる単位・そのままAIに渡すと解釈がブレる・極小／単一責任かつ明示的なタスク Copyright SHIFT Inc., All Rights Reserved. ※安宅和人『イシューからはじめよ［改訂版］―知的生産の「シンプルな本質」』英治出版、2024年 7

Slide 8

Slide 8 text

Issue ＝開発者が見慣れた「チケット」と捉えるプロジェクトの進捗を管理するタスク管理ツール（Jira, Backlog, GitHub Projectなど） Feature Issue #00001 ユーザー情報と課金状態を管理するテーブルを追加実装方針 ✕✕✕・・・ Issueは1〜2日で完了できる単位・具体的で単一責任・明確な完了定義（DoD） →現場で標準化されていないことが多い ✓ AI駆動開発成功の鍵 Copyright SHIFT Inc., All Rights Reserved. 8

Slide 9

Slide 9 text

Issueだけで開発した場合の病 Issue ・Spec実現の作業単位・機能追加・バグ修正・リファクタリング・短寿命な設計 AIに起こる現象・既存設計を理解せず実装・局所のみ正しいコード・短期間でのみの解決策発生する問題・全体の整合性が崩壊・コード重複・責務の分散・技術的負債の蓄積 Issueを満たす局所最適な実装によってシステム全体の整合性が崩壊してしまう Copyright SHIFT Inc., All Rights Reserved. 9

Slide 10

Slide 10 text

解決策：SpecとIssueの「双方向同期」 Spec 双方向同期ループ Issue ① 切り出し・タスク化・判断基準・制約・設計原則・一貫性 ② 最新の実装と同期・作業境界・実装範囲・完了定義・優先順位 ✓ 解決：双方向同期 ①仕様からIssueを切り出して実装 ②完了したら仕様に反映して最新化これを繰り返し、アーキテクチャの一貫性と自律生産性を両立 Copyright SHIFT Inc., All Rights Reserved. 10

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

壁①への対応策と教訓実装単位をIssueに落とし込み、完了定義と作業境界を明示する ① Issueに分割「散見するロジックの共通化」 →「画面コンポーネント」「エラーハンドリング」 ➁ 作業境界を明示変更可：Service/Repository 変更禁止：認証基盤・共通ライブラリ ③ 完了定義を明示対象ディレクトリを指定・全テスト成功 Copyright SHIFT Inc., All Rights Reserved. 13

Slide 14

Slide 14 text

遭遇した壁②：作業の重複とコンフリクト個人で並列実装・メンバーとともに実装のどちらでも起こりうる問題 Issue A バックエンド実装担当 PR作成バックエンドも必要だとAIが判断 Issue B フロントエンド実装担当 PRレビュー/merge時に・不要な工数が発生・コンフリクト修正の手間・不要なコードの残存 PR作成不毛なコンフリクトや作業の重複が発生・2つの要件のチケットを別々に並行で処理させたことで重複実装が生じる・チケット間の関係性や並行制御が不明瞭だとコンフリクトを招く Copyright SHIFT Inc., All Rights Reserved. 14

Slide 15

Slide 15 text

親Issueが持つ役割：全体設計と共通ルールを握る親 Issue：○○画面全体設計：目的・スコープ・責務分担・共通ルール・API設計共通コンポーネント：UserSettingService 制約：新規 Service 作成禁止 Issue A DB実装 Issue B BE実装 Issue C FE実装親Issueを共有コンテキストとして利用する・単なる管理単位として親チケットを扱わず、子チケットの実装を同期・親Issue→設計の一貫性を保持して子Issueを用いた実装の並列化に成功 Copyright SHIFT Inc., All Rights Reserved. 15

Slide 16

Slide 16 text

Slide 17

Slide 17 text

役割：レビューの主戦場はIssue設計レビューへ Spec Issue 双方向同期デザイナー人間は仕様設計とIssueへの分割に専念 Issue設計レビュー AIに渡す前に完了定義と作業境界を合意・完了定義は妥当か、境界線は正しく閉じているか、実装方針は問題ないか →人間同士が事前に議論・合意し、Issue設計時点で不具合の芽を摘む開発品質の標準化のためのアクションが重要 Copyright SHIFT Inc., All Rights Reserved. 17

Slide 18

Slide 18 text

これからのエンジニアに求められる AIに対して脱線しないためのレールを敷くこと求められるのはプログラミングの知識そのものではなくシステム全体を俯瞰しながら適切に境界を定義し、それをIssueとして言語化・メンバーとの合意形成を進めていく力境界を定義 Issueとして言語化メンバーと合意「コードを書く人」から「AIが正しく動く仕組みを設計する人」へ Copyright SHIFT Inc., All Rights Reserved. 18

Slide 19

Slide 19 text

Slide 20

Slide 20 text

全体フロー：仕様から実装・mergeまでの作業 ①仕様書を用意 ④チケット自動生成・要件定義、設計書を投入・docsに配置して管理・タスク管理ツールAPIで一括作成・メンバーに展開・確認 ➁機能単位で抽出 ⑤実装「○○画面の設計」・既存実装の調査・タスクの洗い出し・チケット番号を指定して自動実装〜PR作成 ③Issueに分解 ⑥レビュー・merge ・タスク間の関係性・見積もりと完了定義・レビュー用エージェント・docs更新エージェント Copyright SHIFT Inc., All Rights Reserved. 20

Slide 21

Slide 21 text

Slide 22

Slide 22 text

開発時の実装フローテンプレート例 ①仕様書を用意・要件定義、設計書を投入・docsに配置して管理 ➁機能単位で抽出「○○画面の設計」・既存実装の調査・タスクの洗い出し ③Issueに分解・タスク間の関係性・見積もりと完了定義 Copyright SHIFT Inc., All Rights Reserved. ・実装方針、タスクリスト（Issue分解用）、注意点など洗い出し時に調査してほしい内容はテンプレート化・調査で重視したい範囲はAgents.mdやSkillsで指定 22

Slide 23

Slide 23 text

Issueをチケットで管理するチケット作成プロンプト例 ④チケット自動生成・タスク管理ツールAPIで一括作成・ラベルのルールなど PJごとの固有ルールを追加して管理・調整 Discussion! Agree! ・チケットをきれいに作成することよりもメンバーと認識齟齬がないか確認することが重要・Issueの粒度に落とし込んだにもかかわらず「わからない」を避けるための自動化に Copyright SHIFT Inc., All Rights Reserved. 23

Slide 24

Slide 24 text

Slide 25

Slide 25 text

Issueによる実装品質の標準化モデル依存の低減・テンプレート化によってAnthropic、 OpenAI、 Googleなどの差が出にくい →思考特性の影響はあるが、テンプレート化によって出力形式の差が埋められる →modelベンダーが異なっていても一定品質を維持・実装時点でOpus、Sonnetのような同一ベンダー内の性能差に依存しにくい → Issueに分解するステップに設計に必要な推論・実装方針を決める指示追従性を切り出し →model性能差の影響を抑えられるメンバー依存の低減誰が担当しても同じIssueを基に実装するため成果のばらつきを抑制 Issue分解が品質の下限を引き上げる実装品質の標準化 Copyright SHIFT Inc., All Rights Reserved. 25

Slide 26

Slide 26 text

Slide 27

Slide 27 text

Issue→実装の自動化実装用プロンプト例 ⑤実装・チケット番号を指定して自動実装〜PR作成・/start-work [チケット番号] 明示的に作業を指定・PJ特性に合わせて改良例)branch戦略、静的解析… ・コマンド実行後に作業フローを確認し、誤った実装や作業フローがあればコマンド内の指示がおかしいのか子チケットの粒度がおかしいのか検証・改善する・最終的には自動実行しても問題なく実装完了できる→実装者には依存しない Copyright SHIFT Inc., All Rights Reserved. 27

Slide 28

Slide 28 text

PR作成・レビュー ⑥レビュー・merge ・レビュー用エージェントや標準のhooksで自動化・実装方針mdを用意しレビュー指摘を集積して反映・更新していく・ここまでの作業で人の手が介入したのはIssue作成のみ・Claudeのscheduleで実装コマンドを呼び出しPR作成まで自動化→Codexのhooksでレビュー Copyright SHIFT Inc., All Rights Reserved. 28

Slide 29

Slide 29 text

Slide 30

Slide 30 text

開発フローのまとめ ①仕様書を用意 ④チケット自動生成・要件定義、設計書を投入・docsに配置して管理・タスク管理ツールAPIで一括作成・メンバーに展開・確認 ➁機能単位で抽出 ⑤実装「○○画面の設計」・既存実装の調査・タスクの洗い出し改善！・チケット番号を指定して自動実装〜PR作成 ③Issueに分解 ⑥レビュー・merge ・タスク間の関係性・見積もりと完了定義・レビュー用エージェント・docs更新エージェント Copyright SHIFT Inc., All Rights Reserved. 30

Slide 31

Slide 31 text

個人のふりかえりを加えた最適化の取り組みここまでに紹介したAIが行う作業や自身が受けたレビューはすべてドキュメント化 →疑問点や自身の弱点を集めたナレッジベースとして管理・受けたレビュー指摘を集めて自分特化レビュー指摘エージェント・弱点を深堀して技術ブログでアウトプット標準化→PJや個人の特性に合わせた最適化まで可能に Copyright SHIFT Inc., All Rights Reserved. 31

Slide 32

Slide 32 text

本運用におけるToken cost メリット・ドキュメントを参照 →調査にかかるコスト抑制・Issue単位で実装方針が明確 →AIとの往復回数を削減デメリット・各テンプレートやドキュメントの整備・フィードバックサイクル分の Token使用料が発生設計実装従来・設計時へコストを前倒し・設計／Issue分割のコストは一部の担当者へ集約 Issue ・実装担当者は少ないコンテキスト&安価なモデルで開発可能 →Claude Codeにおける「Opusで設計、Sonnetで実装」の思想と同義組織単位でみれば設計担当者と実装者に付与する契約形態でコスト運用できる可能性・Token Costは開発が進むほど減少する Copyright SHIFT Inc., All Rights Reserved. 32

Slide 33

Slide 33 text

Slide 34

Slide 34 text

Slide 35

Slide 35 text

仕様・実装・テストが「完全自動同期ループ」する未来仕様書を更新 Issue分割エージェントの実装静的解析 review 人間が「仕様設計」「Issue分割」「レビュー」に集中し実装はAI主体となる未来エンジニアが担うのは仕様とIssueの設計品質に基づいて自律型エージェントを適材適所に配置するハーネスエンジニアリング Copyright SHIFT Inc., All Rights Reserved. 35