Vault_デザイン規則
📐 Vault デザイン規則
思わず見返したくなるページを、再現性のあるルールで作る。
全ノートに適用される統一デザイン規則。
---
30秒で全体像
| 観点 | 一言 |
|---|---|
| 核心 | 思わず見返したくなるページを、再現性のあるルールで作る。 |
| キーワード | デザイン3原則 |
| 使う人 | 全社員 / 運用担当 |
| 読了目安 | 5-7分 |
デザイン3原則
- カラフル過ぎない — 強調色は1ページ1〜2点まで。基本は淡色+無彩色
- 余白を持たせる — セクション間は
---、Callout/Mermaid前後は必ず空行 - 意味のある装飾だけ — 飾りとしての絵文字・色は禁止。すべて情報構造のため
1. ページ全体構造の型
基本テンプレート(順序厳守)
1. Frontmatter(YAML)
2. # H1タイトル(emojiは1個まで)
3. > Hero メッセージ(1〜2行)
4. ---
5. ## クイックアクセス(type=productなら必須)
6. ---
7. ## メインコンテンツ(複数セクション、--- で区切る)
8. ---
9. ## 関連ノート / 関連MOC
10. ---
11. > 締めの一言(任意・印象づけたい時のみ)
Frontmatter規約
---
title: 📐 タイトル(emoji + 名前)
type: meta | product | knowledge | manual | idea | moc
dept: 開発 | PM | FS | マーケ | ナレッジ | 事業戦略 | etc
tags: [カテゴリ, サブカテゴリ, 関連語]
status: active | draft | archived
created: YYYY-MM-DD
updated: YYYY-MM-DD # 編集時は必ず更新
---
2. アイコン使用ルール(Lucide記法・絵文字廃止)
絵文字使用禁止。すべてのアイコンは Lucide記法 `` で書く
理由:
- 絵文字はOSやアプリで見え方が違う・ありきたり
- Lucide はNotion採用の高品質アイコンセット(1933種類)
- Iconize プラグイン(インストール済)で自動描画
- 統一感とブランディングが実現される
必須プラグイン
- Iconize — インストール+設定済(Icon identifier=
:、Lucide Native Pack有効) - 詳細: AI ナレッジ 等で利用中
部署アイコン(固定)
| Lucide記法 | 部署 |
|---|---|
| `` | 事業戦略部 |
| `` | システム開発部 |
| `` | FS部署 |
| `` | 品質管理/PM部 |
| `` | マーケティング部 |
| `` | デザイン秘書室 |
| `` | 人事採用部 |
| `` | コーポレート部 |
| `` | AI運用 |
| `` | ナレッジ全般 |
状態アイコン
| Emoji | 意味 |
|---|---|
| ✅ | 完了・達成 |
| 順調・問題なし | |
| 進行中・要確認 | |
| 問題あり・要対応 | |
| 設計・準備中 |
階層アイコン(KPI目標値で使う)
| Emoji | 意味 |
|---|---|
| トップ目標 | |
| ✅ | ベース目標 |
| アンダー目標 |
機能アイコン
| Lucide記法 | 意味 |
|---|---|
| `` | クイックアクセス・即実行 |
| `` | 目標・ミッション |
| `` | ノート・参考書籍 |
| `` | リンク・連携 |
| `` | 書籍 |
| `` | 動画・YouTube |
| `` | ロードマップ・新規 |
| `` | スケジュール・履歴 |
| `` | アイデア・気づき |
| `` | 核心・ダイヤモンド級重要 |
| `` | キーワード・鍵 |
| `` | 時間関連 |
| `` | 個人・対象者 |
| `` | チーム・組織 |
| `` | 関係構築・パートナー |
| `` | 検索・分析 |
| `` | NG・禁止 |
| `` | 警告 |
| `` | チェック・完了 |
| `` | NG・バツ |
| `` | 執筆・編集 |
| `` | コメント・対話 |
| `` | データ・グラフ |
| `` | 成長・上昇 |
| `` | トップ目標・最重要 |
| `` | 守る・防御 |
| `` | 自己成長・新芽 |
| `` | 戦略・競合 |
| `` | キラキラ・新規 |
→ Lucide全アイコン(1933種類): https://lucide.dev/icons/
アイコンを盛りすぎない
H1タイトルは1個。各セクションのH2に1個。本文中は意味があるときだけ。
3. Callout 使い分け
| Callout | 用途 | 1ページ目安 |
|---|---|---|
> |
Heroメッセージ・キーフレーズ | 1〜2個 |
> |
クイックアクセス情報(展開デフォ) | 1個 |
> |
ノウハウ・コツ | 1〜3個 |
> |
要注意・未完了 | 0〜2個 |
> |
絶対遵守ルール | 0〜1個 |
> |
ページ締めくくり | 0〜1個 |
> |
補足・備考 | 0〜2個 |
連続Calloutは禁止
Callout同士の間には必ず本文・テーブル・Mermaid等を挟む。Callout3連発は読み手の集中を切らす。
1ページ合計目安: 3〜7個まで
4. Mermaid 使い分け
絶対ルール(厳格化版)
Mermaidは「直列フロー(linear flow)」のみ使用可
tree / 分岐 / 親→子5以上の構造はMermaid禁止 → テーブル化必須。横スクロールが発生する時点でアウト。
使ってOKなパターン
| パターン | 例 |
|---|---|
| 直列フロー(A → B → C → D) | プロセス・手順・1日の流れ |
| 短いループ(A → B → C → A) | サイクル・PDCA |
| ノード3〜5個までの分岐 | 簡単な意思決定フロー |
| gantt | スケジュール |
| pie | 構成比率 |
Mermaid禁止 → テーブル化必須
| パターン | 代替 |
|---|---|
| 親→子5個以上の分岐 | テーブルで一覧化 |
| 多段階tree(3階層以上) | 階層テーブル / ネストリスト |
| 横スクロールが発生する図 | テーブル化 |
| graph LR(横方向) | テーブル化 |
グラフ種別の使い分け
| 種別 | 用途 | 例 |
|---|---|---|
graph TB |
直列フロー専用 | 業務手順・1日の流れ |
gantt |
スケジュール | 開発ロードマップ |
pie |
構成比率 | 売上比・KPI内訳 |
ノード数・サイズ制限
- ノードは 最大6個 まで(直列なら1行に収まる)
- 1ノード 6文字以内 が理想
- 長くなる場合は
<br>で改行(例:[名前<br>補足]) - 横スクロールが少しでも発生したら即テーブル化
カラーパレット(厳選)
Mermaid色は5色まで。基本は薄色。
fill:#f5f5f5 → 薄グレー(基本ノード・背景)
fill:#e3f2fd → 薄ブルー(情報・標準)
fill:#fff3e0 → 薄オレンジ(注目)
fill:#c8e6c9 → 薄グリーン(成功・ゴール)
fill:#fce4ec → 薄ピンク(中央ハブ・強調)
fill:#ffcdd2 → 薄レッド(警告・1個まで)
fill:#fff9c4 → 薄イエロー(注意・1個まで)
ルール:
- 基本ノードは無着色 or fill:#f5f5f5
- 強調ノードは1グラフあたり 1〜2個まで
- 全ノードに色をつけない(コントラストが消える)
例(Good vs Bad)
graph TB
A[リード] --> B[商談]
B --> C[契約]
C --> D[継続]
style C fill:#fce4ec
→ ✅ Good: 強調1個(契約)だけ色付け
graph TB
A[リード]:::a --> B[商談]:::b
B --> C[契約]:::c
C --> D[継続]:::d
classDef a fill:#e3f2fd
classDef b fill:#fff3e0
classDef c fill:#fce4ec
classDef d fill:#c8e6c9
→ Bad: 全部に色 → どこが大事か分からない
5. テーブル設計の型
基本ルール
- 2〜4列まで(5列以上は分割)
- 1列目に アイコン or 太字 で視認性UP
- ヘッダー行に意味のある名前
- 数値は右寄せにしない(Markdownの仕様で揃わない)
KPI目標値の標準型
| ランク | 受注率 | 月平均顧客単価 |
|---|---|---|
| **トップ目標** | **45%** | 400,000円 |
| ✅ **ベース目標** | **30%** | 250,000円 |
| **アンダー目標** | **20%** | 150,000円 |
ステータス表の標準型
| 項目 | 状態 | 備考 |
|---|---|---|
| Tasks | ✅ 完了 | 統合済み |
| CRM | 開発中 | 7月リリース予定 |
| X 運用 | 27ページ | OAuth未接続 |
6. リンク整理の型
関連ノートのカテゴリ分類
## 関連ノート
### システム別 詳細
- <span class="wikilink-dead">表示名</span>
### 業務フロー
- <span class="wikilink-dead">表示名</span>
### 関連システム
- <span class="wikilink-dead">表示名</span>
### ナレッジ
- <span class="wikilink-dead">表示名</span>
羅列より分類
5個以上のリンクは必ずカテゴリで分類する。
リンク表記ルール
<span class="wikilink-dead"> 表示名</span>— 表示名にアイコンを付ける- 同じディレクトリ内なら
<span class="wikilink-dead">ファイル名</span>短縮可 - 別ディレクトリは
<span class="wikilink-dead">表示名</span>で明示
7. 余白・空白のルール
余白なきページは読まれない
必ず空行を入れる場所
## H2の 前 に空行- Callout の前後 に空行
- Mermaid の前後 に空行
- テーブルの前後 に空行
- コードブロックの前後 に空行
セクション区切り
- 大セクション間は
---(水平線)で区切る ---の 前後にも空行
NG例
## セクション1
内容
> 情報
> コツ
内容
## セクション2
→ Callout 連続・空行なし → 圧迫感
OK例
## セクション1
内容文。
> 情報
セクション中継の本文。
> コツ
内容文。
---
## セクション2
8. 1ページの長さの目安
| ページタイプ | 目安行数 | 内容 |
|---|---|---|
| 部署 _README | 60〜120行 | 構成・ミッション・ノート・関連 |
| プロダクト _README | 150〜250行 | 構成・機能・ロードマップ・ルール |
| ナレッジ _README | 150〜300行 | インサイト・書籍・動画・サブカテゴリ |
| MOC | 80〜150行 | テーマ別リンク集 + Dataview |
| 個別ナレッジノート | 30〜100行 | atomic(1ノート1ナレッジ) |
長すぎたら分割。短すぎたら統合。
9. 装飾を使わない場面
以下では絶対に過剰装飾しない
- 個別ナレッジノート(atomic)— Hero callout・Mermaid不要
- Daily ノート — シンプルに記録メモ
- Inbox ノート — 整理されるまで装飾不要
- 議事録 — 内容優先
→ 装飾はハブページ・README・MOC のみ が原則
10. チェックリスト(ページ完成前)
このリストを上から見て、全部 ✅ になればOK
- [ ] H1タイトルにemoji 1個(多すぎず)
- [ ] Frontmatter の
updatedを今日の日付に更新 - [ ] Heroメッセージ(quote callout)が冒頭にある
- [ ] セクション間に
---で区切られている - [ ] Callout は3〜7個に収まっている
- [ ] Callout同士が連続していない
- [ ] Mermaid グラフの強調色は1〜2個まで
- [ ] テーブルは2〜4列に収まっている
- [ ] 関連リンクが5個以上ならカテゴリ分類されている
- [ ] 全角コロン
:ではなく半角コロン:を使う(Markdownとの相性) - [ ] 各 H2 の前後に空行がある
関連ノート
このルールに従えば、全ページが "見返したくなる第二の脳" になる。
迷ったらこのページに戻る。