milestone 用于创建或维护里程碑——一个有边界的阶段地图，规定本阶段要通过多个 pragma 周期建立哪些不变式束（invariant bundle）。它是学习/控制点，不是交付批次。里程碑回答：本阶段建立哪些不变式，跨过该阈值后解锁什么加速。不变式的措辞权威仍在 capsule 文档。
用途：当路线图方向需拆解为有边界的多切片活动；多个 pragma 周期需围绕阶段级结果协调；需跟踪迁移状态、遗留面或切换就绪度；需判断项目是否已可进入 pragma 加速时使用。不适用：定义单个薄切片用 /pragma:card；需要共享词汇与不变式用 /pragma:capsule；方向本身不清晰用 /pragma:roadmap。
使用方式：模式为 create（据路线图定义新里程碑）、update（切片落地、假设变化或阶段状态变动后修订）、review（评估里程碑健康度与推进/完成就绪度）。默认文件 docs/milestone.md，完成后移入 docs/milestones/[name].md，同时只应有一个活动里程碑。文档含 16 节：结果、为何现在、要建立的不变式束、Ready for Pragma 双段门禁、范围内、本阶段后推迟、权威 capsule、入口假设、退出标准、候选序列、阶段状态、阶段稳定性边界、阶段风险、开放设计问题、活动遗留面（可选）、评审触发条件。
规则与限制：不变式束条目是标签加引用，不复制法律文本；只有创建 pre-capsule 里程碑时才允许标 not yet formalized，update/review 中仍如此标记的束须先转 /pragma:capsule。候选序列最多 6 项，超限说明里程碑过宽；候选不直接授权编码，必须先成为 card，再进入 slice，不允许里程碑直接跳到切片。推迟是临时的，永久非目标归 capsule。退出标准是阶段级，切片定义完成在各 card 中。一个里程碑同一时间只能激活一个。事实不足处均以资料为限，未提供的价格、平台与效果暂未提供。