---
title: デザインハーネスをエンジニア向けに説明する
tags: 
author: [ゆにねこ](https://docswell.com/user/9031733)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/4EZLN1YG73.jpg?width=480
description: https://design-harness.slides.yuni.cat/
published: September 25, 26
canonical: https://docswell.com/s/9031733/KJW13N-design-harness
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/4EZLN1YG73.jpg)

SLIDES
design-harness.slides.yuni.cat
デザインハーネス
をエンジニア向けに説明する
〜デザイナーの判断基準を、コードと同じように運用する〜
ゆにねこ / AIAU・GDG関西 / 2026/09/25

# Page. 2

![Page Image](https://bcdn.docswell.com/page/Y76W8LDQ7V.jpg)

自己紹介
X
@harineko_univ
SPEAKER
ゆにねこ
Σjk
AIAU
GDG関西 スタッフ

# Page. 3

![Page Image](https://bcdn.docswell.com/page/G75M913274.jpg)

AIでUIを作ると起きること
デザインシステム・トークン・
コンポーネントは完備
design-system/
tokens
保存する
詳細を見る →
表示名
components

# Page. 4

![Page Image](https://bcdn.docswell.com/page/9J2921Z1ER.jpg)

AIでUIを作ると起きること
デザインシステム・トークン・
コンポーネントは完備
それでも AI生成画面は
「それっぽいけれど、何かが違う」
profile.html - AI 生成
プロフィール編集
表示名
表示名
保存する
詳細を見る

# Page. 5

![Page Image](https://bcdn.docswell.com/page/DEY4YZR4JM.jpg)

AIでUIを作ると起きること
デザインシステム・トークン・
コンポーネントは完備
それでも AI生成画面は
「それっぽいけれど、何かが違う」
レビューで繰り返される同じ指摘
profile.html - AI 生成
プロフィール編集
表示名
このユースケースなら
ボタンではなくリンク
×9
保存する
詳細を見る
送信失敗時に
入力値消失はNG
×11
この余白はこっちの
トークンを指定
×14

# Page. 6

![Page Image](https://bcdn.docswell.com/page/VJNYP3D678.jpg)

判断基準や
「なぜダメなのか」の理由は、
デザイナーの頭の中にしかない。

# Page. 7

![Page Image](https://bcdn.docswell.com/page/YE9P39GRJ3.jpg)

判断基準は「個人の頭の中」と「散在した議論」にある
個人の課題 判断基準の未言語化
「どれも妥当に見えてしまい、
自分の意見を言い切れない」[N1]

# Page. 8

![Page Image](https://bcdn.docswell.com/page/GE8DM9VGED.jpg)

判断基準は「個人の頭の中」と「散在した議論」にある
GitHub
Slack
Confluence
Figma
議事録
個人の課題 判断基準の未言語化
「どれも妥当に見えてしまい、
自分の意見を言い切れない」[N1]
チームの課題 判断経緯・文脈の散在
「なぜ最小幅 210px なのか」を知るのは古参メンバーのみ
[Z1]

# Page. 9

![Page Image](https://bcdn.docswell.com/page/LELM3W5X7R.jpg)

判断基準は「個人の頭の中」と「散在した議論」にある
GitHub
Slack
AI エージェント
Confluence
Figma
議事録
個人の課題 判断基準の未言語化
「どれも妥当に見えてしまい、
自分の意見を言い切れない」[N1]
チームの課題 判断経緯・文脈の散在
「なぜ最小幅 210px なのか」を知るのは古参メンバーのみ
[Z1]
どちらも暗黙知のまま → AIから参照できない

# Page. 10

![Page Image](https://bcdn.docswell.com/page/4JMYD933JW.jpg)

エンジニアには見覚えがある構造
かつてのコード開発
いまのデザイン・UI生成
コーディング規約はシニアの頭の中 ≈ 判断基準はデザイナーの頭の中
レビューで毎回同じ書き方の指摘 ≈ デザインレビューで毎回同じ指摘
「なぜこの実装なのか」は Slack にある ≈ 「なぜこの余白なのか」は Slack にある

# Page. 11

![Page Image](https://bcdn.docswell.com/page/PJR94GQR79.jpg)

エンジニアには見覚えがある構造
かつてのコード開発
いまのデザイン・UI生成
コーディング規約はシニアの頭の中 ≈ 判断基準はデザイナーの頭の中
レビューで毎回同じ書き方の指摘 ≈ デザインレビューで毎回同じ指摘
「なぜこの実装なのか」は Slack にある ≈ 「なぜこの余白なのか」は Slack にある
→ linter, CI, ADR で解決 → ?

# Page. 12

![Page Image](https://bcdn.docswell.com/page/PEXQ2X5YJX.jpg)

デザインハーネスとは
DESIGN.md ・ tokens.json ・ rules/
専門職の判断基準を頭の外に出し、コードのように運用する。
書ける
レビューできる
差分が残る
全員に配れる
— 橋本 哲勇 (LayerX) [P1] p.12 / nicotomo さんの要約: 「デザイナーの判断基準を頭の外に出し、コード同様に運用する仕組み」[N1]

# Page. 13

![Page Image](https://bcdn.docswell.com/page/3EK9MW64ED.jpg)

デザインハーネスとは
ポイントは
書き出し
ではなく
運用
ドキュメントの増量ではなく、
実参照・自動検査・継続更新の仕組み化
実参照
生成プロンプトで使われる
継続更新
改善サイクルで使われる
自動検査
チェック処理で使われる

# Page. 14

![Page Image](https://bcdn.docswell.com/page/L73WY16D75.jpg)

「コード同様に運用する」とは
コード運用の仕組み
バージョン管理 (Git)
ルールへのID付与
lint / 自動テスト
CIによる継続検証
ドリフト (乖離) 検知
ADR / PR レビュー

# Page. 15

![Page Image](https://bcdn.docswell.com/page/87DK5XV2JG.jpg)

「コード同様に運用する」とは
コード運用の仕組み
デザインハーネスでの対応物
バージョン管理 (Git)
DESIGN.md ・ トークン・コンポーネント契約を Git 管理
ルールへのID付与
HTML-BUTTON-TYPE 等、ルールIDと検査ロジックを紐付け
lint / 自動テスト
UIの自動チェッカー (違反時は exit 1)
CIによる継続検証
CLI / MCP / CI パイプラインで共通チェッカーを実行
ドリフト (乖離) 検知
再生成した成果物と実ファイルの差分検知 (ビルド失敗)
ADR / PR レビュー
判断背景の記録、ルール変更の「提案 → 承認 → 適用」
新しい概念はほとんどない。管理対象が「ソースコード」から「デザインの判断基準」に置き換わっただけ。

# Page. 16

![Page Image](https://bcdn.docswell.com/page/VJPKGPVLE8.jpg)

ハーネスが担う4つの責務
制約
何を使ってよいか、何が必須か
デザイントークン、コンポーネントAPI、ルール定義
文脈
誰のために、なぜ作るのか
開発ブリーフ、ユースケースシナリオ、設計判断の背景
フィードバック
次に何を変えるべきか
不具合修正、ルール・チェックロジック自体の継続的更新
検証
成果物が基準を満たしているか
自動チェックログ、レンダリング結果、人間によるレビュー
相互連動
単なる4フォルダの作成ではなく、4責務の相互連動が肝要 [C1][C2]

# Page. 17

![Page Image](https://bcdn.docswell.com/page/2EVV62Z6EQ.jpg)

ハーネスが担う4つの責務
制約
√ 既存のデザインシステムで保証
何を使ってよいか、何が必須か
デザイントークン、コンポーネントAPI、ルール定義
文脈
√ 既存のデザインシステムで保証
誰のために、なぜ作るのか
開発ブリーフ、ユースケースシナリオ、設計判断の背景
フィードバック
!不足しがち
次に何を変えるべきか
不具合修正、ルール・チェックロジック自体の継続的更新
検証
!不足しがち
成果物が基準を満たしているか
自動チェックログ、レンダリング結果、人間によるレビュー
相互連動
「制約」(デザインシステム) は既存でも、「検証」「フィードバック」が不足しがち [C2]

# Page. 18

![Page Image](https://bcdn.docswell.com/page/57GLNR42EL.jpg)

知識の種類を混ぜない
事実
要件
好み
未決
危険: 好みや未決の暫定仕様が、厳格なルールと同列に扱われること

# Page. 19

![Page Image](https://bcdn.docswell.com/page/4EQYQVG9JP.jpg)

知識の種類を混ぜない
事実
要件
好み
未決
具体例
ボタンの variant は
2種類
扱い方
実装コードを信頼できる
情報源 (SSOT) として参照
具体例
送信失敗時も
入力フォーム値を保持
扱い方
テスト・検査可能な
判定条件として定義
具体例
根拠提示を
オファーより前に配置
扱い方
理由と適用スコープを
セットで記録
具体例
配信媒体向け
ブランドルール未策定
扱い方
「未決」と明示し、
AIの勝手な推測を遮断

# Page. 20

![Page Image](https://bcdn.docswell.com/page/KJ4WNM8R71.jpg)

知識の種類を混ぜない
事実
要件
好み
未決
具体例
ボタンの variant は
2種類
扱い方
実装コードを信頼できる
情報源 (SSOT) として参照
具体例
送信失敗時も
入力フォーム値を保持
扱い方
テスト・検査可能な
判定条件として定義
具体例
根拠提示を
オファーより前に配置
扱い方
理由と適用スコープを
セットで記録
具体例
配信媒体向け
ブランドルール未策定
扱い方
「未決」と明示し、
AIの勝手な推測を遮断
nicotomo さんの個人ハーネスでの実践原則 [N1]
① 実際に下した判断のみを記録
② 迷ったものは「未決」とし、判断材料 (実測値・検証結果) とセットで保留
③ 固定の「正解集」ではなく、検証を重ねる「仮説集」として運用

# Page. 21

![Page Image](https://bcdn.docswell.com/page/LE1Y582V7G.jpg)

事例: LayerXのデザインハーネス
CASE STUDY - LayerX (バクラク) DesignOps の実践事例 [P1]
仕組みは3つの要素でできている
判断
事実
改善
判断
Markdownで記述した判断基準
(ルールID・重要度付き)
≒ 制約・文脈
事実
デザインシステム MCP
(公式コンポーネント・既定値をAIが直接参照)
≒ 制約
改善
採点基準とテストケースで
回答品質を継続的に再測定
≒ 検証・フィードバック
出典: 橋本 哲勇 (LayerX) 「デザインハーネス: 専門職の判断基準をコードのように運用する」Bet AI Day 2026, p.13

# Page. 22

![Page Image](https://bcdn.docswell.com/page/GEWG5ZR3J2.jpg)

事例: 感覚をルールに翻訳する
× 「なんか色が合っていない気がする」
デザイナーの感覚のまま → 観察も再現もできない
出典: 橋本 哲勇 (LayerX) Bet AI Day 2026, p.14

# Page. 23

![Page Image](https://bcdn.docswell.com/page/47ZLN1RGJ3.jpg)

事例: 感覚をルールに翻訳する
× 「なんか色が合っていない気がする」
観察できる条件に翻訳
DSU-COLOR-001
MUST
カラーコードのベタ書き禁止、定義トークンで指定
color: #3B82F6; → color: var(--color-primary);
ルールIDを付与
重要度 MUST / SHOULD / MAY を明示
≒ lint ルールの定義そのもの
出典: 橋本 哲勇 (LayerX) Bet AI Day 2026, p.14

# Page. 24

![Page Image](https://bcdn.docswell.com/page/YJ6W8LRQJV.jpg)

事例: 根拠がなければ「評価不可」と答える
AI デザインレビュー結果
色の指定
根拠: DSU-COLOR-001
√ 評価済み
余白の取り方
根拠: 該当ルールなし
評価不可
一般的な UX 論での補完
勝手に隙間を埋めない
しない
ルール整備のバックログ
不足ルール候補:
余白トークン規定の未整備
該当ルールが無い観点は「評価不可」――一般的な UX 論で勝手に補完しない
不足しているルールの候補を同時に提示 (例: 余白トークン規定の未整備)
回答の放棄ではなく、ハーネス自身のカバレッジの限界を明示する仕組み
出典: 橋本 哲勇 (LayerX) Bet AI Day 2026, p.18

# Page. 25

![Page Image](https://bcdn.docswell.com/page/GJ5M9182J4.jpg)

事例: 知識はコードと同じように動く
利用ログ分析
ギャップ検出
改善PR 作成
人間レビュー
マージ
チーム全員の AI
使われるほどログが貯まり、次の改善へ
ルールがマージされた瞬間、チーム全員の AI の挙動に反映される
出典: 橋本 哲勇 (LayerX) Bet AI Day 2026, p.19

# Page. 26

![Page Image](https://bcdn.docswell.com/page/LE3WY181E5.jpg)

事例: 知識はコードと同じように動く
利用ログ分析
ギャップ検出
改善PR 作成
人間レビュー
マージ
チーム全員の AI
使われるほどログが貯まり、次の改善へ
ルールがマージされた瞬間、チーム全員の AI の挙動に反映される
登壇時点での運用規模 [P1]
ルール定義
5ファイル
約1,600 行
判定単位
約 37
AI レビュー付きPR
339件
累計
AI 指摘で修正・再パス
37%
直近 111件中
出典: 橋本 哲勇 (LayerX) Bet AI Day 2026, p.19

# Page. 27

![Page Image](https://bcdn.docswell.com/page/8EDK5XMK7G.jpg)

全体像
人が読むビュー (カタログ・テーマ)
信頼できる情報源 (SSOT)
DESIGN.md ・ tokens
契約・ルール
カタログ + 依存解決
MCP
知識取得・検査の
インターフェース
Agent Skills
作業手順のパッケージ
(作成 / レビュー / 改善)
成果物
提案 → 人間の判断 → 更新
承認された更新
承認された更新だけが
情報源へ戻る
提案
レポート + 判断の経緯
LLM Wiki: 設計判断の経緯・
背景理由のナレッジベース
レポート
共通チェッカー (CLI / MCP / CI)

# Page. 28

![Page Image](https://bcdn.docswell.com/page/V7PKGPR3J8.jpg)

SOURCE OF TRUTH
土台: 信頼できる情報源 (SSOT) をリポジトリで管理する
DESIGN.md
全体のエントリーポイント
(役割分担・作業手順・実行コマンド)
design/tokens.json
テーマを自動生成
(手動編集禁止・ドリフト検知で不整合を防ぐ)
design/catalog.json &gt; documents
コンポーネント / パターン / シナリオの契約
design/catalog.json &gt; rules
ルールID・適用スコープ・自動検査ロジック
design/catalog.json &gt; rules[0]
{
&quot;id&quot;: &quot;HTML-BUTTON-TYPE&quot;,
&quot;kind&quot;: &quot;required-attribute&quot;,
&quot;scope&quot;: [&quot;component.button&quot;],
&quot;selector&quot;: &quot;button&quot;,
&quot;attribute&quot;: &quot;type&quot;,
&quot;values&quot;: [&quot;button&quot;, &quot;submit&quot;, &quot;reset&quot;]
}
定性ルールにもIDを付与し、manual として「未評価」を明示
IDと重要度 → レビュー指摘の根拠を追跡できる / 合致するルールがなければ推測せず「評価不可」を返す [P1]

# Page. 29

![Page Image](https://bcdn.docswell.com/page/2JVV62RNJQ.jpg)

INTERFACE
MCP: 必要な知識だけを取り出し、共通基準で検査する
Cursor
Claude Code
CLI
design-harness-mcp
原則 読み取り専用
search_design({query})
設計知識・ルールの検索
resolve_design_context({scenarioId})
タスクに必要な契約・パターン・Skillの依存解決
check_design({source})
成果物の自動検査 (CLIと完全に共通のチェッカーを実行)
● 全ルールを詰め込まず、タスクに必要なコンテキストだけを動的に注入
● CLI と MCP でチェッカーを完全共有 → 検証結果が乖離しない
● 原則読み取り専用 (不要な書き込み・任意コマンド実行の権限を持たない)
≒ デザインシステムの API サーバー

# Page. 30

![Page Image](https://bcdn.docswell.com/page/5EGLNRM5JL.jpg)

WORKFLOW
Agent Skills: 作業手順をパッケージ化する
design-build
画面の新規作成・改修
シナリオ解決
↓ 実装
↓ 自動チェック
↓ 修正
↓ 検証ログ記録
design-review
既存コードのレビュー
・ 機械的な違反
・ 文脈的な指摘
・ 未評価の項目
を分離して報告
design-improve
同じ指摘が頻発したとき
ルール更新案を作成
↓ 承認後に適用
↓ 次のタスクで効果検証
◎ トークン値や仕様はハードコードしない (「参照先」と「実行コマンド」だけを書く)
◎ 自動修正ループは最大2回程度 → 判断が難しければ人間へエスカレーション
Skill = 作業手順書 MCP = 知識の参照と検査のインターフェース DESIGN.md = それらを束ねる全体インデックス

# Page. 31

![Page Image](https://bcdn.docswell.com/page/4JQYQVRL7P.jpg)

KNOWLEDGE BASE
LLM Wiki: 判断の「経緯と背景」を育てる
Karpathy 提唱の「Wikiの保守・整理をLLMに委ねる」設計パターン / kintone Design System での構成 [Z1]
raw/
一次資料 (PR・Issue・議事録...)
人間 / bot が配置・手動編集不可
wiki/
一次資料を出典に要約・統合
LLM が継続的に保守
通常の RAG
検索 → 回答 → その場で流れて消える
LLM Wiki
検索 → 回答 → Wiki ページとして蓄積
→ 使うほど知識が洗練される
AGENTS.md 引用ポリシー・運用ルールを定義
Ingest: 一次資料を取り込む Query: 回答をWikiに蓄積 Lint: 矛盾・古さを検知

# Page. 32

![Page Image](https://bcdn.docswell.com/page/K74WNM85E1.jpg)

KNOWLEDGE BASE
LLM Wiki: 判断の「経緯と背景」を育てる
Karpathy 提唱の「Wikiの保守・整理をLLMに委ねる」設計パターン / kintone Design System での構成 [Z1]
raw/
一次資料 (PR・Issue・議事録...)
人間 / bot が配置・手動編集不可
wiki/
一次資料を出典に要約・統合
LLM が継続的に保守
通常の RAG
検索 → 回答 → その場で流れて消える
LLM Wiki
検索 → 回答 → Wiki ページとして蓄積
→ 使うほど知識が洗練される
AGENTS.md 引用ポリシー・運用ルールを定義
Ingest: 一次資料を取り込む Query: 回答をWikiに蓄積 Lint: 矛盾・古さを検知
出典の信頼度
マージ済PR
&gt; デザインガイドライン
&gt; ADR
&gt; Discussion
&gt; 議事録
導入効果
「なぜ最小幅 210px なのか」
→ 一次資料の出典・時系列付きで、
数分で背景を抽出できる

# Page. 33

![Page Image](https://bcdn.docswell.com/page/LJ1Y5822EG.jpg)

FEEDBACK LOOP
フィードバック: レビュー指摘を次のタスクへ還元する
観察 → 改善提案 → 人間の判断 → 適用 → 再生成 → 次のタスクで効果確認
承認/却下と理由
却下も理由付きで保存 → 同じ提案の再発を防ぐ
● 人間が承認する前の改善提案は、本番の知識ベースへ混入させない
● ルール更新の影響範囲を局所化
(タスク固有 / コンポーネント / パターン / 全体)
● ログ収集で終わらせず、
人間のトリアージとルール反映の意思決定が不可欠 [P3]
≒ 本番ルールの変更には、必ず PR レビューを通す
全体ルール
パターン
コンポーネント
タスク固有

# Page. 34

![Page Image](https://bcdn.docswell.com/page/GJWG5ZR272.jpg)

SKILL
build-design-harness
目的: デザインハーネス・アーキテクチャを手軽に検証・導入する
● 既存資産を調査し、
再利用できる要素・不足している要素を洗い出す
● 1つの代表的なユースケースで、
サイクル全体を一気通貫で接続 (右図)
● すぐ動かせるスターターキット同梱
(Node.js 22+・公式 MCP SDK 対応)
● 先行事例 (登壇・各社の実践記事・
公開リポジトリ) を設計に集約
docs/references/design-harness.md
1 信頼できる情報源
DESIGN.md・トークン・
契約・ルール
2 自動検査
CLI / MCP / CI で同一チェッカー
3 MCP &amp; Skills
build / review / improve
4 指摘 → 提案 → 承認
次のタスクへ即時反映
1フローを
一気通貫
まず「1つのフローを一気通貫で完走させる」ことを最優先に ―― 小さく検証してから横展開 [E1-C]

# Page. 35

![Page Image](https://bcdn.docswell.com/page/4EZLN1R473.jpg)

試し方
zsh - your-app
# デザインハーネスを導入したいリポジトリで
$ npx skills add mitame-ai/skills --skill build-design-harness
$ claude # Codex などでも可
&gt; /build-design-harness
このリポジトリにデザインハーネスを構築して
エージェントから実行
Claude Code ・ Codex などで
スキルを呼び出す
(自然文で頼んでも起動)
MCP 連携
各種クライアントから
npx design-harness-mcp で接続
スキルがリポジトリを調査し、既存のトークン定義やテスト基盤を再利用しながら
1つのフローを一気通貫で構築する。

# Page. 36

![Page Image](https://bcdn.docswell.com/page/Y76W8LRG7V.jpg)

結果①: 「機械的チェックの通過」と「品質の担保」を区別する
npm run design:check -- examples/profile.html
{
&quot;mechanicalPassed&quot;: true,
&quot;checks&quot;: [
{ &quot;rule&quot;: &quot;HTML-BUTTON-TYPE&quot;, &quot;status&quot;: &quot;pass&quot; },
{ &quot;rule&quot;: &quot;TASK-FIT&quot;, &quot;status&quot;: &quot;not-evaluated&quot; },
&quot;observation&quot;: &quot;Rendered evidence and contextual review are required.&quot; }
],
&quot;coverage&quot;: { &quot;Limits&quot;: &quot;Static HTML attributes only. No scripts, CSS, ...&quot; }
}
examples/profile.html に対するチェック結果 (抜粋)
品質の観点 (全体)
未検証の観点
目的適合性 (TASK-FIT)・
見た目・操作感・文脈の妥当性 ...
機械的に保証できた範囲
● 静的属性のチェックはパスしても、目的適合性 (TASK-FIT) は「未評価」と正直に記録
● カバレッジの限界 (機械で検査できる範囲 / 未検証の観点) を明示
● エージェントの自己申告 (「問題なく完成しました」) は鵜呑みにせず、証拠を要求
≒ テストがグリーンでも、テストしていない部分の品質は保証されない

# Page. 37

![Page Image](https://bcdn.docswell.com/page/G75M918X74.jpg)

結果②: 検査漏れが新たなルールとして定着するまで
題材: 画像に alt 属性がない HTML (実際の実行結果)
exit 0
proposed
エラーで拒否
accepted
1
2
3
4
初回チェック
feedback propose
承認前に apply
feedback decide ... accepted
ルール未定義のため
検査をすり抜け
HTML-IMAGE-ALT
の追加を提案
未承認の適用を
防止
承認者・承認理由を
記録

# Page. 38

![Page Image](https://bcdn.docswell.com/page/9J2921KQER.jpg)

結果②: 検査漏れが新たなルールとして定着するまで
題材: 画像に alt 属性がない HTML (実際の実行結果)
exit 0
proposed
エラーで拒否
accepted
applied
build fail
exit 1
passed
1
2
3
4
5
6
7
8
初回チェック
feedback propose
承認前に apply
feedback decide ... accepted
feedback apply
design:drift
再生成 →
再チェック
alt 付与 →
再チェック
ルール未定義のため
検査をすり抜け
HTML-IMAGE-ALT
の追加を提案
未承認の適用を
防止
承認者・承認理由を
記録
カタログへ
ルール定義・履歴を
反映
ルール更新に伴う
ドリフトを検知
新ルールで違反を
正しく検出
mechanicalPassed: true

# Page. 39

![Page Image](https://bcdn.docswell.com/page/DEY4YZNYJM.jpg)

結果②: 検査漏れが新たなルールとして定着するまで
題材: 画像に alt 属性がない HTML (実際の実行結果)
exit 0
proposed
エラーで拒否
accepted
applied
build fail
exit 1
passed
1
2
3
4
5
6
7
8
初回チェック
feedback propose
承認前に apply
feedback decide ... accepted
feedback apply
design:drift
再生成 →
再チェック
alt 付与 →
再チェック
ルール未定義のため
検査をすり抜け
HTML-IMAGE-ALT
の追加を提案
未承認の適用を
防止
承認者・承認理由を
記録
カタログへ
ルール定義・履歴を
反映
ルール更新に伴う
ドリフトを検知
新ルールで違反を
正しく検出
mechanicalPassed: true
1 「exit 0 で通った」を
見過ごさず、改善の契機にする
2 未承認の提案が、
勝手にルール化されない安全弁
3 更新されたルールが、
即座に次の検証へ反映される

# Page. 40

![Page Image](https://bcdn.docswell.com/page/VJNYP3XR78.jpg)

やってみてわかったこと
√ よかったこと
● いろいろな人が提唱するデザインハーネスを、
自分のアプリのデザインシステムに
簡単に導入できた
! 課題
● Storybook だけの場合と比べて、
UI が実際に改善したかはまだ確かめられていない
→ 業務委託先でもデザインシステムを構築中。そこでも使ってみる予定
● 知識をどこに貯めるかが悩ましい
最終的にはデザインシステムの repo に載せたい。でも AI エージェントが
本来のタスクを離れて別 repo に PR を送るのはしんどい
→ GitHub Issue の発行などで対応したい
プロダクトの画面 (実装中)
そのデザインシステム (Storybook)

# Page. 41

![Page Image](https://bcdn.docswell.com/page/YE9P398ZJ3.jpg)

まとめ
デザインハーネス =
デザイナーの判断基準を頭の外に出し、コード同様に運用する仕組み
エンジニアの道具
デザインハーネス
コーディング規約 ≒ DESIGN.md ・ コンポーネント契約・ルールID
lint / CI ≒ 共通チェッカー (CLI / MCP / CI パイプライン)
開発手順書 ≒ Agent Skills
ADR / 設計経緯 ≒ 判断記録と LLM Wiki
PR レビュー ≒ 改善提案 → 人間承認 → 本番適用
まずは身近な1画面、1つのワークフローから。
スターター build-design-harness ですぐに検証できます

# Page. 42

![Page Image](https://bcdn.docswell.com/page/GE8DM9ZYED.jpg)

参考資料
[N1] やしま | nicotomo 「自論に自信がないデザイナーが、『デザインハーネス』を個人で作ってみた」(2026-09-21)
https://note.com/nicotomo_jp/n/n7e5b665316ba
[Z1] saku 「散らばった議論をLLM-Wikiでフル活用する AI時代のデザインシステムのカタチ」(2026-08-05)
https://zenn.dev/cybozu_frontend/articles/llm-wiki-for-design-systems
[P1] 橋本 哲勇 / Tetsuo Hashimoto (LayerX) 「デザインハーネス: 専門職の判断基準をコードのように運用する」 Bet AI Day 2026
https://speakerdeck.com/Layerx/bet-ai-day-2026-session05
[C1] Design Harness
https://design-harness.com/
[C2] Kogiso 「デザインハーネスとは何か」
https://note.com/kgsi/n/n707d989e1a44
[E1-C] Haruka Shimizu (PKSHA Technology) 「1000人規模の組織でデザインハーネスを導入するための第一歩」
https://speakerdeck.com/pkshadeck/1000ren-gui-mo-no-zu-zhi-dedezainhanesuwodao-ru-surutamenodi-bu
[E2-B] Sayaka Kubouchi (SoftBank) 「Agentic Design Workflowを育てる『三層デザインハーネス』の現在地」
https://speakerdeck.com/sayadesign2/agentic-design-workflow-o-sodateru-sansou-dezain-hanesu-no-genzaichi
[E2-D] Kota Saito (CONCENT) 「デザイナーの判断をAIにつなぐ ―― 審美眼をハーネスする試み」
https://speakerdeck.com/kotasaito_cnt/dezainna-no-handan-o-ai-ni-tsunagu-shinbi-me-o-hanesu-suru-kokoromi
[P3] Sansan 「AIプロトタイピングの精度を上げるーデザインハーネスをチームで育てる方法」
https://note.com/sansan_cpo/n/n0df771f4ef2f
Thank you

