Claude Codeで/logoスキルを5つの誤りから作る — SVGパス、正規表現のバウンディングボックス、間違った漢字

AIエージェントと一緒に、このブログのロゴとコード用フォントを作り直した記録です。壊れたSVGの字形、正規表現で計算したバウンディングボックス、間違った漢字、そしてそこから生まれた/logoスキルを扱います。

更新

白いカードにテラコッタ色のClaudeの星形ロゴと黒のロゴタイプ
目次

はじめに

長いあいだ気に入っていなかったロゴを、ようやく直すことにしました。このプロジェクトが初日に自動生成したテキストだけのマークで、それ以来、このマークをどうするか誰も決めていませんでした。

AIエージェントとロゴをデザインするには、何ラウンドも重ねる必要があります。エージェントが候補を出し、私が見て、削り、その理由を伝え、もう一度回す。知りたかったのは、このループをClaude Codeのスキルとして書き残す価値があるかどうかでした。

エージェントはラウンドを重ねるなかで5回、自信満々に間違えましたが、どれも無駄だったとは思っていません。5つの誤りのうち4つは、それぞれルールを1つ残しました。そのルールは今では/logoスキルと3本のスクリプトになり、次のマークの出発点になっています。

公開したのは、桜の字を入れた朱色の印と、その隣にFrauncesで組んだ「oharu」、そして記事ページだけで読み込むJetBrains Monoです。

デザインのないブログを、そのまま使い続けていた

ファビコンはこうなっていました。

以前のファビコンを3つのサイズで角の丸い青い四角の中央に白い小文字の o が入ったマークを、128・32・16ピクセルで並べたもの。文字はどのサイズでも判別でき、16ピクセルでは中央に小さな明るい形のある青い四角に見える。ooo128px32px16px
角の丸いrectと、Helvetica,Arial,sans-serifを指定した<text>要素1つだけでできたマークを、ファビコンが使われる3つのサイズで並べています。文字の形は、訪問者のOSが用意したフォントで決まります。

ヘッダーにはマークすらなく、サイトタイトルがテキストで置いてあるだけでした。

タイポグラフィも同じ状況でした。

src/styles/global.css
--font-sans: ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, …;
--font-mono: ui-monospace, 'SF Mono', SFMono-Regular, Menlo, Consolas, …;

システムフォントのスタックだけです。フォントは1つも指定されていませんでした。訪問者は全員、自分のOSに入っているフォントで読んでいたことになります。これは正当なトレードオフです(転送量ゼロ、レイアウトシフトゼロ)。ただし、誰かが判断して選んだ結果ではありませんでした。

誤り1: 1つのアイデアの24バリエーション

最初は幅広さを求めました。アイコンのみ、ワードマーク、両者を組み合わせたマークにまたがる24案を、それぞれ128px・32px・16pxで同時に見られるギャラリーにまとめてもらいました。

24案はそろいました。ところが、どれも小文字のoを軸にしたロゴでした。

グリッドに並んだ8つのアイコン案。どれも小文字のoの変形で、リング、点の付いたリング、枠に入ったo、山形記号とoの組み合わせなど。すべて同じ太さの青い単線と丸い線端で描かれている

これはシートのうち、アイコンだけの3分の1です。アパーチャ、軌道、ターミナル、円弧、鳥居、スクワークル、プロンプト、分割。1つの絵に名前が8つ付いているだけでした。

どれも均一な線で描いた幾何学的な図形で、円と円弧、一定の線幅、丸い線端でできています。アイコンでもワードマークでも骨格は同じで、その骨格は自動生成されたロゴによくあるデフォルトです。幅を求めたのに、届いたのは同じ案に8通りの名前を付けたものでした。

解決策は、生成する前に実在するデザインを見ることでした。6つのサイトのビジュアルアイデンティティをスクリーンショットに撮り、実際に観察しました。

参照先何をしているかラウンド1でやっていたこと
Linear、Astroベタ塗りで、マークは小さく控えめすべて線で描いており、16pxでは潰れる
Rauno Freiberg、Josh Comeauマークを持たない。書体と、これと決めた1色だけマークは必須だと思い込んでいた
Maggie Appletonディスプレイ用のセリフ体。文章を書くサイトだからテンプレートのデフォルトである幾何学的なサンセリフ
Anthony Fu個人のモノグラムと、手書き風の文字純粋な幾何学からは「個人らしさ」が出てこない

実際のサイトから引き出した制約を与えたので、ラウンド2では本当に違う案が返ってきました。

16案が、エディトリアルなセリフ体、グロテスク、朱色の判子、色を添えた文字、モノグラムに分けて並んでいる。1つではなく5つの異なるアイデアであることが一目で分かる

AIにN案を求めると、1つの分布から取り出したN個のサンプルが返ってきます。

誤り2: 一度もレンダリングされなかった字形

手で描いたSVGの字形には、レンダリングしないと見えないバグが潜んでいます。ラウンド1の字形は、一度もレンダリングされないままギャラリーに並びました。いちばんひどかったのはuの字です。

