coiai Logo
Featured

デザインガイドラインをAIでもわかるようにMarkDown 形式で作った

弊社のデザインガイドラインをAIでもわかるようにMarkDown形式で作成しました。
今までプロダクトやサービスのUI設計を任されることがあり、その際はデザインガイドラインをFigmaにエンジニアにわかるように設定していたのですが、エージェント型AIが普及するにあたり、ヴィジュアルでわかるよりも文章でわかるものを用意する必要を感じ制作しました。

実際に作ってみると、ヴィジュアルを言葉として理解するのは難しいという当たり前のことがわかったのと、LLMと人間の違いをまた見たなと思いました。

人間用デザインガイドライン

今回作成したガイドラインは人間にもみやすいようにヴィジュアルでも作成しました。
なるべく変更がしやすいようにMarkDown形式で作成したものをHTMLに変換し、PDFで書き出すという手順をとっています。

マークダウンのデザインガイドライン

design-guideline.md

# 株式会社coiai デザインガイドライン

> 社内外のあらゆる制作物に一貫性を持たせるためのデザイン指針。

---

## 1. ブランドアイデンティティ

### ブランドパーソナリティ

| 属性 | coiaiらしさ | coiaiらしくない |
|------|-----------|---------------|
| トーン | 優しく品がある | 尖りすぎて攻撃的 |
| 態度 | カジュアルだが専門性がある | 馴れ馴れしい / 権威的 |
| 姿勢 | 弱者の側に立つ、開放的 | 囲い込み、排他的 |
| ものづくり | 手を動かす、美しく作る | 企画書だけ、妥協する |
| 発信 | 知見を惜しみなく共有する | 情報を有料で囲い込む |

---

## 2. カラーパレット

### プライマリカラー

| 名称 | HEX | 用途 |
|------|-----|------|
| **coiai Navy** | `#2434A9` | アクセント、ブランドの主色、リンクテキストにも使用 |
| **coiai Text** | `#1E1E1F` | 本文テキスト |
| **coiai White** | `#FFFFFF` | 背景 |
| **coiai Light Gray** | `#F5F5F7` | 背景(セクション区切り) |
| **coiai Gray** | `#6C6C6D` | キャプション、補足テキスト |

### アクセントカラー(必要に応じて)

| 名称 | HEX | 用途 |
|------|-----|------|
| **Accent Red** | `#E83323` | 警告、重要な強調(控えめに使用) |
| **Accent Yellow** | `#FBEC4F` | 赤より低い強調表現 |
| **Accent Green** | `#60D03E` | 成功、ポジティブな指標 |

### ダークモード

#### プライマリカラー(ダークモード)

| 名称 | HEX | 用途 |
|------|-----|------|
| **coiai Text White** | `#F5F5F7` | 本文テキスト |
| **coiai Dark** | `#000` | 背景 |
| **coiai Dark Gray** | `#161617` | 背景(セクション区切り、カード) |
| **coiai Mid Gray** | `#86868B` | キャプション、補足テキスト |

### 使用ルール(共通)

- 見出しはText Color と同様
- 背景は原則 White(ダークモード時は Dark)。情報量が多い場合に Light Gray / Dark Gray でセクションを分ける
- Navy はCTAボタン・アイコンに使用。本文には使わない
- アクセントカラーは画面全体の5%以下に抑える
- 黒背景にNavyテキストを置かない(ダークモードでは Navy Light を使用すること)

---

## 3. タイポグラフィ

### フォント指定

| 用途 | フォント | フォールバック |
|------|---------|-------------|
| **見出し(日本語)** | Noto Sans JP Bold | Hiragino Sans, sans-serif |
| **本文(日本語)** | Noto Sans JP Regular | Hiragino Sans, sans-serif |
| **見出し(英語)** | Helvetica Bold | Helvetica Neue, sans-serif |
| **本文(英語)** | Helvetica Regular | Helvetica Neue, sans-serif |
| **コード・技術表記** | JetBrains Mono | monospace |

### サイズ体系

#### PC版

