Project Memory

在项目根的 ./tmp/ 下维护一份过程性记忆：项目记忆、研究讲解、脚本、实验记录、实验结果、当前状态与后续方向。

它不是项目文档，也不是随时可清的临时目录：./docs/ 是给项目读者的结论，./tmp/ 是产生这些结论的过程——失败的、没定论的、以及“当初为什么放弃”的记录都在这里。

核心规则

过程进 ./tmp/，结论进 ./docs/。 毕业时在 STATE.md 记一笔，说明从哪来、到哪去。
实验定义与运行产物分开。 定义在 experiments/（小、稳定、人读），产物在 outputs/（多、只增、程序写）。
捕获便宜，沉淀才排版。 日常只追加 journal/ 一行；值得长期查阅才升级到 docs/（门槛见下）。
产物不覆盖。 每次运行写独立目录，outputs/ 内部结构由程序决定。
两个入口。 看现状读 ./tmp/STATE.md，找文档看 ./tmp/docs/index.md；不必通读整个 ./tmp/。
移动是常态，删除是例外。 退役内容进 archive/，scratch/ 随时可删；不做批量删除，真删只限范围具体、依据清楚的可重建产物（如 outputs/ 单个过期实验，在实验 README.md「运行记录」留一行）。
初始化是惰性的。 只读不建；第一次写入才落 .gitignore、README.md、STATE.md（有 Python 时加 scripts/ 工具集），其余目录用到再建。
多 agent 只动自己的地盘。 并行才开 agents/：BOARD.md 认领即锁，进展写自己的子目录，收尾才写回全局。
远程是原料。 增量只进 remote/，再反向更新 STATE.md / docs/ / 实验；cursor.json 与 docs/index.md 是仅有的两处覆盖写。