kwakseongjae/oh-my-design

解決する課題

コーディングエージェントは一貫したデザインシステムの維持に苦労することが多く、統一された哲学やアクセシビリティ、ブランド基準への厳格な準拠を欠いたUIコンポーネントが生成される「デザインスロップ（design slop）」を引き起こします。本プロジェクトは、リポジトリ内で直接デザインシステムを定義、強制、文書化するための、エージェントネイティブな構造化フレームワークを提供します。

仕組み

このシステムは、AIエージェントに「哲学 → 決定表 → トークン → コンポーネント契約 → レイアウト文法」という厳格な導出チェーンに従うよう強制します。DESIGN.md ファイルを信頼できる唯一の情報源（source of truth）として使用することで、エージェントは明示的なルールと「スロップゲート（slop gates）」によって制約され、勝手なスタイルを作成することを防ぎます。CLIは、これらのファイルを検証し、ローカルドキュメントサイト（omd book）をホストし、Claude Code、Cursor、OpenCode といった一般的なコーディングエージェントとの統合を管理するツールを提供します。

対象ユーザー

本ツールは、AIコーディングエージェントを使用してUIを構築し、それらのエージェントが正式なデザインシステムに準拠した、高品質でブランドの一貫性が保たれた、アクセシブルなコードを生成することを保証したい開発者やチーム向けに設計されています。

ハイライト

• エージェントネイティブなワークフロー: Claude Code、Cursor、OpenCode と直接統合し、デザイン特有のスキルと専門的な役割を提供します。
• 厳格な強制力: 54の「スロップゲート」と8つのシステム忠実度ゲートが含まれており、確立されたデザイン契約から逸脱した場合、自動的にビルドを失敗させます。
• ポータブルなドキュメント: 人間が読めて機械が検証可能な、ポータブルな契約書として機能する DESIGN.md ファイルを生成します。
• 豊富なリファレンスライブラリ: 500以上の品質評価済み企業デザインリファレンスへのアクセスが含まれており、新規プロジェクトの立ち上げを支援します。
• 外部依存関係なし: コアワークフローは既存のエージェントセッション内でローカルに実行され、追加の API キーや MCP サーバーは不要です。