Wire Openspec Docs Sync

Archived: 2026-06-02 · roadmap-id: growth-trace-docs

Why

我们要让项目的"成长轨迹"清晰明确：OpenSpec changes 是 Single Source of Truth，但它对人和外部 LLM 不友好。需要把归档的 changes 与人拥有的 roadmap 投影到 apps/docs，形成可读的演化历史与 changelog，并产出 llms.txt/llms-full.txt 落地 GEO 的可理解性基础。这是 ADR/Intent 作为"真正资产"的载体。

Capabilities

New Capabilities

• openspec-docs-sync: packages/openspec-docs-sync 同步引擎 + llms.txt/llms-full.txt 生成。
• docs-growth-pages: apps/docs 的 roadmap 页与 changelog 页（从 roadmap.yaml 与 changes 投影）。

Modified Capabilities

• （无；apps/docs 由 ① 建立定位，此处新增页面与数据源）

Non-goals

• 不实现 Fumadocs MCP Server（对外可发现性/即时可得，需有外部受众，押后）。
• 不实现 Skills 系统及其文档投影（独立、押后）。
• 不做对外 GEO 推广（先内部）。
• 不实现 change frontmatter 的 ai_context 全套写作规范工具链，MVP 仅做基础字段投影。
• 不双语全量维护 docs（英文优先，中文占位）。