u(描いたまま)
M9,49 L9,99 A41,41 0 0 0 91,99 L91,140

ペンの動きとして読んでみます。左のステムをx-heightからy=99まで下ろす。ボウルの円弧で(91,99)まで渡る。そこからベースラインまで線を引く。円弧が終わるのはy=99なので、右のステムは99から140までしかありません。上半分がまるごと欠けています。結果として、右側が途中で切れたuがレンダリングされます。

修正では、右のステムを独立したサブパスとして、x-heightの高さいっぱいに描きます。

u(修正後)
M9,49 L9,99 A41,41 0 0 0 91,99
M91,49 L91,140

「oharu」の文字が2つ。上は最後のuの右のストロークが高さの半分で止まっている。下は同じ語で、ストロークが隣の文字と同じx-heightまで伸びている

この種のバグはブラウザで見れば一目瞭然なのに、パスデータを読んでいるだけでは見えません。

誤り3: エージェントが決めつけた漢字

ラウンド2でいちばん強かったコンセプトは判子(hanko)、つまり個人の印でした。名前を押す印は、個人ブログという場の性格によく合います。朱色の地に、1文字を白抜きで入れる案です。

名前が「oharu」なので、エージェントは最初、春(haru)の字で判子を作りました。見た目は良かったものの、これは間違いでした。私は訂正しました。「oharu」は桜明と書くので、haruに当たる漢字は「明」です。最終的には、より個性が出る「桜」を判子に選びました。

桜明が2文字であることで、変わったのはグリフ1つではなくデザインそのものでした。16pxのファビコンでは、2文字は判読できません。そのサイズでは、10画の漢字は潰れてただの模様になってしまいます。

朱色の印の案が6つ。それぞれ大きく表示され、さらに32ピクセルと16ピクセルでも並んでいる。16ピクセルでは2文字の案は輪郭のない塊になり、1文字の丸印だけがまだ読める

桜明を縦に並べた案は、この名前の判子としては正しいものの、ブラウザのタブではいちばん読みにくくなりました。輪郭線だけの案は枠こそ残るものの、「桜明」の2文字はほとんど見えなくなります。そこで判子は丸型にして、「桜」1文字だけを入れました。

誤り4: 正規表現で計算したバウンディングボックス

本番用のアセットでは手描きの文字をやめ、fontToolsとHarfBuzzを使って書体のアウトラインを焼き込みました。ワードマークにはFraunces、桜にはNoto Serif JPを使っています。正しいカーニングと線の強弱が、そのままパスデータとして固定されます。そのため、ワードマークはウェブフォントのリクエストもフォールバック書体のちらつきもない図形として配信されます。

グリフを配置するには、実際に描かれる範囲の境界が必要です。SVGのパスデータは、ペンの動きを並べたものです。英字1文字が動作を表し、その後に移動先の座標が続きます。たとえばL720,50は(720,50)まで直線を引く命令で、xとyの両方を持ちます。outline.pyはパス文字列から数値をすべて抜き出し、xとyが交互に並んでいるものとして扱っていました。

ところが文字には完全に水平・垂直な辺が多く、SVGPathPenはそれらをHとVの省略形で書き出します。H700は「yはそのままで、x=700まで水平に引く」という意味なので、座標を1つしか持ちません。水平線が1本あるだけで、それ以降のすべての数値の偶奇がずれます:

Hがそれ以降のペアをすべてずらす仕組みパスM0,0 H700 L720,50を、コマンドと数値の並びとして示した図。上には実際に通る点(0,0)、(700,0)、(720,50)。下には同じ数値をx、yの交互のペアとして読んだ結果。(0,0)は正しいが、Hは座標を1つしか持たないため、それ以降の(700,720)と(50, …)はずれている。実際の点パス正規表現のペアM00H700L72050(0,0) ✓(700,0) ✓(720,50) ✓(0,0) ✓(700,720) ✗(50, …) ✗
H700はx座標を1つしか持たないため、正規表現がそれ以降に読むペアはすべて数字1つ分ずれます。

このバグは、ギャラリーで何度見ても「少しずれている」程度にしか見えず、そのまま見過ごされました。疑いようがなくなったのは、幅がおよそ3200ユニットになるはずのロックアップが、1802で出力されたときです。

修正は、文字列の解析をやめてライブラリに測らせることです。

outline.py
from fontTools.pens.boundsPen import BoundsPen
bounds = BoundsPen(glyph_set)
for info, pos in zip(buf.glyph_infos, buf.glyph_positions):
xform = (scale, 0, 0, -scale, (x + pos.x_offset) * scale, 0)
glyph_set[name].draw(TransformPen(pen, xform))
glyph_set[name].draw(TransformPen(bounds, xform)) # same transform

fontToolsで計測すると、ワードマークの実際の境界は2456.4 × 758.6でした。正規表現はそれまでずっと別の値を返しており、人の目で確かめるまで誤りに気づけませんでした。

