database-seeding
概要
シーディング要件の整理から設計・実装・検証までを一貫して支援し、環境ごとのデータ投入を安全に運用する。
ワークフロー
Phase 1: 要件整理
目的: 目的と制約を整理し、シード対象と優先度を明確化する。
アクション:
- 目的別に対象データと投入範囲を整理する。
assets/seeding-requirements-template.mdで要件を記録する。references/seed-strategies.mdで戦略の候補を整理する。
Task: agents/seed-strategy-selection.md を参照
Phase 2: 設計
目的: 環境分離とデータ生成ルールを設計する。
アクション:
references/environment-separation.mdで分離方針を確認する。references/data-generation.mdで生成ルールを整理する。assets/seed-file-template.tsに沿って構成を決める。
Task: agents/environment-separation.md を参照
Phase 3: 実装
目的: シードスクリプトを実装し、投入を実行する。
アクション:
assets/seed-file-template.tsを基にシードを実装する。scripts/seed-runner.mjsで投入フローを確認する。- 重要な変更点を記録する。
Task: agents/test-data-setup.md を参照
Phase 4: 検証と運用
目的: データ品質と再現性を検証し、改善記録を残す。
アクション:
assets/seeding-validation-checklist.mdで検証する。agents/data-validation.mdの観点で品質を確認する。scripts/log_usage.mjsで記録を更新する。
Task: agents/data-validation.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| seed-strategy-selection | Phase 1開始時 | 要件メモ | シード戦略案、優先度 |
| environment-separation | Phase 2開始時 | 戦略案 | 環境分離方針、投入条件 |
| test-data-setup | Phase 3開始時 | 設計方針 | テストデータ、投入結果 |
| fixture-management | Phase 3開始時 | テスト要件 | フィクスチャ一覧、更新方針 |
| production-initial-data | Phase 3開始時 | 本番要件 | 本番初期データ計画 |
| data-validation | Phase 4開始時 | 投入結果 | 検証レポート、改善提案 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| 環境別にシードを分離する | 本番誤投入を防ぐ |
| 参照整合性を先に設計する | 投入順序の破綻を防ぐ |
| テストデータを再現可能にする | テストの信頼性が上がる |
| 検証結果を必ず記録する | 再現と改善が容易になる |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 本番データを開発に流用する | 機密漏えいリスクが高い |
| シード手順を手作業に依存 | 再現性が失われる |
| 変更履歴を残さない | 原因調査が困難になる |
| 検証を省略する | 破綻したデータが残る |
リソース参照
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|---|
scripts/seed-runner.mjs |
シード実行フロー支援 |
scripts/validate-skill.mjs |
スキル構造の検証 |
scripts/log_usage.mjs |
使用記録と評価メトリクス更新 |
references/(詳細知識)
| リソース | パス | 読込条件 |
|---|---|---|
| レベル1 基礎 | references/Level1_basics.md | 要件整理時 |
| レベル2 実務 | references/Level2_intermediate.md | 設計時 |
| レベル3 応用 | references/Level3_advanced.md | 実装時 |
| レベル4 専門 | references/Level4_expert.md | 検証時 |
| シード戦略 | references/seed-strategies.md | 戦略選定時 |
| データ生成 | references/data-generation.md | データ生成時 |
| 環境分離 | references/environment-separation.md | 分離設計時 |
| 要求仕様索引 | references/requirements-index.md | 仕様確認時 |
| 旧スキル | references/legacy-skill.md | 互換確認時 |
assets/(テンプレート・素材)
| アセット | 用途 |
|---|---|
assets/seed-file-template.ts |
シードファイルの雛形 |
assets/seeding-requirements-template.md |
要件整理テンプレート |
assets/seeding-validation-checklist.md |
検証チェックリスト |
運用ファイル
| ファイル | 目的 |
|---|---|
EVALS.json |
レベル評価・メトリクス管理 |
LOGS.md |
実行ログの蓄積 |
CHANGELOG.md |
改善履歴の記録 |