# Development Doc

本目录用于持续记录 Jarvis 的规划与开发过程。

## 目录结构

### `plan/`
用于记录中长期规划、升级方案、分阶段设计、专项计划。

建议内容：
- 每个升级点的目标
- 计划改动的模块和文件
- 分阶段实施顺序
- 风险与验收标准
- 设计决策与取舍

当前文件：
- `plan/README.md`
- `plan/phase-0-current-state-and-target.md`
- `plan/phase-1-safe-foundation.md`
- `plan/phase-2-controlled-collaboration.md`
- `plan/phase-3-dynamic-collaboration.md`
- `plan/phase-4-visibility-and-isolation.md`

### `daily/`
用于记录每日工作日志、当天进展、开发计划、执行情况、问题、决策和下一步安排。

建议内容：
- 今日开发计划
- 今日实际完成内容
- 当前进度
- 修改了哪些模块 / 文件
- 当前阻塞点
- 风险与临时决策
- 下一步计划
- 验证 / 测试情况

维护要求：
- 开始做当天开发前，先写当天计划
- 每完成一个关键步骤后，及时补充进度
- 遇到阻塞、改方案、改优先级时，必须更新 daily
- 一天结束前，补齐“完成情况 / 未完成 / 下一步”
- 后续正式改代码时，要把 daily 作为持续更新的开发日志，而不是事后总结

当前文件：
- `daily/2026-04-03.md`
- `daily/2026-04-04.md`

补充约定：
- 多天改造内容不要挤在同一个 daily 文档里
- 每一天单独一个 daily 文件
- 分步骤执行时，已完成项使用 `~~删除线~~` 标记