Aether 是协同智能的介质：承载人、Entity、代码与上下文共存的原生环境。本目录承载全部架构规划与开发治理文档。
| 文档 | 摘要 | 阅读顺序 |
|---|---|---|
| terminology.md | 品牌术语体系与命名守则 | 1 |
| design/yohaku.md | Yohaku 视觉设计约束（十戒律 / 色彩 / 字体 / 尺度 / tokens，与官方源码对齐） | 2 |
| features/feature-brainstorm.md | Phase 1：42 项功能头脑风暴与优先级矩阵 | 3 |
| roadmap/monorepo-structure.md | Turborepo 目录结构与包职责 | 4 |
| roadmap/tech-decisions.md | 技术选型决策表与弃用信号 | 5 |
| roadmap/data-model.md | 核心数据模型与隔离策略草案 | 6 |
| roadmap/milestones.md | M0–M3 里程碑与任务清单 | 7 |
| roadmap/risks.md | 关键技术风险、监控指标与降级方案 | 8 |
| roadmap/probes/yjs-serverless.md | Yjs Serverless 持久化与连接管理技术探测报告 | 9 |
| roadmap/team-norms.md | 团队协作规范与检查清单 | 10 |
| specs/m35-web-ui-foundation.md | M3.5 Web UI 基础层规范 | 11 |
| specs/m35-plan.md | M3.5 实施计划 | 12 |
| specs/m36-audit-vault.md | M3.6 Audit Vault 规范 | 13 |
| specs/m36-plan.md | M3.6 实施计划 | 14 |
| specs/m37-manifestation-binding.md | M3.7 Manifestation Binding 规范 | 15 |
| specs/m38-entitlement-engine.md | M3.8 Entitlement Engine 规范 | 16 |
| specs/m38-plan.md | M3.8 Entitlement Engine 实施计划 | 17 |
| specs/m39-session-actor.md | M3.9 会话主体解析规范 | 18 |
| specs/m310-membership-provisioning.md | M3.10 Membership 开通规范 | 19 |
| specs/m311-invitation-mail-backfill.md | M3.11 邀请邮件与 Realm organization 回填规范 | 20 |
| specs/m312-membership-ui.md | M3.12 邀请 / 成员管理 UI 与 membership 授权收口 | 21 |
| specs/m313-audit-export.md | M3.13 Audit Vault 导出规范 | 22 |
| specs/m314-sso-oidc.md | M3.14 SSO（OIDC）接入与登录 UI 规范 | 23 |
| specs/m314-plan.md | M3.14 实施计划 | 24 |
| specs/m315-scim-provisioning.md | M3.15 SCIM 2.0 Provisioning 端点规范 | 25 |
| specs/m315-plan.md | M3.15 实施计划 | 26 |
| specs/m316-resonance-gateway.md | M3.16 Resonance Gateway 公开 API 规范 | 27 |
| specs/m316-plan.md | M3.16 实施计划 | 28 |
| specs/m317-webhook-constellation.md | M3.17 Webhook Constellation 出站事件订阅规范 | 29 |
| specs/m317-plan.md | M3.17 实施计划 | 30 |
| specs/m318-internal-api-first.md | M3.18 内部功能 API 化改造（API-First 兑现）规范 | 31 |
| specs/m318-plan.md | M3.18 实施计划 | 32 |
| specs/m319-oauth-app-registry.md | M3.19 OAuth App Registry 规范 | 33 |
| specs/m319-plan.md | M3.19 实施计划 | 34 |
| specs/m320-realm-isolation-verification.md | M3.20 Realm Isolation 生产级验证规范 | 35 |
| specs/m320-plan.md | M3.20 实施计划 | 36 |
| specs/m321-webhook-realm-isolation-e2e.md | M3.21 Webhook 投递跨 Realm 隔离端到端验证规范 | 37 |
| specs/m321-plan.md | M3.21 实施计划 | 38 |
| specs/m322-converge-telemetry.md | M3.22 Converge Telemetry 采集上线规范 | 39 |
| specs/m322-plan.md | M3.22 实施计划 | 40 |
| deployment.md | 部署指南（Vercel + Cloudflare Workers Durable Objects） | — |
- 先读 terminology.md，建立 Aether 术语心智模型。
- 再读 design/yohaku.md，掌握全部 UI 输出的视觉约束。
- 读 features/feature-brainstorm.md，理解产品边界与差异化主张。
- 沿 roadmap 章节按序阅读工程落地内容，roadmap 文档之间存在前置依赖，请勿跳读。
| Aether 术语 | 技术映射 |
|---|---|
| Realm | Better-Auth Organization + Drizzle Schema 隔离边界 |
| Current | Yjs Provider 连接实例 + Presence 状态流 |
| Entity | 拥有 Better-Auth Identity、Yjs Cursor、Drizzle Audit Log 的一等公民 |
| Thread | 绑定文件范围 / 代码片段 / Manifestation URL / 对话历史的叙事单元 |
| Converge | Yjs CRDT 无冲突合并操作，强调自然汇聚 |
| Drift | Yjs IndexedDB 持久化 + Drizzle 本地缓存状态 |
| Manifestation | Vercel Preview Deployment 作为可协同标注的对象 |
| Resonance | 通过公开 API 实现的扩展，与核心共鸣而非外挂 |
- 本目录全部文档使用简体中文，技术标识符遵循术语守则。
- 文档变更随对应代码 PR 一并评审，禁止文档与实现脱节超过一个里程碑周期。
- 术语表以 terminology.md 为唯一事实源，代码 schema 与文档双源校验。