CLAUDE.md ガイド

## 1. コアアイデンティティ
 
MoAI は Claude Code の戦略的オーケストレーターです。
 
### HARD ルール (必須)
- [HARD] 言語認識応答: ユーザーの conversation_language で応答
- [HARD] 並列実行: 独立したツール呼び出しは並列実行
- [HARD] XML タグ非表示: ユーザー対面応答に XML 非表示
- [HARD] Markdown 出力: すべてのコミュニケーションに Markdown 使用

# Plan: SPEC ドキュメント作成 (30K トークン)
> /moai plan "機能説明"
 
# Run: DDD 実装 (180K トークン)
> /moai run SPEC-XXX
 
# Sync: ドキュメント同期 (40K トークン)
> /moai sync SPEC-XXX

language:
  conversation_language: ko           # ユーザー応答言語
  agent_prompt_language: en           # エージェント内部言語
  git_commit_messages: en             # Git コミットメッセージ
  code_comments: en                   # コードコメント
  documentation: en                   # ドキュメントファイル

# プロジェクトローカル設定
 
## ドキュメント作成ガイドライン
 
### MDX レンダリングエラー防止
- 強調表示と括弧の間に必ずスペース
 
### Mermaid ダイアグラム方向
- すべてのダイアグラムは縦方向 (flowchart TD)
 
## 個人メモ
- DB マイグレーション前にバックアップ必須
- API エンドポイント命名: kebab-case 使用

.claude/rules/moai/
├── core/                          # コア原則
│   └── moai-constitution.md       # TRUST 5、コアルール
├── development/                   # 開発標準
│   ├── skill-authoring.md         # スキル作成ガイド
│   └── coding-standards.md        # コーディング標準
├── workflow/                      # ワークフロー
│   ├── workflow-modes.md          # Plan/Run/Sync 定義
│   └── spec-workflow.md           # SPEC ワークフロー
└── languages/                     # 言語別ルール (16 つ)
    ├── python.md
    ├── typescript.md
    ├── javascript.md
    └── ...

---
paths:
  - "**/*.py"
  - "**/pyproject.toml"
---
 
# Python コーディングルール
- ruff フォーマッター使用
- type ヒント必須
- docstring は Google スタイル

# プロジェクトローカル設定
 
## React ルール
- コンポーネントは必ず関数型で作成
- Props インターフェースはコンポーネントファイル上部で定義
- 状態管理は Zustand 使用
- CSS は Tailwind CSS のみ使用
 
## 命名ルール
- コンポーネント: PascalCase (UserProfile.tsx)
- ユーティリティ: camelCase (formatDate.ts)
- 定数: UPPER_SNAKE_CASE (MAX_RETRY_COUNT)
- API エンドポイント: kebab-case (/api/user-profiles)
 
## 禁止事項
- any 型使用禁止
- console.log 本番コードで禁止
- default export 禁止 (named export のみ使用)

# プロジェクトローカル設定
 
## Python ルール
- FastAPI 使用
- 非同期関数優先 (async/await)
- Pydantic v2 モデル使用
- SQLAlchemy 2.0 スタイル
 
## データベースルール
- マイグレーション前に必ずバックアップ
- インデックスはクエリーパターン分析後追加
- soft delete パターン使用 (is_deleted フラグ)
 
## API ルール
- RESTful エンドポイント命名
- レスポンス形式統一: {"data": ..., "message": ...}
- エラーコード標準化