Rive 是本地优先 agent team runtime 的体系文档。
- Agent 协作协议
- Rust CLI 实现阶段与 AgentFS 策略
- Phase 1 Snapshot Evidence 测试计划
- Phase 2 Fact Ledger 设计
- Phase 2 Fact Ledger 测试计划
- Phase 3 Dispatch Ledger 设计
- Phase 3 Dispatch Ledger 测试计划
- Phase 4 Agent CLI Debug Trace 设计
- Phase 4 Debug Trace 测试计划
- Phase 5 OpenCode Runner 设计
- Phase 5 OpenCode Runner 测试计划
- Phase 6 Codex Runner 设计
- Phase 6 Codex Runner 测试计划
- Phase 7 Agent-to-Agent Delegation 设计
- Phase 7 Agent-to-Agent Delegation 测试计划
- Phase 8 Work DAG / Dispatch Binding 设计
- Phase 8 Work DAG / Dispatch Binding 测试计划
- Phase 9 OpenCode Orchestrator Control 设计
- Phase 9 OpenCode Orchestrator Control 测试计划
- Phase 10 Orchestrator Sandbox / Graph Hygiene / Usage 设计
- Phase 10 Orchestrator Sandbox / Graph Hygiene / Usage 测试计划
- Phase 11 Work DAG Scheduler 设计
- Phase 11 Work DAG Scheduler 测试计划
- Phase 12 Git worktree Workspace Branch / Ref Integration 设计
- Phase 12 Git worktree Workspace Branch / Ref Integration 测试计划
- Phase 13 Reusable Workflow Template 计划
Rive 当前已经不只是协议文档，而是可本地 dogfood 的多智能体 runtime：
- Work DAG：用
rive work .../team work ...建立可追踪的任务图、依赖、accept/reopen/retry 语义。 - Reusable workflow：
workflow.yaml + prompts/*.md可导入为 immutable template version，再用rive workflow run重复实例化和执行。 - Scheduler：
rive scheduler run/status/resume能按 DAG ready node 调度 worker pool，支持 retry/resume、失败分类和可观测 activity。 - Node-level runner policy：workflow node 可声明
runner: opencode|codex、worker、workspace_mode、acceptance_mode；同一个 scheduler run 内可以混合 OpenCode cheap worker 和 Codex judge/merge node。 - Worker workspace isolation：
--workspace-mode worktree让 worker patch 先进入隔离 worktree/ref，commit/accept 后才合入 parent workspace。 - Recovery UX：
rive scheduler resume --failed、rive work retry、rive branch conflict show/reject/retry-from-parent用 ledger 方式恢复失败和 patch conflict。 - Debug/usage：debug trace、stdout/stderr refs、scheduler activity、usage read model 都只做诊断，不参与成功判断。
核心边界：成功只来自 ledger/projection（Work DAG、dispatch、scheduler、workflow state），不能从 runner stdout、final answer 或 trace 推断。
- Rive agent skill — 给 Codex / OpenCode 等外部 agent 读取的 Rive 操作手册，用来把用户目标组织成 Work DAG、调度 worker、集成 worktree ref，并按 ledger/projection 回报结果。
Rive 启动 OpenCode / Codex worker 时不会假设自己来自交互式 shell，因此不要依赖 ~/.zshrc 一定会被加载。外部 provider key、证书路径等运行时变量可以放在：
~/.config/rive/runner.env<workspace>/.rive/runner.envRIVE_RUNNER_ENV_FILE=/path/to/env指定的文件
文件格式是简单的 KEY=value 或 export KEY=value。Rive 会在启动 runner child 前加载这些变量，然后再写入自己的 RIVE_* 协议变量和 PATH，避免 env 文件覆盖调度协议。
- Eino technical manual dogfood — 用 Rive Work DAG + OpenCode workers 阅读 CloudWeGo Eino 代码并产出技术手册的真实 dogfood 示例。
- Google ADK Go code-reading dogfood — 用 Rive Work DAG + OpenCode workers 粗读
google/adk-go，按目录分区产出中文架构大纲和总纲。 - Sentinel reusable workflow template — 可导入/复跑的生产 debug workflow 模板包，包含 DAG 和节点 prompt。