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

並列開発する中で認知負荷を下げながら品質を担保するための tips

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest. →

並列開発する中で認知負荷を下げながら品質を担保するための tips

2026/10/27、【クラウドエージェントMeetUp】にて弊社社員がLT(ライトニングトーク)を発表いたしましたので、こちらに掲載いたします。

Transcript

15 slides
  1. Executive Summary AI駆動開発の速さは設計の詰めで決まる。 詰めを速くする鍵は、AIの指摘を具体で埋めて人間が即答できる形にすること Ⓒ Akari Inc. l Confidential 課題

    実装はAIが並列で回す。律速するのは、返ってきた設計案やレビューを人間が読んで 判断する速度。AIは抽象的な表現が多く、認知負荷が高い 2 打ち手 AIに上手な文章を書かせるのではなく、具体(原典・数値・適用対象)を最低2つ詰め 込ませる。抽象度合いは、AIのモデルの性能に依存するため、hooksなど後処理で改 善するのではなく、具体を明示的に吐き出させる。 3 仕組み AIはYAMLだけを書き、HTMLはテンプレートから生成する。 トークン数なども考慮しながらブラッシュアップする枠組みを作成。 1
  2. AI並列開発 これまでの開発方法:人間は「判断」に直列、AIは「実装」で並列 Ⓒ Akari Inc. l Confidential Claude codeでタスクを明確にした上でSlackを通してDevinにタスクを振ること で、ユーザーはブランチのマネジメントコストを抑えて開発が⾏える

    タスク切り タスク振り・実装 フィードバック 動作確認 Devin 「タスク切り」、 「タスク振り‧実装」、 「フィードバック」のフェーズで ブランチを切り替えずに実装が可 能。 Github issue登録 Claude Code タスク振り Slack タスク内容生成 適宜 フィードバック 確認・ ブラッシュアップ 特に「フィードバック」時は Slackのスレッドをわけてそれぞ れのタスクの進捗を管理できるた め、誤操作による⼿戻りの削減が 可能。 ユーザー
  3. AI並列開発 これまでの開発方法:人間は「判断」に直列、AIは「実装」で並列 Ⓒ Akari Inc. l Confidential Claude codeでタスクを明確にした上でSlackを通してDevinにタスクを振ること で、ユーザーはブランチのマネジメントコストを抑えて開発が⾏える

    タスク切り タスク振り・実装 フィードバック 動作確認 Devin 「タスク切り」、 「タスク振り‧実装」、 「フィードバック」のフェーズで ブランチを切り替えずに実装が可 能。 Github issue登録 Claude Code タスク振り Slack タスク内容生成 特に「フィードバック」時は 適宜 • ブランチの管理から解放 フィードバック Slackのスレッドをわけてそれぞ • レビューしやすい粒度でタスクをきるため、レ れのタスクの進捗を管理できるた ビューコストを削減 め、誤操作による⼿戻りの削減が 確認・ ブラッシュアップ 可能。 ユーザー
  4. 設計がボトルネック 実装はAIが並列で回すので、律速は人間が設計判断を下す速度 Ⓒ Akari Inc. l Confidential エージェントA 設計案・レビュー ここで渋滞

    エージェントB 設計案・レビュー 人間が読んで判断 案 案 回答を返す 案 判断する人は1人 エージェントC 設計案・レビュー 次の設計・レビューへ(Human-in-the-loop) ・設計を詰めるほど実装の手戻りは減る。ただ、詰めるのは人間との往復 ・エージェントを増やしても、判断する人間は1人のまま → 往復1回あたりの「読んで判断するコスト」を下げると、全体が速くなる 実装 AIが並列で回す
  5. 設計がボトルネック AIの抽象表現によって、深掘りを適宜実施する必要が発生し判断が遅くなる Ⓒ Akari Inc. l Confidential 「何いっとんねん。抽象的に言いすぎて、何を指してるかわからんわ」 例: 「ユーザー削除を論理削除に変える」設計案に、AIが返してきたレビュー

    分からないこと AIの指摘 読み手の頭の中 「この変更は既存の処理に影響があります」 何に? どの機能・API? どの範囲? 何箇所? どれくらい? 挙動が変わる? 型だけ? どのコード? 「関連箇所も合わせて修正が必要です」 関連箇所 = どのファイルの何行目? 何箇所ある? 全部同じ直し方でいい? どの変数? 「削除済みフラグの判定処理を修正します」 削除済みフラグ = is_deleted? deleted_at? 判定処理 = どの関数? 日本語名では grep で探せない なぜ? 「削除処理はリポジトリ層に寄せるべきです」 根拠は規約? ただの好み? 寄せないと何が困る? 今はどこにある? 出典は? 「要件定義書によると、削除は論理削除です」 どの資料の何節? 原文は何と書いてある? AIの解釈が混ざっていない? 影響は? ・答えはコードと資料の中。開き直して裏取りするのを、並列の本数ぶん繰り返すのが認知負荷の正体 ・回答も長文チャットになり、どの指摘への返事かが曖昧になって往復が崩れる
  6. 実際のシート Claude Codeのよく分からないFBをHTMLで具体的に表示 Ⓒ Akari Inc. l Confidential Claude CodeにFBを出力させた内容

    資料列の「約5800」という文字がでてるが、 なんの数字なのか分からない。 Skillで具体化させた内容
  7. ポイント:文章より具体 上手な文章を書かせるのではなく、具体を詰め込ませる Ⓒ Akari Inc. l Confidential 効きにくい 効く 文章をうまく書かせる

    具体を詰め込ませる hooks やプロンプトで、書き方を外から縛る 各項目に具体を最低2つ要求する ・「抽象的に書くな」と指示しても、やめられるかは モデルの精度次第 ・省略・言い換えは残り、読み手の裏取りは減らない ・具体 = 原典・数値・適用対象・変更前後・1ケース の追跡 ・文章が多少抽象的でも、具体を見れば何が言いたい か判断がつく 具体 ≥ 2 文章の質はモデルに依存する。具体の量は仕様で縛れる この考えで feedback-sheet-html スキルを plugin に追加した
  8. ポイント:文章より具体 抽象表現ごとに、置き換え先のYAMLフィールドを決めておく Ⓒ Akari Inc. l Confidential 抽象表現 → 置き換え先

    → 例 「〜すべき」「資料によると」 code(原典そのまま) path/to/x.py:88 の該当行、要件書 §3.5 の原文 「多くのファイル」 facts(規模の数値) 対象23ファイル / 呼び出し元14箇所 「関連箇所を直す」 targets(適用対象の名指し) 「現在の名前 → 変更後」の表 「適切に整理する」 before_after(変更前後) 現行コードと提案コードを左右に並べる 「コストがかかる」 example(1ケースの追跡) 1往復3,200トークン → 31往復で停止 code は資料の原文引用にも使い、caption に出典(パス:行、資料名+節)を必ず書かせる → 読み手が「本当にそう書いてあるか」を自分で判定できる
  9. ポイント:簡単な方針決定 AIにポジションを持ってもらうことで回答は選択肢と一言だけ Ⓒ Akari Inc. l Confidential 選択だから速い 取り違えない 消えない

    自由記述ではないので、判断を下すコ ストが小さい 番号付きで返るので、AIがどの項目へ の回答かを間違えない 入力は localStorage に自動保存。途 中で閉じても残る
  10. 考慮ポイント AIが書くのはYAMLだけ。出力はHTMLの約1/4、テンプレートは読ませない Ⓒ Akari Inc. l Confidential AIの担当 固定の仕組み(AIには読ませない) AI

    YAML エージェント 項目・具体・選択肢 build.py + template.html HTML 1ファイル・外部依存なし 約5,800文字 約25,300文字 約34,000 AIが書くYAML 生成されるHTML テンプレ+ビルドスクリプト AIが出力するのはこれだけ YAMLの約4.4倍 AIには読ませない ・SKILL.md で「テンプレとビルドスクリプトは読むな」と明示し、トークンの浪費と context rot を防ぐ ・見た目と挙動はテンプレートに固定。どのエージェントが作っても同じ見た目・同じ読み方 → 並列で何本も返ってきても、読み方を毎回学び直さなくてよい ※数値は plugin 付属のサンプル(3項目)で計測した文字数
  11. まとめ モデルの精度依存なのでAIに最初から具体的な文章を出させることは諦め、 明示的に具体例をわかりやすいビューで表示することで人間の認知負荷を解消 Ⓒ Akari Inc. l Confidential 1 2

    3 状況 状況 状況 AIの指摘がよく分からない 最初からHTMLで論点整理 したい HTMLの中身が薄い やること やること そのセッションのままスキルを 発動 やること スキルを発動 「もっと具体例を載せて」と FBする スキルの挙動 スキルの挙動 スキルの挙動 会話中の指摘を、原典・数値・適 用対象つきのシートに起こし直す 逆質問(何についてのシートか・ 対象・選択肢・出力先)で聞いて くる 同じ項目に情報を足して、同じ HTMLを上書き更新する 使いどころ: 設計レビューの指摘、命名の確認、要件レビュー、移行計画レビュー、設計判断の相談 「feedback-sheet-html」
  12. 弊社は、本書の作成および管理には万全の配慮をしておりますが、その内容に関する正確性および完全性について保証せず、また責任を負いません。弊社は、本書およ びお打合せ等で弊社がご提供する情報等(以下「本書等」といいます。)の提供及び本書等のいかなる利⽤について何ら保証するものではありません 。また、本書等に は将来に関する予測、⾒通し⼜は仮定(以下「予測等」といいます。)が含まれる場合があります。予測等に関しては、弊社が現在⼊⼿している情報および合理的であ ると判断する⼀定の前提に基づいており、弊社としてその実現や発⽣等を約束する趣旨のものではありません。 本書等に係る著作権(著作権法第27条及び第28条に係る権利も含みます。)、特許権、商標権その他の権利(以下総称して「知的財産権等」といいます。)は弊社⼜は 第三者に帰属しています。本書等について、弊社の許可なく複製、転⽤等する事は法律で禁⽌されています。また、弊社は、貴社に対し、第三者の知的財産権等につい て何らの許諾をしません。貴社は、本書等について複製、公表、販売、頒布⼜は修正することを禁じられています。 本書等は、弊社から貴社に提供する「秘密情報」に該当します。貴社は、弊社の事前の書⾯による承諾なく、本書等を第三者に対して開⽰⼜は提供することはできませ ん。

    本書等は貴社の参考のために提供されるものであり、貴社は⾃らの判断の下に本書等を利⽤するものです。弊社ならびにその役員および従業員は、本書等の利⽤に基づ き貴社が具体的にとった⾏為の結果を含む、貴社の本書等の利⽤によって⼜は本書等に関連して発⽣するすべての損害⼜は損失に関して、⼀切の責任を負いません。ま た、弊社は、本書等においてリンクが設定されている他のサイトの利⽤によって⽣じた損害⼜は損失に関しても、⼀切の責任を負いません。 Ⓒ Akari Inc. l Confidential

More Decks by 燈株式会社(Akari .inc)