English — A platform-agnostic method for cross-agent / cross-platform project context handoff. Keep one living BRIEF as the single entry point, paired with a three-piece toolkit (contract header + relay pointer + resume protocol), so any AI agent on any platform can pick up exactly where the last one left off — zero-cost onboarding, zero context loss.
中文 — 用一份持续演进的「项目简报（BRIEF）」作为唯一入口，配合「契约头 + 接力棒 + 恢复协议」三件套，让任何 AI Agent 平台都能零成本接手、跨平台可迁移、项目上下文不丢失。
Keywords: context management · agent handoff · cross-platform · LLM workflow · prompt methodology · knowledge management · AI agent collaboration · project brief
BRF 是一套领域无关、平台无关的项目上下文接力方法。它解决一个越来越普遍的问题：
当同一个项目在多个 AI Agent、多个平台、多轮会话之间流转时，上下文如何不丢失、不重复、不冲突？
它不绑定任何 IDE 或 Agent 平台，只用纯 Markdown + HTML 注释实现，因此可以被任意工具读取、被任意团队套用、被开源社区共同迭代。
适用场景：咨询、写作、研发、运营——一切需要多文件协作与状态跟踪的项目。
- 可迁移性第一约束：纯 Markdown + HTML 注释，不依赖任何平台的特有能力。把整个文件夹拷到 WorkBuddy / Trae / Qoderwork 等任意平台，新 Agent 读 BRIEF 顶部的契约头即可接手。
- 活的演进引擎：BRIEF 既是接手入口，也是随项目生长的演进引擎——它不是静态的
AGENTS.md，而是会随项目一起更新的活系统。 - 中断安全：靠「会话恢复协议 + 增量落盘」，最坏情况只丢失一个正在执行的步骤，不会整体失忆。
| # | 功能 | 作用 |
|---|---|---|
| 1 | @context 契约头 | 接力的"握把"——声明文件角色、上下游依赖、更新时机 |
| 2 | 接力棒（downstream 字段） | 显式声明"改完这一步，下一步该动谁"，像接力棒一棒交一棒 |
| 3 | 会话恢复协议 | 跨会话 / 跨平台接手的保险，新 Agent 第一步就能对齐状态 |
| 4 | 增量落盘 | 每步即落盘，上下文随项目生长，不依赖"中断自动同步" |
| 5 | 开箱模板 | 中 / 英文 starter，复制即用，含 BRIEF / current / standards 三件套 |
# 方式一：直接复制开箱模板到你的项目根目录
# 从本仓库 template/ 目录取 BRIEF.md / current.md / standards.md 三个 starter 文件
# 放到你的项目根目录与 project-context/ 下即可
# 方式二：克隆后提取模板
git clone https://github.com/RyanYang25/brief-relay-framework.git
# 进入 template/ 目录，复制所需 starter 到你的项目然后按 BRIEF.md 顶部的「更新 SOP」填写你的项目背景，开始使用。
BRIEF.md 顶部的 @context-root 契约头是接力的起点：
<!-- @context-root
role: 项目唯一入口 + 演进引擎
produced_by: 更新 SOP（自动/手动触发）
consumed_by: 所有 Agent 与人类接手者，每次会话开头必读
update_trigger: 任何状态/决策/文件结构变更后
upstream: context/current.md（活跃状态）、context/standards.md（约束）
downstream: context/current.md → context/standards.md → references/
-->每个上下文文件（current.md / standards.md）也都带有 @context 契约头，新 Agent 一"摸"就知道自己该看什么、改什么、改完下一步动谁。
本仓库为方法论开源包，目录如下：
brief-relay-framework/
├── README.md ← 本文件（中文门面）
├── README.en.md ← English README
├── LICENSE ← MIT License
├── CONTRIBUTING.md ← 贡献指南
├── 简报接力.md ← 方法规范（中文，当前版）
├── Brief-Relay-Framework.md ← Method Spec (English, current)
└── template/ ← 开箱模板（中 / 英文 starter）
├── BRIEF.md
├── context/current.md
├── context/standards.md
└── en/ ← 英文 starter
- 方法规范（中文 · 当前版）：简报接力.md
- Method Spec (English · current)：Brief-Relay-Framework.md
- 历史版本：通过 git tag / GitHub Releases 获取 v1.0 等早期版本快照
- 开箱模板：template/
- 贡献指南：CONTRIBUTING.md
MIT License —— 自由使用、修改、分发，只需保留版权声明。
欢迎提交 Issue 与 Pull Request，共同完善这套跨平台上下文接力标准。详见 CONTRIBUTING.md。
BRIEF Relay Framework · 让项目上下文在任何 Agent 之间稳稳接力 🤝