ダブルクリックで英日反転
Applied Sciences · Design
What actually happens when Claude Code settles on a design
A retrospective look at Claude Code's own decision-making during a real session: design here is not creation from nothing but constrained imitation of references.
The four-step process observed
- User set three constraints: "simple", "light", "not AI-ish".
- Reference search first: sub-agents studied jbranchaud/til and simonw/til to extract common patterns.
- "Not AI-ish" resolved via reverse-lookup heuristic — emoji/gradients = AI-ish → drop; monochrome/sparse = OSS-ish → adopt.
- Theme chosen by vocabulary match: "minimal" → picked `jekyll-theme-minimal` (no more than a same-name search).
What this reveals about AI design
- Output quality is directly tied to the quality of the reference sources provided.
- Zero visual verification was built in — a kramdown rendering bug in `<details>` slipped through to production.
- Verification must be an explicit step in the workflow, not assumed.
Key terms
- spawn — launch a child agent (Agent tool) in an independent context, from OS process-creation terminology.
- heuristic — a rule-of-thumb shortcut to a good-enough answer rather than an optimal one.
- rendering bug — code is syntactically correct but the display engine misinterprets it (e.g. kramdown ignoring Markdown inside raw HTML blocks).
→ Claude Code designs by imitating good references through a constraint filter — supply better sources and build in visual verification.
Applied Sciences · Design
Claude Code がデザインを決定するまでに実際に起きていること
このTILリポジトリを構築したセッションを振り返り、Claude Code 自身の意思決定プロセスを観察した記録。デザインは「ゼロからの創造」ではなく「参照＋制約フィルタによる模倣」だった。
観察された4ステップ
- ユーザーが提示した制約は3つ：「シンプル」「軽量」「AIっぽくない」。
- まず参照検索：サブエージェント（＝独立コンテキストで動く子エージェント）を生成し jbranchaud/til と simonw/til の共通パターンを抽出。
- 「AIっぽくない」は逆引きヒューリスティック（＝「これはNG」を起点に逆算する近似的判断法）で解釈：絵文字・グラデーション＝AI臭 → 排除、モノクロ・簡素＝OSS臭 → 採用。
- テーマ選択は語彙マッチング：「minimal」と指示 → `jekyll-theme-minimal` を選択（同名検索に過ぎない）。
AIデザインの本質
- 出力品質は提供する参照ソースの質に直結する。良い参照を渡せば良い結果が出る。
- ビジュアル検証（＝実際の見た目を確認するステップ）がゼロだった結果、kramdown（＝Jekyll 標準の Markdown パーサー）の `<details>` 内レンダリングバグが本番まで漏れた。
- 検証は「あって当然」ではなくワークフローに明示的に組み込む必要がある。
重要用語
- rendering bug（レンダリングバグ）：コードは文法的に正しいが表示エンジンが意図通りに描画しない不具合。
- Jekyll（ジキル）：Markdown と YAML から HTML を生成する Ruby 製静的サイトジェネレーター。GitHub Pages の標準エンジン。
- jekyll-theme-minimal：GitHub が公式提供する Jekyll テーマの一つ。装飾を極限まで省いた技術系サイト向けの定番。
→ Claude Code のデザインは「良い参照を制約でフィルタした模倣」——良い参照を与え、ビジュアル検証を必ずワークフローに組み込むこと。
Applied Sciences · Design
What actually happens when Claude Code settles on a design
A retrospective look at Claude Code's own decision-making during a real session: design here is not creation from nothing but constrained imitation of references.
The four-step process observed
- User set three constraints: "simple", "light", "not AI-ish".
- Reference search first: sub-agents studied jbranchaud/til and simonw/til to extract common patterns.
- "Not AI-ish" resolved via reverse-lookup heuristic — emoji/gradients = AI-ish → drop; monochrome/sparse = OSS-ish → adopt.
- Theme chosen by vocabulary match: "minimal" → picked `jekyll-theme-minimal` (no more than a same-name search).
What this reveals about AI design
- Output quality is directly tied to the quality of the reference sources provided.
- Zero visual verification was built in — a kramdown rendering bug in `<details>` slipped through to production.
- Verification must be an explicit step in the workflow, not assumed.
Key terms
- spawn — launch a child agent (Agent tool) in an independent context, from OS process-creation terminology.
- heuristic — a rule-of-thumb shortcut to a good-enough answer rather than an optimal one.
- rendering bug — code is syntactically correct but the display engine misinterprets it (e.g. kramdown ignoring Markdown inside raw HTML blocks).
→ Claude Code designs by imitating good references through a constraint filter — supply better sources and build in visual verification.
Applied Sciences · Design
Claude Code がデザインを決定するまでに実際に起きていること
このTILリポジトリを構築したセッションを振り返り、Claude Code 自身の意思決定プロセスを観察した記録。デザインは「ゼロからの創造」ではなく「参照＋制約フィルタによる模倣」だった。
観察された4ステップ
- ユーザーが提示した制約は3つ：「シンプル」「軽量」「AIっぽくない」。
- まず参照検索：サブエージェント（＝独立コンテキストで動く子エージェント）を生成し jbranchaud/til と simonw/til の共通パターンを抽出。
- 「AIっぽくない」は逆引きヒューリスティック（＝「これはNG」を起点に逆算する近似的判断法）で解釈：絵文字・グラデーション＝AI臭 → 排除、モノクロ・簡素＝OSS臭 → 採用。
- テーマ選択は語彙マッチング：「minimal」と指示 → `jekyll-theme-minimal` を選択（同名検索に過ぎない）。
AIデザインの本質
- 出力品質は提供する参照ソースの質に直結する。良い参照を渡せば良い結果が出る。
- ビジュアル検証（＝実際の見た目を確認するステップ）がゼロだった結果、kramdown（＝Jekyll 標準の Markdown パーサー）の `<details>` 内レンダリングバグが本番まで漏れた。
- 検証は「あって当然」ではなくワークフローに明示的に組み込む必要がある。
重要用語
- rendering bug（レンダリングバグ）：コードは文法的に正しいが表示エンジンが意図通りに描画しない不具合。
- Jekyll（ジキル）：Markdown と YAML から HTML を生成する Ruby 製静的サイトジェネレーター。GitHub Pages の標準エンジン。
- jekyll-theme-minimal：GitHub が公式提供する Jekyll テーマの一つ。装飾を極限まで省いた技術系サイト向けの定番。
→ Claude Code のデザインは「良い参照を制約でフィルタした模倣」——良い参照を与え、ビジュアル検証を必ずワークフローに組み込むこと。