Files
soft_quay/docs/clean-state-checklist.md
ilaandClaude Fable 5 0184595ccc
Harness governance / validate (push) Has been cancelled
Add harness coding docs for SoftBox (Go + Gio dual-build)
Initialize the full harness coding document set from the
harness_coding_docs template, customized for the SoftBox project:

- Vision, requirements, tech stack (modern Go 1.25 + Gio v0.10.1;
  Win7 legacy Go 1.20.14 + Gio v0.6.0), architecture, coding rules
- Protocol contracts (signed catalog, package protocol v1, Ed25519
  license, events, CLI) and Gio view structure
- Roadmap Phase 0-6 with 20 suggested tasks; T-001 (monorepo
  skeleton) filed and ready to claim
- Agent entry points (AGENTS.md, docs/00-ai-start-here.md),
  context manifest, governance scripts and tests
- Merge Go gitignore with harness rules; keep go.work tracked

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-16 14:33:54 +08:00

1.6 KiB

干净收尾检查清单

每轮会话结束前逐项过一遍,确保仓库处于"下一轮无需人工修复即可直接开工"的状态。 这是把"提前宣告完成"挡在门外的最后一道关卡,配合 05-coding-rules.md 的验证清单使用。

收尾前确认:

  • 标准启动路径仍可用(./init.sh 或本项目等价命令能跑通)。
  • 标准验证 / smoke 仍可运行,结果如实。
  • 本轮执行记录已写进当前任务文件(docs/tasks/T-<编号>.md)的 ## 执行记录(含跑过的命令和结果作为证据)。
  • 任务文件 frontmatter 的 status 真实反映 DONE 与未验证的边界,没有"假 DONE"。
  • current-state.md 的项目级快照与现实一致(启动/验证路径、目录要点、blocker)。
  • 没有半成品改动处于未记录状态;如有,已写明 BLOCKED / PARTIAL 和原因。
  • 代码处于可安全恢复的状态(必要时已提交,提交信息清晰)。
  • 本轮实际修改没有超出任务 write_paths,也没有与其他活跃任务发生路径重叠。
  • 启用 Gitea 时,Issue 的唯一 status/*、claim / 工作分支、PR 和任务状态彼此一致;未完成任务没有误删 claim。
  • 已运行 python scripts/validate_harness_governance.py;启用且可连接 Gitea 时,还运行了只读 python scripts/audit_gitea_coordination.py --repo 【owner/repo】 --dispatcher 【Gitea登录名】。

任意一项不满足,就先补到满足,再结束会话。