Review Scalardb

ScalarDB Review Agent

ScalarDB関連の設計およびコードをレビューし、品質・整合性・ベストプラクティス準拠を検証するエージェントです。

概要

2つのモードで動作します：

1. 設計レビュー (--mode=design): ScalarDB設計ドキュメントの品質検証
2. コードレビュー (--mode=code): 生成されたScalarDB/Spring Bootコードの品質検証

前提条件

Mode A: 設計レビュー (--mode=design)

必須:

• work/{project}/scalardb-edition-config.md ← /select-scalardb-edition
• reports/03_design/scalardb-*.md のいずれか ← /design-scalardb or /design-scalardb-app-patterns

Mode B: コードレビュー (--mode=code)

必須:

• work/{project}/scalardb-edition-config.md ← /select-scalardb-edition
• generated/{service}/ ← /generate-scalardb-code

出力先

結果は reports/03_design/ に出力します。 重要: 各ステップ完了時に即座にファイルを出力してください。

reports/03_design/
├── scalardb-design-review.md    # Mode A: Step 7A完了時
└── scalardb-code-review.md      # Mode B: Step 7B完了時

サブエージェント活用

• Context7でScalarDB最新仕様を取得（Pattern 3）
• 観点別に並列レビューサブエージェントを起動（Pattern 4）

詳細は .claude/skills/common/sub-agent-patterns.md を参照。

実行プロンプト

あなたはScalarDBの設計・コード品質の専門家です。以下の手順でレビューを実行してください。

Step 0: モード判定と前提条件検証

引数からモード（--mode=design or --mode=code）を判定。

必須ファイルの確認:
├── work/{project}/scalardb-edition-config.md  [必須]
├── [Mode A] reports/03_design/scalardb-*.md   [必須]
└── [Mode B] generated/{service}/              [必須]

エラーハンドリング:

• エディション設定が存在しない → /select-scalardb-edition を先に実行するよう案内
• 設計ファイルが存在しない → /design-scalardb を先に実行するよう案内
• コードが存在しない → /generate-scalardb-code を先に実行するよう案内

Step 1: Context7で最新仕様を取得

Task(subagent_type="general-purpose", description="Fetch ScalarDB latest specs", prompt="
Context7 MCPでScalarDBの最新仕様を取得してください。

mcp__context7__query-docs を以下で呼び出し:
- libraryId: /llmstxt/scalardb_scalar-labs_llms-full_txt
- query: ScalarDB best practices schema design transaction management configuration

取得した情報から以下をまとめてください:
- 最新の設計ガイドライン
- 非推奨/廃止された機能
- パフォーマンスベストプラクティス
")

Mode A: 設計レビュー

Step 2A: レビュー対象の読み込み

以下の設計ファイルを読み込み：

• work/{project}/scalardb-edition-config.md （エディション設定）
• reports/03_design/scalardb-schema-design.md （スキーマ設計）
• reports/03_design/scalardb-app-patterns.md （アプリパターン）
• reports/03_design/scalardb-database-selection.md （DB選定）
• reports/03_design/target-architecture.md （ターゲットアーキテクチャ）

Step 3A: エディション整合性チェック

Step 4A: Key設計妥当性チェック

Step 5A: トランザクション境界チェック

Step 6A: Multi-Storage構成チェック

Step 7A: レビュー結果出力

出力: reports/03_design/scalardb-design-review.md

Mode B: コードレビュー

Step 2B: レビュー対象の読み込み

Task(subagent_type="Explore", description="Scan generated code", prompt="
以下のディレクトリ内のScalarDB関連コードを調査してください:
- generated/{service}/ の全Javaファイル

以下の観点で情報を収集:
1. リポジトリ実装クラス一覧
2. トランザクション管理パターン
3. エンティティ/値オブジェクトの定義
4. 設定ファイルの内容
5. build.gradleの依存関係
")

Step 3B: coding-patterns準拠チェック

.claude/rules/scalardb-coding-patterns.md に基づくチェック：

Step 4B: エディション別APIチェック

Step 5B: トランザクション管理チェック

Step 6B: VO/Entity/Repositoryチェックリスト

値オブジェクト:

• record 使用またはimmutable
• コンストラクタでバリデーション
• ファクトリメソッド提供 (of, generate)
• equals/hashCodeは値で比較

エンティティ:

• ファクトリメソッド (create)
• 復元メソッド (reconstitute)
• ドメインイベント管理
• version フィールド

リポジトリ:

• インターフェースはドメイン層
• 実装はインフラ層
• エディション別API使用
• トランザクション管理
• 楽観ロックチェック

Step 7B: レビュー結果出力

出力: reports/03_design/scalardb-code-review.md

出力フォーマット

scalardb-design-review.md / scalardb-code-review.md

---
title: ScalarDB [設計/コード]レビュー
phase: "Phase [5.9/8.5]: ScalarDB Review"
skill: review-scalardb
mode: [design/code]
generated_at: [timestamp]
input_files:
  - [レビュー対象ファイル一覧]
---

# ScalarDB [設計/コード]レビュー

## エグゼクティブサマリー

| カテゴリ | 合格 | 警告 | 不合格 | 合計 |
|---------|------|------|--------|------|
| エディション整合性 | X | X | X | X |
| Key設計 | X | X | X | X |
| トランザクション | X | X | X | X |
| [その他] | X | X | X | X |
| **合計** | **X** | **X** | **X** | **X** |

## 総合判定

- [ ] **PASS**: 問題なし、次フェーズ進行可能
- [ ] **CONDITIONAL PASS**: 警告あり、修正推奨だが進行可能
- [ ] **FAIL**: 不合格項目あり、修正必須

## 詳細レビュー結果

### [カテゴリ名]

| # | チェック項目 | 結果 | 重要度 | 詳細 | 修正提案 |
|---|------------|------|--------|------|---------|
| 1 | [項目] | PASS/WARN/FAIL | Critical/High/Medium | [詳細] | [提案] |

## 修正推奨事項（優先順）

### Critical（即時修正必須）
1. [項目と修正内容]

### High（早期修正推奨）
1. [項目と修正内容]

### Medium（改善推奨）
1. [項目と修正内容]

## Context7参照による最新仕様との差異
[Context7で取得した最新情報との差異があれば記載]

エラーハンドリング

• レビュー対象がない → 前提スキルの実行を案内
• Context7で最新情報が取得できない → 静的ルールのみでレビュー実行（警告付き）
• 複数サービスのコードがある → ユーザーに対象サービスの選択を促す

関連スキル