| 要素 | サイズ | 用途 |
|------|--------|------|
| h1 | 64px bold | ページタイトル、スライド表紙 |
| h2 | 56px bold | セクション見出し |
| h3 | 40px bold | サブセクション |
| h4 | 24px bold | 小見出し |
| 本文 | 16px | 通常テキスト |
| キャプション |  14px | 表注釈、補足情報 |

#### スマホ版

| 要素 | サイズ | 用途 |
|------|--------|------|
| h1 | 36px bold | ページタイトル、スライド表紙 |
| h2 | 32px bold | セクション見出し |
| h3 | 24px bold | サブセクション |
| h4 | 20px bold | 小見出し |
| 本文 | 16px | 通常テキスト |
| キャプション |  14px | 表注釈、補足情報 |

### スタイルルール

- 見出し(h2〜h4)の色は `#2F4E8F`
- 本文の行間は 1.8(可読性重視)

## 5. ロゴ使用規定

### ロゴ表記

- 正式名称: **株式会社coiai**
- ロゴタイプ: **coiai**(すべて小文字)
- 大文字表記(COIAI, Coiai)は使用しない

### 余白(クリアスペース)

- ロゴの周囲にはロゴ高さの50%以上の余白を確保する
- ロゴの上に他の要素を重ねない

### 禁止事項

- ロゴの色を勝手に変更しない
- ロゴを変形・回転させない
- 低解像度のロゴを使用しない
- 背景とのコントラストが不十分な配置をしない

---

## 6. トーン・オブ・ボイス

### 文章のトーン

> **カジュアルだが専門性のある言葉遣い。パンクだが品がある。**

| 場面 | トーン | 例 |
|------|--------|-----|
| 技術記事 | 正確で簡潔、専門用語は恐れず使う | 「LlamaベースのRAG構築で社内文書検索を実装した」 |
| SNS | カジュアル、制作過程をリアルに | 「ARデモ、家具の影がどうしても浮く問題と3時間格闘した」 |
| 営業資料 | 丁寧だが堅すぎない、数字で語る | 「大手比30〜50%のコストで、同等品質を提供します」 |
| 企業理念 | 情熱的、ストーリーで伝える | 「どんな底辺にいる人間にも、幸せを勝ち取る手段を届ける」 |

### 言葉遣いのルール

- 「弊社」ではなく「coiai」または「私たち」
- 過度な敬語よりも明快さを優先する
- 技術用語は適切に使い、必要に応じて簡潔な補足を添える
- 競合の悪口・比較広告はしない
- 「できません」より「こういう方法なら実現できます」

---

## 7. レイアウト原則

## 見出し

- 原則左寄せ

### 余白

- 大きく余白をとる。

### グリッド

- Web: 12カラムグリッド、最大幅 1200px
- モバイル: シングルカラム、左右 16px のパディング

### 角の処理

- ボタンは完全な角丸
- カードは16pxの角丸

### 要素

- h2 はセクションでまとめる
- カードデザインは3つ以上のコンテンツがある場合のみ使用する。
- クリック可能なものはホバーアクションを設定する。

### 情報の構造化

- 比較情報はテーブルで整理する
- 箇条書きは5項目以内を目安にする
- 図や構造は ASCII / Mermaid で表現し、不要な装飾画像は使わない

## ホバーアクション

- クリック可能な要素にホバー時に行う
- 必ずeaseをつけて緩急をつける
- 1.01倍大きくする
- ボタンはカラーを明るくする

## 禁止事項

- クリックできないものにホバーアクションをつけない。
- シャドーの使用
- 中央寄せ

---

## 8. 写真・画像のスタイル

- 写真と背景が同色の場合はborderを用いる。
- なるべく背景色は完全な白ではなく、ライトグレーを用いる。

### 禁止事項

- 絵文字の使用は禁止
- フリー素材の多用(「いかにもストックフォト」な写真)
- 過度なフィルター加工
- 無関係なイメージ画像での装飾
- カードにBorderの使用禁止
- 背景と同色とカードの禁止

---

## 9. 媒体別の適用

### Web(coiai.net)

- カラー: Navy + White ベース
- フォント: Noto Sans JP / Helvetica

