用途：autoresearch 用于约束自动研究（autoresearch）会话中的实验循环，让每次迭代可追溯、可复现、可回滚。
主要能力：以文件保存会话状态，包括 .autoresearch/current（当前会话 id）、.autoresearch/sessions/<session-id>/state.md（配置、规则、范围）、benchmark.sh（基准测试包装脚本）、run.jsonl（追加式运行日志），以及 research/learnings/<session-id>.md（可提交的学习记录）。所有工作在 autoresearch/* 分支进行，.autoresearch/** 属于进行中的运行时状态，不应提交。
使用方式：每次迭代依次执行假设（单一改动、明确理由与预期影响）、实现（最小 diff，只改范围内文件）、基准测试（bash "$SESSION_DIR/benchmark.sh"）、决策、记录（追加 JSONL，提交或回滚）、汇报。指标提升则提交并带 Result: 尾注，JSONL 记 keep；指标回退或不变则回滚并记 discard；基准崩溃或超时则回滚并记 crash。提交格式为 experiment: <描述> 加理由与 Result 行。JSONL 每行含 run、commit、metrics、status、description、timestamp。上下文重置后读取 current、state.md 和 run.jsonl 最后 20 行即可恢复。
适用场景：需要反复做单变量实验并跟踪基准指标的研究或优化任务。
限制与反模式：禁止一次改两处、禁止忽略回退、禁止跳过基准测试、禁止中途修改 benchmark.sh、禁止提交运行时状态、禁止使用 git add . 或整树 checkout/reset、禁止大 diff（建议 50 行以内）、连续 3 次实验被丢弃应停下重新评估。保留策略为热/温/冷三级，冷会话默认不读，除非用户要求或显式 Extends。每 5 次运行汇报总运行数、保留/丢弃/崩溃数、最佳指标及累计改进。