master-data

マスターデータ（SQLite）のパターンとチェックリスト。新規マスタ追加時に参照。

$ インストール

git clone https://github.com/Osakana3610/Osakana-Guild /tmp/Osakana-Guild && cp -r /tmp/Osakana-Guild/.claude/skills/master-data ~/.claude/skills/Osakana-Guild

// tip: Run this command in your terminal to install the skill

SKILL.md

View on GitHub →

name: master-data description: マスターデータ（SQLite）のパターンとチェックリスト。新規マスタ追加時に参照。

Master Data Patterns

概要

マスターデータはSQLiteから読み込む読み取り専用データ。

SQLite → SQLiteMasterDataManager → MasterDataLoader → MasterDataCache
                                                            ↓
                                                    各サービスで使用

Definition型

Domain/MasterData/ に配置。

ルール:

struct + Identifiable + Sendable + Hashable
let で不変
ネストした構造体で関連データをグループ化

SQLiteクエリ

Application/MasterData/SQLite/SQLiteMasterDataQueries.*.swift に配置。

ルール:

SQLiteMasterDataManager のextensionとして実装
ファイル名は SQLiteMasterDataQueries.{Entity}.swift
複雑な結合はBuilderパターンを使用

新規マスターデータ追加時のチェックリスト

Domain/MasterData/ に *MasterModels.swift 作成
- *Definition 構造体を定義
Application/MasterData/SQLite/SQLiteMasterDataQueries.*.swift 作成
- fetchAll*() メソッドを実装
MasterDataCache.swift にプロパティ追加
MasterDataLoader.swift でロード処理追加
必要に応じてゲーム用語定義を更新