# 一つの画面は綺麗でも、画面のあいだと状態の変化は抜け落ちる

> AIが書いたコードを、私は本番に近い環境に出して確かめます。E2Eテストだけでなく、Codexにアプリを操作させることもあります。抜け落ちやすいのはコードの品質ではなく、ドキュメントに書かれない時間軸の処理です。画面の一つは綺麗でも、あいだと状態の変化は省かれやすく、AIはそこを推測で埋めます。

- Published: 2026-11-21
- URL: https://abalol.xyz/posts/between-screens/
- Language: ja
- Tags: tech, ai, engineering
- Author: Tomohiro Owada
- Site: Tomo's Diary (https://abalol.xyz/llms.txt)

---

AIが書いたコードを、私は本番に近い環境に出して確かめます。E2Eテスト（エンドツーエンドテスト：実際の使い方に近い流れで、アプリ全体を動かすテスト）だけでなく、Codex（コードを書いたり、アプリを操作させたりできるAI）に、実際にアプリを操作させることもあります。いちばん抜け落ちやすいのはコードの品質ではありません。ドキュメントに書かれない、時間軸に沿った処理です。状態の管理、画面の遷移、そして「元の目的を考えたら、人間ならそうするよね」と分かる動き。これらは書いておけば防げます。

## 「問題なさそう」が見逃すもの

先日、Xでこんな投稿が広がっていました。「It looked good to me.（私には問題なさそうに見えた）」。AIが書いたコードの時代に、いちばん危ない五つの単語だ、という話です（[投稿](https://x.com/roee/status/2123450837422718985)）。見た目が正しそうでも、出す準備ができているとは限らない、とも書いてあります。

見て整っているものは安心しやすい。一つの画面だけを見ると、綺麗に見えることは多いです。

## 画面のあいだは、書かないと残らない

私が危ないと感じるのは、そこです。画面の一つひとつは整っているのに、画面と画面のあいだや、状態の変化がデザインから抜け落ちる。そうすると、AIはその穴を推測で埋めます。

これは書けば防げます。問題はUI（ユーザーが触る画面）のデザインを Claude Design や Figma で作るようになってから、画面遷移図（どの画面からどの画面へ進むかを描いた図）が省かれやすくなったことにあります。Claude Design はAIと対話しながら画面などのデザインを作る仕組みで、Figma は画面のデザインを作るツールです。画面を一枚ずつきれいに整える作業は進みやすい。ただ、画面から画面へどう進むか、その途中で状態がどう変わるかは、別に書かないと残りません。

以前書いた[AIの時代も最後の1%に100%のコストを払わない選択を](https://abalol.xyz/posts/solid-not-heavy/)では、テストを増やして重くすることが、ちゃんとやっている気持ちにつながる、と述べました。E2Eテストで流れを追っていても、ドキュメントに書かれていない時間軸の処理は見逃されやすい。見た目が問題なさそう、で終わらせると、そこで抜けます。

## 書いておけば、推測しなくて済む

だから私は、本番に近い環境に出して、テストだけでなく、実際に操作して見るようにしています。Codexに操作させるのも、そのためです。一つの画面の綺麗さでは分からない、あいだの動きを拾いたいからです。

「問題なさそう」がいちばん危ないのは、見た目の話ではありません。書いていないあいだを、誰かが考えてくれたつもりになることです。画面遷移と、時間軸に沿った処理を書いておけば、推測で埋めなくても済みます。

