# 圆心商业化工作流（YxStack）变更记录

## v0.2.1 (2026-05-03)

### 新增
- **Confusion Protocol**：8 条命令统一引入假设暴露机制——关键事实缺证据时停止推理，转为追问
- **假设验证路径**：每个 active 假设必须附带可证伪的验证标准（一句话）
- **假设上限**：同时 active 假设 ≤ 5 条，超过必须先标记旧假设为 outdated
- **项目边界显式声明**：CWD 即 YxStack 项目根，不搜索父目录
- **前置摘要恢复**：pos.md 回溯 pfit 结论，uj.md 回溯 pfit + pos 结论
- `_timeline.jsonl` 新增 `conflict` 可选字段
- `templates/state_template.md` 增加验证标准列 + 假设状态取值规范

### 设计参考
- 对比 gstack（YC Garry Tan）的设计模式，基于上下文设计显式适配调整版：
  - gstack 用 Confusion Protocol + 跨模型验证 → YxStack 用 Confusion Protocol + 假设验证路径 + 上限
  - gstack 用 CWD 隐含边界 + /freeze 目录锁 → YxStack 用 CWD 显式声明
  - gstack 用 checkpoint.md + timeline.jsonl 双轨 → YxStack 沿用 _state.md + _timeline.jsonl
  - gstack 的 /context-restore 用 Summary + Remaining → YxStack 新增「前置指令摘要」

### 路线图同步
- v0.2.0 5 项 checklist 标记为已完成
- v0.2.1 新立项填补 v0.1.0 遗留缺口

## v0.2.0 (2026-05-03)

### 新增
- **多轮对话状态保持**：跨会话上下文记忆，产出递进而非重复
- `_state.md`（`.yxstack/` 下）：项目级状态快照，记录当前阶段、关键假设、决策链
- `_timeline.jsonl`（`.yxstack/` 下）：append-only 事件日志，作为事实来源，不可变
- 每条命令增加「第 0 步：加载项目状态」，执行前读取 `_state.md`
- 每条命令增加「更新项目状态」，执行后更新 `_state.md` + 追加 `_timeline.jsonl`
- `install.sh` 注入会话状态恢复逻辑：会话开始时自动读取 `_state.md`，给出欢迎摘要
- `templates/state_template.md`：模板与阶段流转参考

### 设计参考
- 借鉴 gstack 的 Context Recovery + append-only JSONL 模式
- 保留 YxStack 的 YAML frontmatter + Markdown 风格

### 路线图调整
- v0.2.0 改为「多轮对话状态保持」（原「指令深度增强」后移）
- v1.0.0 精简为「完整评测体系」（移除使用数据追踪）

## v0.1.2 (2026-05-03)

### 新增
- **自动升级**：Agent 会话启动时自动检查远端版本，有更新主动提醒
- `VERSION` 文件，记录当前版本号，作为升级对比基准

### 变更
- `install.sh` 安装/升级合二为一，跑两次效果相同

## v0.1.1 (2026-05-03)

### 新增
- **一行安装**：`install.sh` 脚本，自动克隆 + 配置 CODEBUDDY.md
- 智能检测：已配置过自动跳过，新用户自动创建配置文件
- README 简化为一行命令安装，降低新人上手门槛

## v0.1.0 (2026-05-03)

### 新增
- **知识沉淀机制**：每条指令执行完自动存档到 `.yxstack/`
- **回溯历史**：每条指令新增「第 0 步」——执行前先读项目历史记录
- **跨项目隔离**：不同项目的 `.yxstack/` 互不串读
- 存档格式：YAML frontmatter + 报告正文
- ROADMAP 加入 v0.1~v1.0 完整知识沉淀路线

### 变更
- 所有路径改为项目根目录相对路径（`.yxstack/`），不绑定特定项目结构
- README 新增知识沉淀机制说明

## v0.0.1 (2026-05-03)

### 新增
- 核心框架：README + 8 条命令执行模板
- 命令模板含 `核心追问清单 + 输出结构 + 常见误区`
- 全局 CODEBUDDY.md 集成机制
- ROADMAP 路线图
- MIT 开源协议

### 命令清单
| 指令 | 文件 |
|------|------|
| /pfit | commands/pfit.md |
| /pos | commands/pos.md |
| /uj | commands/uj.md |
| /prd | commands/prd.md |
| /money | commands/money.md |
| /gtm | commands/gtm.md |
| /metric | commands/metric.md |
| /comp | commands/comp.md |

### 维护方
- 筑基阁（开阳星）· 天机阁