语言：British English (en-GB) | 简体中文 (zh-CN)
本目录包含 user-facing guides、内部设计记录、实现计划、验证记录和项目 tracking 入口。
- 使用指南 / Usage guide
- 设计概览 / Design overview
- 操作恢复 / Operator recovery
- 开发指南 / Development guide
- 真实 E2E 指南 / Live E2E guide
仓库根目录 README.md 是默认 en-GB 入口；对应中文版本是 README.zh-CN.md。
- design/ 包含 architecture 和 implementation design records，包括 Host Plugin Runtime And Generic Delivery。
- plans/ 包含 phased implementation 和 delivery plans。
- validation/ 包含 live validation harnesses、probes 和 evidence records。
这些内部记录不要求双语，除非后续被提升到 user-facing guide set。
- PROJECT_STATE.md 是简洁的 current-state 和 handoff 入口。
- PROJECT_TODO.md 是简洁的 cross-task backlog 入口。
- project_journal/ 包含按
YYYY/MM/*.md日期组织的 durable per-workstream records。 - 生成的
project_journal/INDEX.md是本地 ignored convenience output，不要提交。
本仓库只做 squash merge。Tracked journal docs 应描述 PR 落到 target branch 后的状态，而不是 PR review 期间的临时状态。
- 如果一个 PR 完整完成某个 workstream，merge 前把相关 journal entry 标成
status: completed，并用 PR link 作为 evidence。 - 不要在 tracked docs 中留下 "waiting for merge"、"not merged yet" 或 "ready for review" 这类临时状态；这些内容放在 PR body、checklist 或 comments。
- 如果一个 PR 只完成较大 workstream 的一部分，保持 journal 为
active或blocked，并记录真实剩余 next steps。