### SNS

- **X**: テキスト主体。画像/動画付きの場合はブランドカラーを意識
- **Instagram**: ビジュアル品質を最優先。フィードの統一感を保つ
- **YouTube**: サムネイルにNavyのアクセントを入れ、フォントを統一

### 印刷物(チラシ・名刺)

- CMYK変換時の色指定を確認すること
- Navy の CMYK 参考値: C85 M60 Y10 K20
- 最小フォントサイズ: 8pt

---

## 10. お問い合わせ情報フッター(共通)

営業資料・チラシの末尾には以下を統一フォーマットで記載

```
株式会社coiai
- 所在地: 東京都練馬区3-6-9
- 事業内容: オンプレミスAI構築 / XR・AR開発 / Web・アプリ開発 / 基幹システム開発
- お問い合わせ: coiai.net/contact
```

---

## 更新履歴

| 日付 | 内容 |
|------|------|
| 2026-03-27 | 初版作成 |

この記事をシェア

投稿日: 2026年3月31日
カテゴリ: 未分類
タグ:
coiai

coiai

この記事もおすすめ

デフォルトサムネイル

【WSL入門】Ubuntu on WSL2 に開発ツールを一式そろえる — Git / nvm / pnpm / AWS CLI / Terraform

前回の記事では、Windows に WSL2 を導入して Ubuntu が動くところまでを扱いました。ただ、素の Ubuntu はあくまで「まっさらな Linux」です。ここから実際に開発を始めるには、バージョン管理・ランタイム・クラウド操作のツールを自分で入れていく必要があります。 この記事では、すべて公式ドキュメントに載っている手順だけを使って、次のツールを順番にセットアップします。 各セクションの末尾に出典 URL を置いてあるので、手順が古くなったと感じたらそこを見に行ってください。記事末尾には出典一覧もまとめています。 検証環境Windows 11 / WSL2 / Ubuntu 24.04 LTS(x86_64)確認日:2026年7月28日 バージョン番号は執筆時点のものです。インストールコマンド自体は基本的に「常に最新を取ってくる」形になっているので、そのまま実行して問題ありません。 はじめに:WSL開発の大原則 コマンドに入る前に、ひとつだけ。Microsoft の公式ドキュメントが繰り返し書いている重要な原則があります。 使う予定のツールと同じ OS 側にファイルを置く。Linux ツールで Linux コマンドラインから作業しているなら、最速のパフォーマンスを出すためにファイルは WSL ファイルシステムに格納します。 具体的には、プロジェクトは次の場所に置きます。 /mnt/c/ 配下はファイルシステムをまたぐため、npm install や git status が体感でわかるほど遅くなります。第2弾でこれから入れるツールも、すべて Linux 側のホームディレクトリを前提に使ってください。 出典:WSL 開発環境を設定する — Microsoft Learn 1. まずは基本ツール Ubuntu を起動したら、最初にやることはパッケージの更新です。Microsoft の公式ドキュメントにもこう書かれています。 ディストリビューションの優先パッケージ マネージャーを使用して、パッケージを定期的に更新およびアップグレードすることをお勧めします。Windows […]

デフォルトサムネイル

WindowsでWSL2をセットアップしてUbuntuを使えるようにする

