指南

愿景

愿景是驱动方向的层。人类定义项目的走向——设定目标、里程碑和优先级。AI 在 adapt 阶段引用愿景来分析差距并提出下一个目标，但愿景属于人类。

结构

text

.reap/vision/
  goals.md              # North star objectives and milestones
  docs/                 # Planning documents, specs, design notes
  memory/               # AI memory (3-tier)
    longterm.md          #   Project lifetime — lessons, decision rationale
    midterm.md           #   Multi-generation — ongoing plans, agreed directions
    shortterm.md         #   1-2 sessions — next session handoff, immediate context

目标

goals.md 以清单形式包含项目的长期目标。在 adapt 阶段，AI 分析愿景与当前状态之间的差距来建议下一个 Generation 的目标。已完成的目标会自动被勾选。

markdown

# Vision Goals

## Ultimate Goal
Build a self-evolving development pipeline.

## Goal Items
- [x] Core lifecycle implementation
- [x] Merge lifecycle
- [ ] README rewrite for v0.16
- [ ] External project validation

记忆

记忆是一个自由形式的记录系统，AI 在其中跨会话和 Generation 持久化上下文。与 genome（有修改限制）或 lineage（会被压缩）不同，记忆始终可访问且可自由写入。

层级	作用	判断标准
Shortterm	会话交接——传递给下一次会话的上下文	「现在就需要吗？」
Midterm	进行中的轨道——跨多代的工作	「是尚未完成的大块工作吗？」
Longterm	设计经验——值得日后回读	「能避免重犯同样的错误吗？」

何时更新

Reflect 阶段 — 更新记忆的自然时机（shortterm 每个 Generation 必须更新）
任何时候 — 如果出现有用的上下文，可以在任何阶段更新记忆
Shortterm 清理 — 清除已处理的项目

不要写入记忆的内容

代码更改细节——属于 environment
测试数量或构建状态——属于 artifact
已在 genome 中的原则——禁止重复

差距驱动的进化

在 Completion 的 adapt 阶段，AI：

读取 goals.md 并扫描积压
识别未完成的目标和待处理的任务
与当前项目状态交叉引用
基于最有影响力的差距建议下一个 Generation 的目标