# Agent 长期记忆目录

> 目的：避免“换 Agent / 重启会话后失忆”，把关键事实沉淀为仓库文档。

## 文件说明

- `project-context.md`：项目现状、硬约束、当前优先级。
- `decision-log.md`：关键技术决策与原因（按日期追加）。
- `open-issues.md`：未完成项、阻塞项、下一步动作。
- `regression-checklist.md`：高风险功能回归清单（通过/失败状态）。

## 使用规则（强制）

1. 每轮任务开始前：先读上述 4 个文件。
2. 每轮任务结束后：至少更新 `decision-log.md` 与 `open-issues.md`。
3. 声称“已修复/已完成”前：更新 `regression-checklist.md` 的验证结果。
4. 长期事实只认本目录，不依赖临时 Agent 会话记忆。

## 容量上限（强制）

- `project-context.md`：不超过 220 行。
- `decision-log.md`：不超过 150 条决策或 24KB。
- `open-issues.md`：不超过 120 行。
- `regression-checklist.md`：不超过 220 行。
- 本目录总大小建议不超过 180KB（不含 `archive/`）。

超过上限时，先执行“压缩+归档”再继续新任务。

## 归档规则

- 归档目录：`docs/agent-memory/archive/`
- 归档命名：
  - `decision-log-YYYY-MM.md`
  - `open-issues-YYYY-MM.md`
  - `regression-checklist-YYYY-MM.md`
- 当前文件顶部需保留：
  - 最新摘要（3~10 行）
  - 最近归档文件路径（便于追溯）

## 记录格式建议

- 日期：`YYYY-MM-DD`
- 状态：`待处理 / 处理中 / 已完成 / 阻塞`
- 每条记录尽量包含：问题、动作、证据（命令或文件路径）