NotionタスクからPR作成まで。 Claude Code 並列開発フローの設計

Transcript

1. NotionタスクからPR作成まで。 Claude Code 並列開発フローの設計 2026.01.29
2. ⾃⼰紹介 名前：河野晃基（こうのてるき） あだ名：てるさん、てるぼー、てるっち 所属：Contrea株式会社 - PMエンジニア ハリネズミの名前：ぽんず Claude Code歴：約8ヶ⽉ © Contrea Inc. 1
3. 01 並⾏で開発をしたいんだ...！ © Contrea Inc. 4
4. 思い⽴った背景 2025年11⽉頃にGit Worktree Runnerというもの、通称 GTR が出てきた。 Git Worktree（同じリポジトリに複数の作業ディレクトリを持てる）のラッパーライブラリ 特徴： • git管理していないファイルもコピーできる • worktree作成後に、hooksで コマンド実⾏（npm install）などができる → AIを並列実⾏しながら実装できたら、待ち時間も有効活⽤できて良さそう！ © Contrea Inc. 5
5. Contreaの環境 開発⼿法 スクラム開発 2週間スプリント形式 メンバー：4名 + 業務委託 タスク管理 Notion Sprint Boardで⼀元管理 利⽤しているAI 派閥によって様々 • Claude Code • Cursor © Contrea Inc. 2
6. 従来のフロー 1 Notionでタスク内容を確認 2 developブランチから派⽣して、タスク⽤ブランチ作成 3 Notionを適宜⾒つつ、機能を実装 4 ⼿元でリンター実⾏や型チェックを⾏う 5 PRの⽂章を作成 © Contrea Inc. 5
7. 従来のフロー 1 Notionでタスク内容を確認 2 developブランチから派⽣して、タスク⽤ブランチ作成 3 Notionを適宜⾒つつ、機能を実装 4 ⼿元でリンター実⾏や型チェックを⾏う 5 PRの⽂章を作成 © Contrea Inc. 5 ⾃動化してみよう
8. 02 Claude Codeのコマンドを作成 © Contrea Inc. 19
9. Claude Codeのコマンドを作った コマンド1つで、Notionタスクを読み取って実装開始できる！ • Notionタスク取得 から PR作成 まで⼀貫して⾃動化 ◦ Notionタスクには、背景‧ゴール（煩雑であれば実装⼿順を記載）する • ただし、全てAIに任せるのは不安... ◦ → ⼈間が確認するPhaseを 3回 挟んだ • 判断以外のルーティンワークはすべてAIに委譲 © Contrea Inc. 6
10. gtr-start の全体フロー Phase は 全部で6段階！ Phase 1 ‧Notionタスク取得 ‧GTRでブランチ作成 Phase 2 影響調査（⼈間確認①） Phase 3 実装プラン（⼈間確認②） © Contrea Inc. 7 Phase 4 実装‧テスト‧レビュー Phase 5 最終確認（⼈間確認③） Phase 6 PR⾃動作成
11. 03 Phase毎の役割 © Contrea Inc. 19
12. Phase 1：タスク取得 & 環境構築 作業開始コマンド： /task-start GEN-XXX のみ！ 情報の⾃動抽出 指定されたIDから、特定のNotionタスクを特定 Notion連携 MCP経由で要件を直接読み込み、コンテキスト化 独⽴環境の構築 GTRで作業環境作成 & 環境構築を⾏う © Contrea Inc. 8
13. Phase 2：事前調査 実装前にデグレが起こらないか、他に参照がないか影響分析 既存コード解析 関連するファイルや関数の依存関係を網羅的に調査 影響範囲の特定 変更による意図しない不具合のリスク箇所をリストアップ ⼈間確認① 調査結果の妥当性を確認。影響範囲 © Contrea Inc. 11
15. Phase 3：実装計画 AI側が、課題解決するための実装アプローチを提案 ステップ分解 ⼤きなタスクを⼩さな作業単位にしてTODOを確認 テスト⽅針の策定 どの機能をどうテストするべきか事前に説明 ⼈間確認② 実装アプローチ案でOKなら次へ、もっと良い案があればAIと壁打ちを⾏う © Contrea Inc. 13
16. Phase 4-6：実装‧テスト‧レビュー ⾃律的な動きを⾏い、実装の反復ループを⾏って品質向上 1 実装計画で出したTODOに基づいてコーディングの実施 2 テストコマンドの実⾏‧エラーがあった場合の修正ループ 3 実装後に、コーディング規約などのルールに基づいて反復レビュー（⾃動ループ） © Contrea Inc. 15
18. Phase 7：最終確認 & PR作成 開発のゴール結果を提⽰し、完了したらをPR作成 成果レポートの提⽰ 何を変更し、どのテストが通ったかを要約して出⼒ ⼈間による確認③ 最終的な動作とコードを⾒てGOサインを出す PRの⾃動⽣成 Notionの情報と実装内容を紐付け、フォーマットに従って説明⽂を記述 © Contrea Inc. 17
20. 04 まとめ − 作ってみて‧実⾏してみて © Contrea Inc. 19
21. 導⼊して良かったこと 簡単なタスクの爆速実装実現 • 簡単なタスク‧独⽴しているタスクであれば、複数でAIでの並列開発ができるようになった。 影響範囲調査や実装アプローチの質が⼀定に • ルールに基づいた調査を⾏えることで、実装前に⼀定の影響範囲調査ができる ◦ プランニング時にメンバーに説明可能 GTRが便利だと気づいた • ブランチを切るだけで環境構築ができるのは便利 • 簡単にAI起動‧エディター起動可能なのも 通常コマンドとして快適 © Contrea Inc. 21
22. 失敗したこと‧難しかったこと 複雑化したタスクには、まだ適⽤できない • 複雑なタスクになると、意図とは異なった実装になることがある ◦ Contextの関係やドメイン知識が不⾜しているのではないか？ ▪ Skillsやサブエージェントを⽤意 チーム全体への展開 • 並列作業だとスイッチングコストが⾼いので、なかなかチームに根付かない ◦ ⼀撃コマンドだと汎⽤性が低い ◦ 「Notionタスクを充実させたら良くない？」という意⾒も... そもそも簡単なタスクが来ない... • 世の中そんな簡単なもんじゃない。 © Contrea Inc. 23