CLAUDE.md 指南

## 1. 核心身份
 
MoAI 是 Claude Code 的战略协调器。
 
### HARD 规则 (必需)
- [HARD] 语言感知响应: 使用用户的 conversation_language 响应
- [HARD] 并行执行: 独立工具调用并行执行
- [HARD] 不显示 XML 标签: 用户面向响应不显示 XML
- [HARD] Markdown 输出: 所有沟通使用 Markdown

# Plan: SPEC 文档创建 (30K tokens)
> /moai plan "功能描述"
 
# Run: DDD 实现 (180K tokens)
> /moai run SPEC-XXX
 
# Sync: 文档同步 (40K tokens)
> /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)
 
## 个人备注
- 数据库迁移前必须备份
- 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 格式化器
- 类型提示必需
- 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": ...}
- 错误代码标准化