用途：ctx-progress 是一份「活的工作真相」文档，回答项目做到哪、下一步是什么、新会话应先读什么，供全新会话恢复。产品事实（做什么、为什么）归 spec/ 与 decisions/，progress/ 只管推进状态，并以指针方式引用，不复述产品事实。
主要能力：维护唯一进度根 ctx/progress/；记录有序的 T### 任务列表及每项状态（done/active/blocked），每项回链 spec/ 中的 REQ-###；同一回合内把已决定的工作状态写入磁盘；每个工作单元完成后提交、更新进度、过长时归档；带 frontmatter（title、created、updated、status）与状态取值 draft/active/stale/archived；父节点只保留一行摘要与链接，不复制子节点内容。
使用方式：默认先用单文件 ctx/progress/progress.md；超过约 150 行再升级为树（README.md 加 NN-<slug>.md 子文件），任何单节点超过约 200 行则归档已完成部分。恢复会话时按序读取 CLAUDE.md、进度根、活动节点及其链接文件（约 3 个），先向用户总结目标/当前位置/下一步并等待确认，不要先开工。重置或压缩上下文前，先把本会话已决定状态落入 progress/。
适用场景：需要跨会话接续的开发项目、需要明确「先读什么」的接手场景。
限制：进度只作指针，不得复述产品事实；每棵活跃子会话子树恰好一个活动节点；不得把进度文件放进 .claude/ 等配置目录；日期用绝对 ISO 格式；归档是移动而非删除、不重写历史。文中涉及的 /ctx-compact 为可选的 Claude Code 便捷命令，机制本身与工具无关；其余工具支持情况暂未提供。