skelet/docs/adoption-checklist.md

已有项目接入 / 恢复清单

本项目当前是空目录起步，已完成 harness 文档初始化。本文用于两种情况：后续已经有 Wagtail 代码后恢复上下文，或把本项目文档接入到另一个已有代码库。

适用场景

• 已经初始化 Wagtail，但下一轮 agent 不清楚真实启动命令。
• 文档、代码和当前可运行状态出现偏差。
• 想把 Skelet 的 harness 文档迁移到另一个骨架介绍网站项目。

最小接入文件

文件	作用
AGENTS.md	仓库级 agent 入口和总规则。
CLAUDE.md	Claude Code 薄入口，指向 AGENTS.md。
docs/00-ai-start-here.md	每轮开工流程。
docs/05-coding-rules.md	编码纪律和验证底线。
docs/06-tasks.md	任务看板。
docs/current-state.md	当前实现状态快照。
progress.md	只追加的执行流水。
init.sh 或 init.ps1	标准启动与验证入口，按操作系统二选一。

当前项目恢复步骤

1. 确认仓库根目录是 D:\OPC\skelet。
2. 读取 AGENTS.md、docs/00-ai-start-here.md、docs/current-state.md。
3. 查看 docs/06-tasks.md，领取第一个 TODO 且依赖均为 DONE 的任务。
4. 如果生产代码尚未初始化，先做 T-001，不要提前实现业务页面。
5. 初始化 Wagtail 后，立刻更新 init.ps1、init.sh、docs/03-tech-stack.md、docs/current-state.md 中的真实命令。
6. 运行标准验证，把结果追加到 progress.md。
7. 如果验证失败，第一轮任务应先修基线，不做新功能。

代码现实与文档冲突时

• 以当前可运行代码和真实验证结果为事实起点。
• 文档描述旧功能但代码不存在时，先把差异记录到 current-state.md，不要直接补实现。
• 代码已有行为但文档没写时，先补 02-requirements.md、04-architecture.md、api.md 或 routes.md，再继续修改代码。
• 命令不可运行时，不要标记任务完成；在 progress.md 记录失败命令和错误摘要。

不建议做的事

• 不要一次性实现首页、模型、筛选、SEO 和部署。
• 不要把聊天记录当事实来源。
• 不要为了让验证通过而降低测试或验收标准。
• 不要在接入 harness 的同一轮顺手重构无关代码。