デザインの決まりを AI に先に作らせた失敗と、順序を逆にした直し方

あらまし

このサイトを開くと、記事の一覧も、プランの案内も、検索も、チャットも、どの画面も同じ見た目で並んでいた時期があります。利用規約のような見た目です。原因をたどると、AI に見た目の決まりの文書を最初に作らせたことに行き着きました。AI は、手元に公開の定番デザイン資産があっても、訓練データのなんとなくの平均像から、影をほぼ全面的に禁じるような絶対の規則を自分で作って文書に固定することがあります。そして規則を固定することは、開発の操作の中で最も後戻りしにくい部類です。この記事では、その決まりが六日間でサイト全体を文書の見た目に均していった過程を、当日の記録から書きます。あわせて、既存の定番資産を基準に据え直して審査すると、一巡目に 34 件、二巡目に 18 件、ページ別の分析でさらに 44 件の指摘が出ました。この実測と、決まりを作る順序そのものを逆転させた直し方まで書きます。

本文では、決まりが生まれたときに何が固定されたかから始めて、悪化が三段階で進んだ構造、すなわち後から取り込んだ定番資産が自作の規則に従属したこと、機械検査の通過が正しさに見える循環ができたこと、AI が自作の規則を、僕が決めたことのように文書へ書いてしまった取り違えを順に見ます。そのうえで、転換点になった一言と、基準を替えた一晩の審査の実測、最後に決まりを作る順序の原則までを扱います。

対象読者と持ち帰れるもの

AI エージェントと一緒にプロダクトを作っていて、コーディング規約やデザインシステムのような決まりの文書を AI に書かせている人、これから書かせようとしている人に向けた記事です。AI が規則を作るときに踏む失敗の型を、実際の履歴と数字で持ち帰れます。あわせて、決まりの文書の項目に由来のタグを義務づけるという、規則の出どころの取り違えを構造で防ぐ小さな仕掛けも持ち帰れます。この記事は、このサイト自身の開発の一次記録に基づく実践の記録です。