Files
soft_quay_web/docs/clean-state-checklist.md
ilaandClaude Fable 5 a89821a571 Initialize harness coding docs from design spec
Split docs/softbox-catalog-design.md into the numbered harness doc set
(00-06, api.md, current-state, agent-context, tasks) following the
harness_coding_docs template and soft_quay conventions. Register the
nine open decision items from the design spec into the 06-tasks
roadmap as W- tasks and backlog entries. Keep the original design
spec as an archived design input with a header note.

Recreated after the repository's previous git history was lost to an
external reset; content matches the original initial commit.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-20 00:43:58 +08:00

20 lines
1.4 KiB
Markdown

# 干净收尾检查清单
> 每轮会话结束前逐项过一遍,确保仓库处于"下一轮无需人工修复即可直接开工"的状态。
> 这是把"提前宣告完成"挡在门外的最后一道关卡,配合 [`05-coding-rules.md`](05-coding-rules.md) 的验证清单使用。
收尾前确认:
- [ ] 标准启动路径仍可用(`./init.sh` 或本项目等价命令能跑通;W-001 前占位失败属预期,需如实说明)。
- [ ] 标准验证 / corpus + Schema 回归(W-002 后)仍可运行,结果如实。
- [ ] 本轮执行记录已写进当前任务文件(`docs/tasks/W-<编号>.md`)的 `## 执行记录`(含跑过的命令和结果作为证据)。
- [ ] 任务文件 frontmatter 的 `status` 真实反映 `DONE` 与未验证的边界,没有"假 DONE"。
- [ ] [`current-state.md`](current-state.md) 的项目级快照与现实一致(启动/验证路径、目录要点、blocker)。
- [ ] 没有半成品改动处于未记录状态;如有,已写明 `BLOCKED` / `PARTIAL` 和原因。
- [ ] 代码处于可安全恢复的状态(必要时已提交,提交信息清晰、带 `W-<编号>`)。
- [ ] 本轮实际修改没有超出任务 `write_paths`。
- [ ] 仓库内没有出现私钥材料、云凭据或真实生产 URL;测试数据只用测试密钥对。
- [ ] 涉及上下文清单变化时,已运行 `python3 scripts/validate_agent_context.py`。
任意一项不满足,就先补到满足,再结束会话。