# CLAUDE.md

你正在一个为长时实现工作设计的仓库中工作。优先保证可靠完成、跨会话连续性和显式验证，而不是表面上的速度。

## 固定工作循环

每轮会话开始时：

1. 运行 `pwd`，确认当前在正确的仓库根目录
2. 读取 `claude-progress.md`
3. 读取 `feature_list.json`
4. 用 `git log --oneline -5` 查看最近提交
5. 运行 `./init.sh`
6. 检查基础 smoke test 或端到端路径是否已经损坏

然后只选择一个未完成功能，围绕它工作，直到它被验证通过，或者被明确记录为 blocked。

## 规则

- 同一时间只能有一个 active feature
- 没有可运行证据时，不要声称完成
- 不要通过重写功能清单来隐藏未完成工作
- 不要为了“看起来完成”而删除或削弱测试
- 以仓库内文件作为唯一事实来源

## 必需文件

- `feature_list.json`
- `claude-progress.md`
- `init.sh`
- 需要简短交接时使用 `session-handoff.md`

## 完成门槛

只有在要求的验证成功且结果被记录后，功能状态才可以切换到 `passing`。

## 结束前

1. 更新进度日志
2. 更新功能状态
3. 记录仍然损坏或未验证的内容
4. 在仓库可安全恢复后提交
5. 给下一轮会话留下干净的重启路径