用途：把文档中的 bd（beads）命令与描述迁移为 br（beads_rust），适用于更新 AGENTS.md、批量迁移多文件或校验已有迁移是否完整。
主要能力：提供有序的机械式转换流程。先改章节标题 bd (beads) 为 br (beads_rust)，在 beads 章节标题后加入非侵入性说明；把 ready/list/show/create/update/close/dep/stats 等命令由 bd X 改为 br X；将 bd sync 改为 br sync --flush-only，并在每次 sync 后补上 git add .beads/ 与 git commit -m "sync beads"；把 bd-### 形式的 issue ID 改为 br-###（含 thread_ids、subjects、reasons、commits）；若有 beads_viewer 链接则改为 beads_rust。需删除的内容包括 daemon 引用、auto-commit 假设、hook 安装说明与 RPC 模式。保持不变的有 SQLite/WAL 注意事项、bv 集成、优先级 P0-P4、issue 类型、依赖追踪与 .beads/ 为权威来源。
使用方式：对单文件按上述顺序应用转换，再用 ./scripts/verify-migration.sh file.md 验证；多文件少于 10 个可顺序处理，10 个以上用并行子代理，每批约 10 个文件；校验已有迁移可运行 ./scripts/find-bd-refs.sh /path，有输出即表示未完成。快速检查命令：grep -c '`bd ' file.md、grep -c 'bd sync' file.md 应返回 0，grep -c 'br sync --flush-only' file.md 应大于 0。
适用场景：需要确保迁移完整、避免代理按过时的 bd sync 指令操作导致丢失工作。
限制：这是低自由度的确定性转换，每个输入只有一个正确输出，不应做额外改进或风格改动；必须先改 sync 再补 git 步骤，顺序不可颠倒；每次修改后必须验证，验证不通过就回到修正步骤。资料未提供 bd 与 br 的安装方式、版本要求、收费信息或运行环境细节。