Beads 是一套面向项目的共享任务跟踪系统，通过 bd 命令行工具使用。它的核心定位是把项目工作记录为持久、可交接的状态：本地计划、草稿文件和个人记忆可以辅助执行，但不应作为项目工作的持久事实来源。
使用方式上，首先运行 bd prime；若没有输出，可用 bd where 检查仓库是否存在活跃的 Beads 工作区。在具备 shell 访问时，优先使用 bd CLI，因为它是更紧凑直接的接口。
主要命令流程包括：用 bd ready、bd list --status=open、bd list --status=in_progress 查找工作；用 bd show <id> 在修改前查看任务详情；用 bd update <id> --claim 原子认领任务；实现过程中发现新任务时，用 bd create 创建带标题、描述、类型和优先级的持久后续工作；任务完成后用 bd close <id> --reason="Completed" 关闭。
适合放入 Beads 的内容包括共享项目任务、阻塞项与依赖、新发现的后续工作，以及需要经受线程重置、上下文压缩或交接的工作状态，也就是其他人或其他智能体能够接着处理的状态。智能体本地规划工具只应用于当前回合的执行清单，不应视为共享项目状态。
规则方面：存在 Beads 时不要创建 Markdown TODO 文件作为事实来源；不要使用 bd edit，因为它会打开交互式编辑器，应使用 bd update 参数；程序化解析 bd 输出时优先使用 --json；若已安装钩子，bd prime 内容可能已自动注入，上下文缺失时可手动运行；工作未实际完成时，不要自动关闭或变更任务。