hplan — 分层持久化计划管理
用文件系统作为持久化工作记忆。overview.md 保持精简(≤25行),详细规格按阶段拆分到独立目录中。
核心原则
上下文窗口 = RAM(易失、有限)
文件系统 = 磁盘(持久、无限)
→ 重要信息必须写入磁盘
→ 被 hook 注入的内容必须精简
→ 被深度参考的内容必须详尽
→ 二者分离,互不冲突
如果感觉上下文缺失,主动读取 .plan/ 下的相关文件即可。所有计划信息都持久化在磁盘文件中,不会因上下文变化而丢失。
目录结构
所有计划文件存放在项目根目录的 .plan/ 目录下:
.plan/
├── overview.md ← 全局摘要(精简,被 hook 反复注入)
├── decisions.md ← 所有决策记录
├── errors.md ← 所有错误记录
└── phases/
├── phase1_xxx/
│ ├── spec.md ← 该阶
[Description truncada. Veja o README completo no GitHub.]