誤り5: 全ページに入ったプリロード

コードブロックにも専用の書体を用意しました。技術ブログで読者がいちばんじっくり読むのはコードブロックです。それなのに、このブログではMenloで表示されていて、本文と同じく「誰も決めていない」状態でした。

選んだのはJetBrains Mono VariableのLatinサブセットだけで、サイズは40KBです。URLでプリロードできるよう、固定のパスにセルフホストしました。コードはLatin文字で書かれます。そのためコード用にCJKフォントは取得せず、CJKのフォントスタックもそのままです。

プリロードは共有レイアウトに入れました。それが間違いだった理由は、ブラウザが教えてくれました。

The resource http://localhost:4321/fonts/jetbrains-mono-latin.woff2 was
preloaded using link preload but not used within a few seconds from the
window's load event. Please make sure it has an appropriate `as` value and
it is preloaded intentionally.

トップページ、タグ一覧、CJKの2つのインデックスページには、コードが1つもありません。どのページも40KBをダウンロードし、まったく使っていませんでした。そこで、ArticleLayoutがpreloadMono propを渡したときだけプリロードを出力するようにしました。結果は次のとおりです。

ページrel="preload"のリンク数
dist/index.html0
dist/ja/index.html0
dist/tags/index.html0
dist/blog/<article>/index.html1

ラウンドから生まれた/logoスキル

/logoスキルの原則:

  1. 何かを生成する前に、実在するサイトのデザインを研究する。
  2. どの案もレンダリングして16pxで確認してから、ユーザーに見せる。
  3. 名前の漢字のように、本人に関わる事実は思い込まず、必ず確認する。
  4. 文字は手描きの字形ではなく実在する書体のアウトラインを使い、境界の計測もfontToolsに任せる。
  5. 色は理論ではなく、案を並べて比べて決める。
  6. すべての関門で、選ぶのはユーザーである。

スキルには、案を提示し、理由を添えて推薦し、そこで止まるように書いてあります。意見は役に立つが、決めるのはあなたではない。本記事のどのラウンドも、私が選ぶゲートで終わっています。

機械的な作業は3本のスクリプトが受け持ちます。

  1. gallery.mjsはコンタクトシートを組み立て、ローカルのポートで配信します。
  2. outline.pyはfontToolsとHarfBuzzを使い、書体のアウトラインをパスデータに焼き込みます。
  3. build-brand-lockup.mjsは、ファビコンとヘッダーコンポーネントを出力する実例です。

コンセプトとシートは作業用の一時ディレクトリに書き出し、リポジトリには入れません。デザインのラウンドで出る案はほとんどがボツで、ボツ案はリポジトリに置くものではありません。

公開したもの

完成したのは、桜を入れた朱色の丸印と、その隣にFrauncesで組んだ「oharu」です。SVGは2つに分けました。印とワードマークを並べた完全版と、印だけの狭い画面向けの版です。狭い画面向けの版は完全版から切り抜けません。印は文字より意図的に低くしてあるので、正方形に切り抜くと隣の文字まで入ってしまうからです。

画面幅が50rem未満のときは、印だけを表示します。これで古いレイアウトの問題も1つ解決しました。スマートフォンでは、テキストのワードマークが検索コントロールと場所を取り合っていたのです。

色の判断の1つは、候補を並べて見比べることで決まりました。サイトのアクセントカラーは#1d4ed8、印は#d8452aです。この2色は色相環でほぼ反対側にあり、青いワードマークを赤い印の隣に置くと、目に見えて喧嘩します。ワードマークにはテーマの文字色を使い、青はリンクだけに残しました。これで2色が隣り合うことはありません。

ワードマークのパスデータ3569バイト(座標を整数に丸め、5145バイトから削減)
印のパスデータ1677バイト
favicon.svg1878バイト
JetBrains Mono、Latinサブセット40KB、記事ページのみ
/ja/の記事でのウェブフォントリクエスト1件(JetBrains Mono)、CJKフォントはなし

まとめ

誤りは5つ。そのどれも、コードについて推論するだけでは見つかりませんでした。

良いデザインを導き出すには実在するサイトとの比較が、壊れた字形にはブラウザが、間違った漢字には私の訂正が、バウンディングボックスのバグには気づけるほど不自然な数値が、無駄なプリロードにはコンソールが必要でした。

この5つこそが、ロゴ作りを1回のプロンプトで済ませず、ループとして回す理由です。いまや仕上がった24案を出すのに数分しかかかりません。だからこそ、量を幅と取り違えたり、推測の上に作られた自信満々の成果物を受け入れたりしやすくなっています。

1回のプロンプトにはなくてループにあるのは、レンダリングすること、計測すること、そしてデザインが私しか知らない事実に左右されるときに質問することです。

5つのどれも、当時は無駄だと感じませんでしたし、今読み返しても無駄には見えません。次のマークは、白紙のプロンプトではなく、6つのルールと3本のスクリプトから始まります。

この記事をシェア