yodogawa 2.1.3 → 2.3.0

package/skills/a-010-define-design-system/SKILL.md

@@ -1,130 +1,130 @@
----
-name: a-010-define-design-system
-description: カラー・タイポグラフィ・スペーシング・コンポーネントスタイルを含むデザインシステムを定義する。画面設計後、UI 実装のスタイル基盤を固める際に使用。
-disable-model-invocation: true
-allowed-tools: Read, Write, Edit, Bash, Grep, Glob
----
-
-# DefineDesignSystem (a-010)
-
-## 目的
-
-- プロジェクト全体で一貫したビジュアルデザインを実現するデザインシステムを定義する。
-- カラーパレット、タイポグラフィ、スペーシング、コンポーネントスタイルを標準化する。
-- デザイナーと開発者が共通言語として使える仕様書を作成する。
-
-## 前提
-
-- `docs/project/04-design/03-screen-design.md` が作成されている（画面設計完了）
-- `docs/project/04-design/01-tech-stack.md` が作成されている（UI フレームワーク決定）
-
-## 手順
-
-### 1. 既存ドキュメントの確認
-
-- `docs/project/04-design/01-tech-stack.md` — 使用する CSS フレームワーク（Tailwind, MUI 等）
-- `docs/project/04-design/03-screen-design.md` — 画面設計とレスポンシブポリシー
-- ブランドガイドラインがあれば参照
-
-### 2. テンプレートの準備
-
-このスキルの配置ディレクトリ（`skills/a-010-define-design-system/`）を起点に、相対パス `../../templates/project/04-design/04-design-system.md` を Read で読み込み、その内容を `docs/project/04-design/04-design-system.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する（冪等）。出力先ディレクトリ（`docs/project/04-design/`）が無ければ作成する。
-
-### 3. カラーパレットの定義
-
-- **Primary Colors**: ブランドカラー（1〜2色）
-- **Secondary Colors**: アクセントカラー
-- **Semantic Colors**: Success, Warning, Error, Info
-- **Neutral Colors**: グレースケール（背景、テキスト、ボーダー）
-- **Dark Mode 対応**: 必要に応じてダークテーマも定義
-
-CSS 変数のサンプルは [examples/css-tokens.md](examples/css-tokens.md#カラーパレット) を参照。
-
-### 4. タイポグラフィの定義
-
-- **フォントファミリー**: 見出し用、本文用、コード用
-- **フォントサイズスケール**: xs, sm, base, lg, xl, 2xl, 3xl, 4xl
-- **行間**: tight, normal, relaxed
-- **フォントウェイト**: normal, medium, semibold, bold
-
-サンプル: [examples/css-tokens.md](examples/css-tokens.md#タイポグラフィ)
-
-### 5. スペーシングシステムの定義
-
-基本単位は 4px または 8px ベース。スケール・用途・サンプルは [examples/css-tokens.md](examples/css-tokens.md#スペーシング) と [reference/component-catalog.md](reference/component-catalog.md#スペーシングの設計方針) を参照。
-
-### 6. コンポーネントスタイルの定義
-
-以下のコンポーネントについて、バリアントとステートを定義:
-
-- ボタン
-- フォーム要素（Input, Textarea, Select, Checkbox, Radio）
-- カード / コンテナ
-- その他（Badge, Tag, Avatar, Tooltip, Modal）
-
-詳細なバリアント・ステート一覧は [reference/component-catalog.md](reference/component-catalog.md#コンポーネントスタイル) を参照。
-
-### 7. アイコン・イラストガイドライン
-
-- アイコンライブラリ（Lucide / Heroicons / Material Icons 等）の選定
-- サイズ規定とスタイル統一（Outline / Filled のいずれか）
-
-詳細: [reference/component-catalog.md](reference/component-catalog.md#アイコンガイドライン)
-
-### 8. アニメーション・トランジション
-
-- Duration: fast(150ms), normal(300ms), slow(500ms)
-- Easing: ease-in-out をデフォルトに
-
-サンプル: [examples/css-tokens.md](examples/css-tokens.md#アニメーション)
-
-### 9. ドキュメント作成
-
-`docs/project/04-design/04-design-system.md` に以下を必須セクションとして記入:
-
-- カラーパレット
-- タイポグラフィ
-- スペーシング
-- コンポーネントスタイル（主要なもの）
-
-### 10. 完了条件の確認
-
-- [ ] `04-design-system.md` が作成されている
-- [ ] カラーパレットが定義されている
-- [ ] タイポグラフィスケールが定義されている
-- [ ] スペーシングシステムが定義されている
-- [ ] 主要コンポーネント（ボタン、フォーム）のスタイルが定義されている
-
-### 11. Git への追加（オプション）
-
-```bash
-git add docs/project/04-design/04-design-system.md
-git status
-```
-
-推奨コミットメッセージ:
-
-```
-docs: デザインシステムの定義
-
-- カラーパレット、タイポグラフィ、スペーシングを定義
-- 主要コンポーネントのスタイルガイドを追加
-```
-
-## 完了条件
-
-- `docs/project/04-design/04-design-system.md` が作成されている
-- カラー・タイポグラフィ・スペーシングが定義されている
-- 主要コンポーネントのスタイルが定義されている
-- ユーザーが内容を承認している
-
-## エスカレーション
-
-- **ブランドガイドラインなし**: 「ブランドカラーやフォントの指定がありますか？なければ汎用的なパレットを提案します。」
-- **CSS フレームワーク未定**: 「`/a-007-define-tech-stack` で技術スタックを先に決定しましょう。」
-- **コンポーネントが多すぎる**: 「まずはボタン・フォーム・カードから始め、必要に応じて拡張しましょう。」
-
-## 参考
-
-- [examples/css-tokens.md](examples/css-tokens.md) — カラー/タイポ/スペーシング/アニメーションの CSS サンプル
-- [reference/component-catalog.md](reference/component-catalog.md) — コンポーネント・アイコン・アニメーションの標準仕様
+---
+name: a-010-define-design-system
+description: カラー・タイポグラフィ・スペーシング・コンポーネントスタイルを含むデザインシステムを定義する。画面設計後、UI 実装のスタイル基盤を固める際に使用。
+disable-model-invocation: true
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# DefineDesignSystem (a-010)
+
+## 目的
+
+- プロジェクト全体で一貫したビジュアルデザインを実現するデザインシステムを定義する。
+- カラーパレット、タイポグラフィ、スペーシング、コンポーネントスタイルを標準化する。
+- デザイナーと開発者が共通言語として使える仕様書を作成する。
+
+## 前提
+
+- `docs/project/04-design/03-screen-design.md` が作成されている（画面設計完了）
+- `docs/project/04-design/01-tech-stack.md` が作成されている（UI フレームワーク決定）
+
+## 手順
+
+### 1. 既存ドキュメントの確認
+
+- `docs/project/04-design/01-tech-stack.md` — 使用する CSS フレームワーク（Tailwind, MUI 等）
+- `docs/project/04-design/03-screen-design.md` — 画面設計とレスポンシブポリシー
+- ブランドガイドラインがあれば参照
+
+### 2. テンプレートの準備
+
+このスキルの配置ディレクトリ（`skills/a-010-define-design-system/`）を起点に、相対パス `../../templates/project/04-design/04-design-system.md` を Read で読み込み、その内容を `docs/project/04-design/04-design-system.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する（冪等）。出力先ディレクトリ（`docs/project/04-design/`）が無ければ作成する。
+
+### 3. カラーパレットの定義
+
+- **Primary Colors**: ブランドカラー（1〜2色）
+- **Secondary Colors**: アクセントカラー
+- **Semantic Colors**: Success, Warning, Error, Info
+- **Neutral Colors**: グレースケール（背景、テキスト、ボーダー）
+- **Dark Mode 対応**: 必要に応じてダークテーマも定義
+
+CSS 変数のサンプルは [examples/css-tokens.md](examples/css-tokens.md#カラーパレット) を参照。
+
+### 4. タイポグラフィの定義
+
+- **フォントファミリー**: 見出し用、本文用、コード用
+- **フォントサイズスケール**: xs, sm, base, lg, xl, 2xl, 3xl, 4xl
+- **行間**: tight, normal, relaxed
+- **フォントウェイト**: normal, medium, semibold, bold
+
+サンプル: [examples/css-tokens.md](examples/css-tokens.md#タイポグラフィ)
+
+### 5. スペーシングシステムの定義
+
+基本単位は 4px または 8px ベース。スケール・用途・サンプルは [examples/css-tokens.md](examples/css-tokens.md#スペーシング) と [reference/component-catalog.md](reference/component-catalog.md#スペーシングの設計方針) を参照。
+
+### 6. コンポーネントスタイルの定義
+
+以下のコンポーネントについて、バリアントとステートを定義:
+
+- ボタン
+- フォーム要素（Input, Textarea, Select, Checkbox, Radio）
+- カード / コンテナ
+- その他（Badge, Tag, Avatar, Tooltip, Modal）
+
+詳細なバリアント・ステート一覧は [reference/component-catalog.md](reference/component-catalog.md#コンポーネントスタイル) を参照。
+
+### 7. アイコン・イラストガイドライン
+
+- アイコンライブラリ（Lucide / Heroicons / Material Icons 等）の選定
+- サイズ規定とスタイル統一（Outline / Filled のいずれか）
+
+詳細: [reference/component-catalog.md](reference/component-catalog.md#アイコンガイドライン)
+
+### 8. アニメーション・トランジション
+
+- Duration: fast(150ms), normal(300ms), slow(500ms)
+- Easing: ease-in-out をデフォルトに
+
+サンプル: [examples/css-tokens.md](examples/css-tokens.md#アニメーション)
+
+### 9. ドキュメント作成
+
+`docs/project/04-design/04-design-system.md` に以下を必須セクションとして記入:
+
+- カラーパレット
+- タイポグラフィ
+- スペーシング
+- コンポーネントスタイル（主要なもの）
+
+### 10. 完了条件の確認
+
+- [ ] `04-design-system.md` が作成されている
+- [ ] カラーパレットが定義されている
+- [ ] タイポグラフィスケールが定義されている
+- [ ] スペーシングシステムが定義されている
+- [ ] 主要コンポーネント（ボタン、フォーム）のスタイルが定義されている
+
+### 11. Git への追加（オプション）
+
+```bash
+git add docs/project/04-design/04-design-system.md
+git status
+```
+
+推奨コミットメッセージ:
+
+```
+docs: デザインシステムの定義
+
+- カラーパレット、タイポグラフィ、スペーシングを定義
+- 主要コンポーネントのスタイルガイドを追加
+```
+
+## 完了条件
+
+- `docs/project/04-design/04-design-system.md` が作成されている
+- カラー・タイポグラフィ・スペーシングが定義されている
+- 主要コンポーネントのスタイルが定義されている
+- ユーザーが内容を承認している
+
+## エスカレーション
+
+- **ブランドガイドラインなし**: 「ブランドカラーやフォントの指定がありますか？なければ汎用的なパレットを提案します。」
+- **CSS フレームワーク未定**: 「`/a-007-define-tech-stack` で技術スタックを先に決定しましょう。」
+- **コンポーネントが多すぎる**: 「まずはボタン・フォーム・カードから始め、必要に応じて拡張しましょう。」
+
+## 参考
+
+- [examples/css-tokens.md](examples/css-tokens.md) — カラー/タイポ/スペーシング/アニメーションの CSS サンプル
+- [reference/component-catalog.md](reference/component-catalog.md) — コンポーネント・アイコン・アニメーションの標準仕様

package/skills/a-011-define-data-model/SKILL.md

@@ -1,118 +1,118 @@
----
-name: a-011-define-data-model
-description: ドメインモデルと画面設計からデータベース構造（ERD・エンティティ・属性・リレーションシップ・制約）を定義する。画面設計後、永続化層を設計する際に使用。
-disable-model-invocation: true
-allowed-tools: Read, Write, Edit, Bash, Grep, Glob
----
-
-# DefineDataModel (a-011)
-
-## 目的
-
-- ドメインモデル（Aggregates）と画面設計を基に、データベース構造を定義する。
-- エンティティ（テーブル）、属性（カラム）、リレーションシップを明確化する。
-- データ型、制約（NOT NULL、UNIQUE、CHECK）、インデックス戦略を決定する。
-- Mermaid ERD（Entity Relationship Diagram）で視覚化し、開発者間の認識を統一する。
-
-## 前提
-
-- `docs/project/03-domain/01-domain-model.md` が作成されていること。
-- `docs/project/04-design/01-tech-stack.md` が作成されていること（DB 選定済み）。
-- `docs/project/04-design/03-screen-design.md` が作成されていること。
-- `docs/project/04-design/` ディレクトリが存在すること。
-
-## 手順
-
-### 1. ドキュメントと前提条件の確認
-
-以下を読み込む:
-
-- `docs/project/03-domain/01-domain-model.md`
-- `docs/project/04-design/01-tech-stack.md`
-- `docs/project/04-design/03-screen-design.md`
-
-不足があれば対応スキルの実行を促す。
-
-### 2. テンプレートの準備
-
-このスキルの配置ディレクトリ（`skills/a-011-define-data-model/`）を起点に、相対パス `../../templates/project/04-design/05-data-model.md` を Read で読み込み、その内容を `docs/project/04-design/05-data-model.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する（冪等）。出力先ディレクトリ（`docs/project/04-design/`）が無ければ作成する。
-
-### 3. エンティティの抽出と提案
-
-- **ドメインモデルから**: Aggregate Root および内部エンティティを抽出
-- **画面設計から**: 表示・入力項目から必要なデータ構造（履歴、設定、ログ等）を抽出
-- 「[エンティティ名] (対応 Aggregate: [名前])」形式で一覧化
-
-エンティティ一覧の記述例は [examples/erd-templates.md](examples/erd-templates.md#エンティティ一覧テーブル) を参照。
-
-### 4. 詳細定義（インタビュー）
-
-#### 4.1 基本定義
-
-- テーブル名（物理名）、論理名、説明
-- 主キー戦略（Auto Increment / UUID / CUID）— 選択ガイドは [examples/erd-templates.md](examples/erd-templates.md#主キー戦略) を参照
-
-#### 4.2 属性（カラム）
-
-- カラム名、データ型（DB 製品に合わせて具体化）
-- 制約（NOT NULL, UNIQUE, DEFAULT, CHECK）
-- 監査カラム（created_at, updated_at）の有無
-
-カラム定義の例は [examples/erd-templates.md](examples/erd-templates.md#カラム定義テンプレート) を参照。
-
-#### 4.3 リレーションシップ
-
-- 関連（1:1 / 1:N / N:M）
-- 外部キー制約（ON DELETE CASCADE / SET NULL / RESTRICT）— 選択基準は [examples/erd-templates.md](examples/erd-templates.md#外部キー削除動作の選択) を参照
-
-### 5. ERD の作成と正規化
-
-- Mermaid ERD 形式で記述（テンプレートは [examples/erd-templates.md](examples/erd-templates.md#mermaid-erd-記述例) を参照）
-- 正規化（1NF-3NF）を確認。意図的な非正規化があれば理由を記録
-- インデックス戦略（検索頻度、UNIQUE、複合インデックス）を定義
-
-正規化の目安は [reference/structure-check.md](reference/structure-check.md#正規化レベルの目安) を参照。
-
-### 6. ドキュメント作成
-
-`docs/project/04-design/05-data-model.md` に以下を記入する:
-
-- エンティティ一覧
-- リレーションシップ定義
-- ERD（Mermaid）
-- インデックス戦略・非正規化の記録
-
-### 7. 構造チェック
-
-```bash
-grep "## エンティティ一覧" docs/project/04-design/05-data-model.md \
-  && grep "\`\`\`mermaid" docs/project/04-design/05-data-model.md \
-  && grep "## リレーションシップ" docs/project/04-design/05-data-model.md \
-  && echo "OK" || echo "MISSING SECTION"
-```
-
-詳細チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
-
-### 8. Git への追加（任意）
-
-```bash
-git add docs/project/04-design/05-data-model.md
-git commit -m "docs: データモデル（ERD）の定義"
-```
-
-## 完了条件
-
-- `docs/project/04-design/05-data-model.md` が作成されている。
-- データベーススキーマ（テーブル、カラム、型、制約）が定義されている。
-- エンティティ間の関係性が可視化（ERD）されている。
-- ユーザーが内容を承認している。
-
-## エスカレーション
-
-- **ドメインモデルとの不整合**: 「Aggregate 構造とデータモデルが乖離しています。ORM のマッピング戦略を確認するか、ドメインモデルを見直してください。」
-- **パフォーマンス懸念**: 「正規化により JOIN が多発する可能性があります。Read Model や意図的な非正規化を検討しませんか？」
-
-## 参考
-
-- [examples/erd-templates.md](examples/erd-templates.md) — エンティティ一覧、カラム定義、主キー戦略、外部キー動作、Mermaid ERD、インデックス・非正規化の例
-- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、正規化レベル、レビュー質問
+---
+name: a-011-define-data-model
+description: ドメインモデルと画面設計からデータベース構造（ERD・エンティティ・属性・リレーションシップ・制約）を定義する。画面設計後、永続化層を設計する際に使用。
+disable-model-invocation: true
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# DefineDataModel (a-011)
+
+## 目的
+
+- ドメイン（Domain Sketch の中核エンティティ、Full DDD 採用時は Aggregates）と画面設計を基に、データベース構造を定義する。
+- エンティティ（テーブル）、属性（カラム）、リレーションシップを明確化する。
+- データ型、制約（NOT NULL、UNIQUE、CHECK）、インデックス戦略を決定する。
+- Mermaid ERD（Entity Relationship Diagram）で視覚化し、開発者間の認識を統一する。
+
+## 前提
+
+- `docs/project/03-domain/01-domain-sketch.md` が作成されていること（Full DDD 採用時は `01-domain-model.md`）。
+- `docs/project/04-design/01-tech-stack.md` が作成されていること（DB 選定済み）。
+- `docs/project/04-design/03-screen-design.md` が作成されていること。
+- `docs/project/04-design/` ディレクトリが存在すること。
+
+## 手順
+
+### 1. ドキュメントと前提条件の確認
+
+以下を読み込む:
+
+- `docs/project/03-domain/01-domain-sketch.md`（Full DDD 採用時は `01-domain-model.md`）
+- `docs/project/04-design/01-tech-stack.md`
+- `docs/project/04-design/03-screen-design.md`
+
+不足があれば対応スキルの実行を促す。
+
+### 2. テンプレートの準備
+
+このスキルの配置ディレクトリ（`skills/a-011-define-data-model/`）を起点に、相対パス `../../templates/project/04-design/05-data-model.md` を Read で読み込み、その内容を `docs/project/04-design/05-data-model.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する（冪等）。出力先ディレクトリ（`docs/project/04-design/`）が無ければ作成する。
+
+### 3. エンティティの抽出と提案
+
+- **ドメインモデルから**: Aggregate Root および内部エンティティを抽出
+- **画面設計から**: 表示・入力項目から必要なデータ構造（履歴、設定、ログ等）を抽出
+- 「[エンティティ名] (対応 Aggregate: [名前])」形式で一覧化
+
+エンティティ一覧の記述例は [examples/erd-templates.md](examples/erd-templates.md#エンティティ一覧テーブル) を参照。
+
+### 4. 詳細定義（インタビュー）
+
+#### 4.1 基本定義
+
+- テーブル名（物理名）、論理名、説明
+- 主キー戦略（Auto Increment / UUID / CUID）— 選択ガイドは [examples/erd-templates.md](examples/erd-templates.md#主キー戦略) を参照
+
+#### 4.2 属性（カラム）
+
+- カラム名、データ型（DB 製品に合わせて具体化）
+- 制約（NOT NULL, UNIQUE, DEFAULT, CHECK）
+- 監査カラム（created_at, updated_at）の有無
+
+カラム定義の例は [examples/erd-templates.md](examples/erd-templates.md#カラム定義テンプレート) を参照。
+
+#### 4.3 リレーションシップ
+
+- 関連（1:1 / 1:N / N:M）
+- 外部キー制約（ON DELETE CASCADE / SET NULL / RESTRICT）— 選択基準は [examples/erd-templates.md](examples/erd-templates.md#外部キー削除動作の選択) を参照
+
+### 5. ERD の作成と正規化
+
+- Mermaid ERD 形式で記述（テンプレートは [examples/erd-templates.md](examples/erd-templates.md#mermaid-erd-記述例) を参照）
+- 正規化（1NF-3NF）を確認。意図的な非正規化があれば理由を記録
+- インデックス戦略（検索頻度、UNIQUE、複合インデックス）を定義
+
+正規化の目安は [reference/structure-check.md](reference/structure-check.md#正規化レベルの目安) を参照。
+
+### 6. ドキュメント作成
+
+`docs/project/04-design/05-data-model.md` に以下を記入する:
+
+- エンティティ一覧
+- リレーションシップ定義
+- ERD（Mermaid）
+- インデックス戦略・非正規化の記録
+
+### 7. 構造チェック
+
+```bash
+grep "## エンティティ一覧" docs/project/04-design/05-data-model.md \
+  && grep "\`\`\`mermaid" docs/project/04-design/05-data-model.md \
+  && grep "## リレーションシップ" docs/project/04-design/05-data-model.md \
+  && echo "OK" || echo "MISSING SECTION"
+```
+
+詳細チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
+
+### 8. Git への追加（任意）
+
+```bash
+git add docs/project/04-design/05-data-model.md
+git commit -m "docs: データモデル（ERD）の定義"
+```
+
+## 完了条件
+
+- `docs/project/04-design/05-data-model.md` が作成されている。
+- データベーススキーマ（テーブル、カラム、型、制約）が定義されている。
+- エンティティ間の関係性が可視化（ERD）されている。
+- ユーザーが内容を承認している。
+
+## エスカレーション
+
+- **ドメインモデルとの不整合**: 「Aggregate 構造とデータモデルが乖離しています。ORM のマッピング戦略を確認するか、ドメインモデルを見直してください。」
+- **パフォーマンス懸念**: 「正規化により JOIN が多発する可能性があります。Read Model や意図的な非正規化を検討しませんか？」
+
+## 参考
+
+- [examples/erd-templates.md](examples/erd-templates.md) — エンティティ一覧、カラム定義、主キー戦略、外部キー動作、Mermaid ERD、インデックス・非正規化の例
+- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、正規化レベル、レビュー質問