TerraformやAWS CLI、Dockerを快適に使うために、WindowsにWSL2を導入しました。 この記事では、実際に行ったセットアップ手順と、途中で遭遇したエラーへの対処方法をまとめます。 なぜWSLを使うのか? WSL(Windows Subsystem for Linux)は、Windows上でLinux環境を動かすための仕組みです。 AWSやTerraform、Dockerなど、多くの開発ツールはLinux環境との相性が良いため、Windowsで開発する場合でもWSL2を利用するのが一般的です。 今回の開発環境では以下のような構成を想定しています。 1. WSLをインストール PowerShell(管理者)を開き、以下を実行します。 2. Ubuntuの初回セットアップ Ubuntuを起動すると、Linuxユーザー名とパスワードの設定を求められます。 例 好きなユーザー名を入力します。 続いてパスワードを設定します。 ※入力中は文字が表示されませんが正常な動作です。 3. パッケージを更新 Ubuntuを起動したら、まず最新状態へ更新します。 4. エラーが表示された アップグレード中に次のようなメッセージが表示されました。 一見エラーに見えますが、今回は最後まで と表示され、更新自体は正常に完了していました。 WSLではsystemd関連の処理で、このような警告が表示されることがあります。 5. WSLの状態を確認 PowerShellで以下を実行します。 今回は となっていました。 6. Docker DesktopとUbuntuの違い ここで少し混乱しやすいポイントがあります。 Docker Desktopをインストールすると、docker-desktopというWSLディストリビューションが作成されます。 しかし、これはDockerが内部で利用するためのもので、普段の開発を行う場所ではありません。 おすすめの構成は次の通りです。 開発はUbuntuで行い、Docker Desktopはコンテナ実行基盤として利用します。 7. Ubuntuを既定のディストリビューションに変更 現在登録されているWSLを確認します。 Ubuntuがインストールされていることを確認したら、 を実行します。 これで だけでUbuntuが起動するようになります。 今後インストール予定 WSL環境では今後以下を導入していきます。 この環境をベースに、AWS Organizations、IAM […]

AWS IAM Identity Centerとは?IAM Userを使わないAWS認証・権限管理のベストプラクティス

AWS IAM Identity Centerとは?IAM Userを使わないAWS認証・権限管理のベストプラクティス

AWS Organizationsによるマルチアカウント環境を構築した後、次に設定したのがAWS IAM Identity Centerです。 以前はAWSへログインするためにIAM Userを作成することが一般的でしたが、現在AWSでは、人がAWSへログインする場合はIAM Identity Centerの利用を推奨しています。 今回は、IAM Identity Centerを導入した理由と、実際の設定内容についてまとめます。 IAM Identity Centerとは IAM Identity Center(旧 AWS Single Sign-On)は、複数のAWSアカウントやAWSアプリケーションへの認証・認可を一元管理するサービスです。 従来のように各AWSアカウントへIAM Userを作成する必要はなく、 というメリットがあります。 AWS Organizationsと組み合わせることで、マルチアカウント環境の運用が大幅に容易になります。 なぜIAM UserではなくIdentity Centerなのか 以前は、このような構成が一般的でした。 しかし、この方法では といった課題があります。 Identity Centerを利用すると、ユーザー情報は一元管理され、各AWSアカウントには必要な権限だけを割り当てる運用になります。 AWS Well-Architected Frameworkでも、人によるアクセスにはフェデレーション認証を利用し、長期認証情報(IAM Userのアクセスキーなど)をできる限り利用しないことが推奨されています。 今回の構成 今回は次のようなシンプルな構成にしました。 グループ Administrators AWS環境全体を管理するメンバーです。 現在は を所属させる予定です。 Developers アプリケーションやインフラ開発を行うメンバー向けです。 今回はまだ利用していませんが、開発メンバーが増えた際に使用します。 将来的には などを割り当てる予定です。 ReadOnly 閲覧専用グループです。 監査やレビュー、外部アドバイザー向けとして利用します。 今回は技術メンターにReadOnly権限を付与することを想定しています。 Permission […]

この記事を書いた会社

株式会社coiaiは、「想像できることを美しく実現」を掲げ、XR・Web・アプリ・システム開発およびDX支援を行う会社です。 創業2022年、東京都練馬区に本社を置き、要件のヒアリングからPoC(概念実証)、本番運用まで一貫して伴走します。 まずはお気軽にご相談ください。

商号株式会社 coiai創業2022年1月設立2025年1月23日資本金1,500,000円(設立時点)本社所在地東京都練馬区関町北 3-6-9代表者代表取締役 竹村 啓佑 / 代表取締役 服部 陽良

主なご相談内容

会社概要・役員紹介を見る

詳しい会社情報は会社概要ページでご覧いただけます。

資料請求・無料相談

導入要件のヒアリングからPoC、本番運用まで伴走します。まずはお気軽にご相談ください。

お問い合わせの前に 個人情報保護方針 をご確認ください。