本文へスキップ
SOFTWARE公開中

uniboshi.net

いま読んでいるこのサイトそのもの。情報設計からデザイン、実装、二言語対応、アクセシビリティ、配信インフラまでを一貫して手がけました。生成AIを使いながら、保守できる状態で仕上げています。

公開
更新
タグ
サイト
デザイン
アクセシビリティ
パフォーマンス
多言語
AI活用

いま読んでいる、このサイトそのものです。情報設計から配信まで、すべて自前で手がけました。

手がけた範囲

  • 情報設計とデザイン
  • デザインシステムの構築(配色、余白、罫線、タイポグラフィ、アイコン)
  • フロントエンド実装
  • 日本語・英語の二言語対応
  • アクセシビリティ対応と検証
  • パフォーマンス最適化と計測
  • 配信インフラの構築
  • RSS・サイトマップ・構造化データ・OG画像などの周辺出力

既成テーマやデザインテンプレートは使っていません。デスクトップ環境を下敷きにした UI も、操作に反応して要素がわずかに動く演出も、このサイトのために設計して組んだものです。

仕上がりの基準

目が見えにくい方に届くこと。 文字と背景のコントラストは、実際に画面へ塗られたピクセルから測っています。計算値を読むと、それらしく間違った数字が出るためです。背景に動く作画が重なる箇所は、その作画の一番明るい部分に対して確認しました。配色は色覚特性のシミュレーションを通したうえで 6 色の距離を測り、そもそも色だけが意味を伝えている箇所が 1 件もないことを確かめています。スクリーンリーダーの見出し一覧からページ全体を把握でき、自動検査では全ページ形状・両テーマ・2つの画面幅で違反ゼロを維持しています。

手でポインタを動かせない方に届くこと。 ページ形状とテーマと画面幅の組み合わせ 36 通りを Tab キーだけで走査し、1,030 箇所の停止すべてでフォーカス位置が見えること、到達できない操作要素がないこと、閉じ込めが起きないことを確認しました。メニューは Escape で閉じ、フォーカスは開いたボタンに戻ります。押す対象の大きさと、文字間隔を広げたときの崩れも実測済みです。動きが苦手な方のために、prefers-reduced-motion を指定した環境では演出が動きません。

JavaScript が無効でも読めること。 本文の表示にスクリプトは一切関わっていません。

低性能な端末と細い回線で速いこと。 高速な環境で速いのは当たり前なので、CPU を 4 倍に遅くした状態と低速回線を基準に測っています。

二言語のどちらかが古くならないこと。 UI の文言は型で縛ってあり、日本語に項目を増やすと英語を埋めるまでビルドが通りません。翻訳漏れが本番に出ない構造です。

ダークテーマが後付けでないこと。 配色はライトとダークを個別に検証しています。片方だけ読みにくいという状態になりません。

推測で済ませないこと。 速さも読みやすさも、実際に測ってから直しています。

AI を使って、この水準に届かせること

このサイトのコードは生成 AI を使って書いています。使うかどうかではなく、使ったうえでこの水準に届かせられるかが差になると考えています。

AI は速い代わりに、間違いを自信を持って差し出します。このサイトの制作中に実際に起きたことを、種類ごとに挙げます。

  • 測っていない数字を断定する。 「あるページだけ他より何倍も重い」という分析が出ましたが、条件を揃えて測り直すと平均的で、結論ごと誤りでした。
  • デザインの筋が通らない。 飾り枠の左右両側にウインドウ操作ボタンが並び、閉じる機能が二重に見える状態になっていました。意味を持つ色の隣で、意味のない色だけを巡回させる実装も出てきました。
  • 動かすまで分からないバグ。 メニューを開いたまま画面幅を広げると、タスクバーに切り替わってもメニューが残り続けました。ブレークポイントを知っているのがボタンだけで、状態側が知らなかったためです。
  • 仕様を思い込む。 画面幅による表示切替が効かない、要素ごとの色指定が効かない、画像が縦に潰れる。いずれも CSS の仕様の読み違いで、詳細度を見比べても理由が分からない種類の失敗でした。
  • 道具を信じすぎる。 性能計測ツールが実測の数倍の値を返し、コントラスト検査は存在しない違反を報告しました。後者は検査する側の読み取り方が誤っていたものです。
  • 検証していないことを書く。 「キーボードだけで操作できる」という一文が、一度も試さないまま原稿に入っていました。
  • 環境を壊す。 ライブラリを入れる操作で本体のバージョンが勝手に下がり、別の場面では文字コードを変換してしまう方法で日本語のソースが破壊されました。
  • 規約に書いてあることを繰り返す。 過去に同じ原因で壊れ、対策まで文書化してあった失敗を、同じ形で再現しました。

