crafted by Mize ↗
Open Repository Intelligence Open Repository Intelligence
CodeLens ACTIVE
CodeLens Engine
StatusOnline
Versionv0.4
ModelClaude Sonnet
Latency—
← Articles
Manifesto · 01

Experience First

レビュー画面ではなく、一冊のレポートを設計した理由

CodeLensAI · Engineering Journal

最初は、レビュー画面を作ろうとしていた。

スコアを出す。Issue を並べる。よくある構成だ。
でも途中で気付いた。私たちが作っていたのは、画面ではなかった。一冊のレポートだった。

採点ではなく、レポート

コードレビューツールの多くは、点数を出して終わる。62点。B評価。——そこで物語が閉じる。
けれど本物のレビューは、点数では終わらない。点数は、長いレポートの中の一行にすぎない。

だから、設計をひっくり返した。
Analyze → Score ではなく、Analyze → Summary → Report。
スコアは結論ではなく、読み始めの入口になった。

建物として設計する

そう決めた瞬間、UI は「画面の集まり」ではなく、一つの建物になった。
ロビーがあり、廊下があり、部屋がある。

レビューを依頼しても、別画面には飛ばない。同じ部屋の中で世界が少し暗くなり、AI が読み始める。
Read。Understand。Remember。
やがてレポートが本編として立ち上がり、最後に Memory として棚に残る。そして静かに、本を閉じる。End of Review。

ページ遷移は、一度もない。
本を読むのに、画面は切り替わらないから。

細部が、体験をつくる

この体験は、大きな機能ではなく、小さな判断の積み重ねでできている。

  • スコアが着地してから本編に入るまでの、0.5秒の間。
  • 数字とバッジを一体に見せる、6px の距離。
  • 一文を二つに分ける、8px の息継ぎ。

どれも数値化できない。コードは一行も増えていない。
けれどこの距離と余白と間が、「眺める」を「読む」に変える。

Experience First.

私たちは UI を作ったのではない。
読む体験を設計した。

Next → Repository Intelligence AI は何を読んで、何を覚えるのか