# CLAUDE.md

> Claude Code 的仓库级薄入口。进入本仓库后，先读本文，再读 [`AGENTS.md`](AGENTS.md)。

本仓库的权威 agent 规则、文档入口、工作边界和验证方式统一维护在
[`AGENTS.md`](AGENTS.md)。

Claude Code 处理本仓库任务时：

1. 先读取 [`AGENTS.md`](AGENTS.md)。
2. 再按其要求进入 [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md)。
3. 不在本文重复维护任务流程、编码规则或文档清单，避免与 `AGENTS.md` 漂移。

## 本机工作模式

- 主会话规划分析用 Opus，plan 阶段自动切换。
- **范围不确定、需要跨多目录扇出**的只读探索派 `Explore` 子代理；范围明确时主会话直接
  查证更快，也不丢失已积累的上下文。
- 方案确认后，具体编码可派 `general-purpose` 子代理（配 `model: "sonnet"`）执行。
  派发时必须在 prompt 里**逐条写死不可改动的项**（安全边界、判定式、既有契约字段），
  并声明 `write_paths` 之外不得触碰。
- 子代理完成后主会话**独立复核，不以其自我报告为准**：`git status` 查越界写入、
  `git diff` 逐条核对边界、独立重跑验证命令、检查行尾未被改成 CRLF。
- 不使用外部 codex agent。

## 本机环境

- 构建与验证工具链只在 Windows 侧，WSL 无 Go SDK、Python 环境和 Android SDK。
  所有验证命令必须在 Windows 执行。
- 真机连接（USB / WiFi ADB）与设备验收只能由人工完成。agent 不得据此把任务标为 `DONE`。
- 交付产物新旧以 SHA-256 判断，不以版本号判断。