どれも、出てきたものを必ず読んで疑う前提で進めていたから止まっています。

止めるのは人間の仕事です

AI は依頼されたことを完遂しようとします。やめるべきかどうかは判断しません。だから丸投げにはしていません。

表示を大幅に速くする変更が出てきたことがあります。数字だけ見れば採用一択でしたが、採用しませんでした。確かめると、画面外の見出しが支援技術から消え、一覧ページの用途そのものを壊す変更でした。調べたきっかけは「デメリットを詳しく」という問いで、聞かなければそのまま入っていました。効果が大きい提案ほど、何を引き換えにしているかを確認します。

直すより戻した方が速いこともあります。前提が誤っていた分析が出たときは、その上に積み上げた検討ごと捨てて、数段階前からやり直しました。間違った前提を部分的に直すと、合っている箇所と間違っている箇所が混ざり、どこまで信用できるか分からなくなります。

今やらない判断もします。削除予定のものに手をかけない、並び順は全体が揃ってから決める。AI は言われれば全部やりますが、やらない範囲を決めるのは人間の側です。

止めるために用意したもの

これらはそのまま納品物に含まれます。

  • 判断の記録。 なぜその実装を選んだか、何を試して駄目だったかを規約として書き残しています。項目はどれも、実際に何かが壊れてから書かれたものです。引き継いだ人も AI も、同じ失敗を繰り返さずに続きから作業できます。
  • 機械が確かめる手順。 型チェック、ビルド、整形、アクセシビリティの自動検査に加えて、実際のブラウザを起動して動きが生きているかを見る回帰テストを置いています。人間の目は変更した箇所しか見ませんが、壊れるのは変更しなかった箇所です。
  • 採用を別の工程として扱うこと。 生成されたことと採用することは別です。読み、疑い、必要なら丸ごと捨てます。

AI で短期間に作ることと、引き渡したあとに保守できることは、両立させる手間をかければ両立します。その手間の中身が、この3つです。

起きた問題と対処は 生成AIでサイトを作って、実際に起きたこと に詳しく書きました。アクセシビリティをどう測ったかと、測って初めて分かった思い違いは 少数派に届いているかは、測らないと分からない にあります。

同じ水準でご依頼いただけます

企業サイト、サービスサイト、技術ドキュメント、多言語サイトなど、同じ作り方でお引き受けできます。アクセシビリティ要件のある案件や、既存サイトの表示速度の改善だけでもご相談ください。

サイト以外もお引き受けします

このサイトを見本にしているのは、見せられるからです。URL を渡せば、配色でもキーボード操作でも、書いてあることをその場で確かめていただけます。一方で普段の主な仕事はインフラとセキュリティで、こちらは画面に映らず、守秘の範囲も広いため、同じようにはお見せできません。見本がサイトなのは得意分野の表明ではなく、公開できる成果物だからです。

そして、ここまで書いた作り方は、もともとサイトのための作法ではありません。推測で変更しない。判断を文書に残す。機械が確かめられる手順を用意する。AI の出力を丸ごと採用しない。いずれも、やり直しの効かない領域で必要になって身についたものです。サイトに適用すると表示速度とアクセシビリティになり、インフラに適用すると可用性と権限設計になります。成果物の見た目が違うだけで、中身は同じです。

お引き受けできる範囲です。

  • インフラ構築とクラウド移行。 Kubernetes、Docker、AWS・Azure・GCP。現状の可視化やアーキテクチャ設計からでもご相談いただけます。
  • CI/CD と認証基盤。 自動テストとデプロイの整備、OIDC 連携。このサイトに置いた検査の仕組みは、これの小さい版です。
  • バックエンドと API。 設計、実装、既存システムとの連携。
  • セキュリティチェックとバグ調査。 原因の切り分けから、再現手順の作成、修正まで。
  • 機械学習。 モデルのファインチューニングと、そのためのデータセット作成。公開しているモデル もあります。
  • アプリ開発。 音声認識を使うもの、XR グラス向けのもの を手がけています。
  • 組み込みとハードウェア。 ドライバーやデバイスツリーの作成から、デバイス本体の設計 まで。

裏付けは、Linux Kernel や Kubernetes への継続的なコミット と、国家規模の LLM 系インフラおよびセキュリティ基盤の構築経験です。層をまたいで触ってきたので、どの層に原因があるかの切り分けからお引き受けできます。

窓口は Uniboshi-Commission にまとめてあります。受けられる業務の一覧と、稼働条件はこちらです。

どう作ったかは このサイトの技術構成 に書きました。