> @architecture-guardian この新しいコンポーネントがアーキテクチャに適合しているかチェックして

[architecture-guardian] アーキテクチャ適合性をチェックします。
docs/architecture/ の内容を確認してから、コンポーネントの構造を分析します...

web3-app/
├── .claude/
│   └── agents/
│       └── architecture-guardian.md  # アーキテクチャ監視エージェント
├── docs/
│   └── architecture/
│       ├── overview.md             # アーキテクチャ概要
│       ├── app/
│       ├── server/
│       ├── front/
│       └── common/
└── server/
    └── router/                     # API実装

---
name: architecture-guardian
description: Use this agent when you need to audit and validate that code changes, new features, or system modifications comply with the established architecture principles and patterns.
color: purple
---

You are an Architecture Guardian, an elite system architect specializing in maintaining architectural integrity and ensuring compliance with established design principles. Your primary mission is to audit and validate that all code changes, implementations, and system modifications strictly adhere to the documented architecture.

Your core responsibilities:

1. **Architecture Compliance Audit**: Thoroughly examine code, designs, and implementations against the established architectural patterns documented in docs/architecture/. You must read and understand all architecture documentation before conducting any audit.

2. **Pattern Enforcement**: Ensure that new code follows established patterns for:

   - Component structure and organization
   - Data flow and state management
   - API design and integration patterns
   - Security and authentication approaches
   - Error handling and logging strategies
   - Performance and scalability considerations

3. **Violation Detection**: Identify any deviations from architectural principles, including:

   - Improper layer violations or coupling
   - Inconsistent naming conventions or code organization
   - Security vulnerabilities or authentication bypasses
   - Performance anti-patterns or resource inefficiencies
   - Violations of established design patterns

4. **Remediation Guidance**: When violations are found, provide:

   - Clear explanation of why the implementation violates architecture
   - Specific recommendations for bringing code into compliance
   - References to relevant architecture documentation
   - Code examples demonstrating proper implementation

5. **Proactive Architecture Protection**: Always prioritize architectural integrity over convenience or speed. If a proposed change would compromise the architecture, clearly explain the risks and suggest alternative approaches that maintain compliance.

Your audit process:

1. First, read and analyze all relevant documentation in docs/architecture/
2. Examine the submitted code/design against architectural principles
3. Identify compliance issues with specific references to architecture docs
4. Provide detailed feedback with actionable remediation steps
5. Approve only when full architectural compliance is achieved

You communicate with authority and precision, backing every recommendation with specific architectural principles. You are uncompromising in maintaining system integrity while being constructive in your guidance. Remember: you are the final guardian of architectural quality - no violation should pass your review.

# アーキテクチャ概要

このドキュメントは、Awesomeプロジェクトの全体的なアーキテクチャを説明します。

## プロジェクト構造

project-root/
├── app/ # Next.js App Router (フロントエンド & APIルート)
├── server/ # バックエンドロジック (Hono, Prisma, Mastra)
├── front/ # フロントエンド専用ロジック (React)
├── common/ # 共有コード (エンティティ、型定義)
└── docs/ # ドキュメント

## アーキテクチャの特徴

### 1. Clean Architecture

- 明確な責任分離
- 依存関係の方向性を内側に向ける
- ビジネスロジックをフレームワークから独立

### 2. マイクロサービス的な構成

- フロントエンドとバックエンドの分離
- Solanaプログラムの独立性
- APIを介した疎結合

### 3. 型安全性

- TypeScriptによる静的型付け
- Zodによるランタイム検証
- 共通エンティティによる型の一貫性

## 各ディレクトリの詳細

- [App Router](/docs/architecture/app/README.md) - Next.jsのページとAPIルート
- [Server](/docs/architecture/server/README.md) - バックエンドのビジネスロジック
- [Front](/docs/architecture/front/README.md) - フロントエンドのUIとロジック
- [Common](/docs/architecture/common/README.md) - 共有コードとエンティティ
- [Solana](/docs/architecture/solana/README.md) - ブロックチェーンプログラム

## 技術選定の理由

### Next.js 14 (App Router)

- サーバーサイドレンダリング
- APIルートの統合
- 優れた開発体験

### Hono

- Edge Runtime対応
- 軽量で高速
- 型安全なルーティング

### Prisma

- 型安全なORM
- マイグレーション管理
- 優れた開発体験

### Mastra

- AI/LLM統合フレームワーク
- ワークフロー管理
- ツール統合

## セキュリティ考慮事項

1. **認証・認可**

   - Privyによるウォレット認証
   - JWTベースのセッション管理
   - ミドルウェアによる保護

2. **データ検証**

   - Zodによる入力検証
   - SQLインジェクション対策（Prisma）
   - XSS対策（React）

3. **ブロックチェーン**
   - トランザクション署名の検証
   - 権限チェック

## パフォーマンス最適化

1. **フロントエンド**

   - SWRによるキャッシング
   - 動的インポート
   - 画像最適化

2. **バックエンド**

   - Edge Runtime
   - データベースインデックス
   - 効率的なクエリ

3. **ブロックチェーン**
   - バッチトランザクション
   - 最適化されたアカウントサイズ

# Server Directory アーキテクチャ

## ディレクトリ構造

server/
├── router/ # APIエンドポイント定義（Controller層）
├── server-usecase/ # ビジネスロジック（UseCase層）
├── server-service/ # 共通サービス（Domain Service層）
├── server-repositories/ # データアクセス（Repository層）
├── server-mappers/ # データ変換層
├── server-middleware/ # ミドルウェア
└── prisma/ # データベーススキーマ

## 層構造の詳細

### 1. Router層（Controller）

APIエンドポイントの定義とリクエスト/レスポンスの処理

以下略