AIへの再指示を抑える要件、設計、デザイン等のモバイル開発コンテキストの渡し方

◆イベント名
モバイルTechCafe～モバイルとAI駆動開発～
https://rakus.connpass.com/event/365427/

◆発表タイトル
AIへの再指示を抑える要件、設計、デザイン等のモバイル開発コンテキストの渡し方

◆登壇者
株式会社ラクス　楽楽精算開発部 開発3課　平川 裕多

Transcript

1. © RAKUS Co., Ltd. AIへの再指⽰を抑える要件、設計、デザイン等の モバイル開発コンテキストの渡し⽅ #MobileTechCafe 株式会社ラクス  平川 裕多 2025/09/02 1
2. さよなら、「ちょっと違うんだよな...」 2 AIとの⼿戻りを撲滅する、モバイル開発コンテキストの"渡し⽅" AIを「魔法の杖」から「最⾼の相棒」に変えるヒント
3. 3 こんな「AIあるある」、経験ありませんか？ ⼀⾏コードがはいりますandroid:configChanges="grammaticalGender" 私：ユーザープロフィールの画⾯、いい感じに作って！ AI：わかりました！（すごい勢いでコードを⽣成） 私：お、早い！...けど、デザインと違うな... 私：エラー表⽰は共通のエラー表⽰クラスがあるからこっちを使ってほしい 私：あとStateの管理⽅法、これじゃないんだよな... この往復、もったいなくないですか？ AIはエスパーではないのです。
4. 4 なぜAIとの"すれ違い"は起きるのか？ ⼀⾏コードがはいりますandroid:configChanges="grammaticalGender" • 情報過多： 指⽰が多すぎて、AIが重要な要件を⾒失う • 情報不⾜： 情報が⾜りず、AIが"推測"で実装する • 曖昧な指⽰： 「いい感じに」では、解釈がブレる • モバイルの暗黙知： 画⾯遷移や状態管理など、特有の"お作法"が伝わらない AIのせいじゃない。 「伝え方」 に原因があった 。
5. 5 解決策：AIが迷わないコンテキストを渡す AIに「全て」を毎回覚えさせるのはやめよう。 CLAUDE.md(AGENTS.md): 命名規則、ビルド⽅法、アーキテクチャ index.md: 画⾯⼀覧、ディレクトリ構成 指⽰書.md: 具体的で完結した指⽰ どの作業でも必ず知るべきルール 計画に必要な情報を集約 今回タスクの完了定義
6. 6 【実践】"伝わる"作業指⽰、Before/After 【再指⽰になる指⽰】 【⼀発で決まる指⽰ 】 *BViewはItemをタップされても画⾯遷移していない *これをCViewに遷移するようにしたい。 *Itemタップ時には以下の部分に記載されている ```具体的な実装箇所``` * また、CViewはDisplayInfoを受け取る前提となっているため作成す る必要がある。 * そのためにはAViewに習い、API通信を⾏う必要がある ```具体的な実装箇所``` * ただし、既存のAPI通信部分はレガシーな実装になっているため、 *async/await実装にラップしたasync関数を⽤意して利⽤すること * エラーハンドリングは別実装するのでTODOコメントを記載するこ と AViewを参考にして、BViewでItemがタップされたら CViewに遷移させたい
7. 7 【実践】モバイル特有の"暗黙知"を⾔語化する 「当たり前」だと思っていることこそ、 AIに伝えるべき最重要情報。 【レイアウト】 ❌「ローディング画⾯を上に表⽰して」 ✅「ZStackでナビゲーションバーより⼿前に 表⽰して」 【状態管理】 ❌「ユーザー情報を画⾯に表⽰して」 ✅「Viewの⽣存期間と同期させたいので @StateObjectで⽣成して」 【⾮同期処理テスト】 ❌「⾮同期処理のテストを作成して」 ✅「Task.sleepは禁⽌。Mockのコールバック でタイミングを制御して」 【命名規則】 ❌「APIエラーを処理して」 ✅「〇〇ドメインのエラーなので handle〇〇APIErrorとして」
8. 8 新しいワークフロー • PBI(プロダクトバックログアイテム）やFigma（デザイン）の情 報から⼈間が翻訳し、指⽰書を.mdで作成 • /launch-task実⾏で、指⽰書、Figma、既存コードからAIが計画 を⽴てる ◦ 外部情報はMCPで取得 • OKならコーディングを開始 必要なコンテキストだけ渡して手戻りを防ぐ
9. 9 今後の展望 ⼀⾏コードがはいりますandroid:configChanges="grammaticalGender" 人間の「解釈」や「翻訳」の仕事すら、徐々に自動化していく未来へ。
10. 10 ご清聴ありがとうございました ⼀⾏コードがはいりますandroid:configChanges="grammaticalGender" AIへの再指⽰を抑える要件、設計、デザイン等のモバ イル開発コンテキストの渡し⽅