@@ -0,0 +1,42 @@
+# ADR-028：AI 目标规划师——建议制规划 + 体系深度联动
+
+> 状态：已接受（2026-09-02，随 v0.18.2 设计批准；实施于 v0.18.1 之后）
+> 关联：[v0.18.2 设计规格](../superpowers/specs/2026-09-02-v0.18.2-ai-goal-planning-design.md) · [ADR-027 目标层建模](./ADR-027-goal-layer-modeling.md)（本 ADR **局部修订**其 §决策 5 与所引"不做 AI 自动拆解里程碑"条款）· [v0.18 设计（[ ] 已归档）](../archive/2026-09-02/2026-09-02-v0.18-learning-goals-design.md) · REQ-251~254
+
+## 背景
+
+v0.18 目标层（M1）已交付纯规则设定/进度/判据（**零 AI**——M1/M2 零 AI 铁律保持）；v0.18 设计曾裁决"不做 AI 自动拆解里程碑（人类判断领地）"。2026-09-02 用户重裁决：目标层要接入 AI 规划，且规划内容需与知识体系层深度联动（含"AI 提供初步体系"）。用户采纳项：双入口、建议制确认落库、四项联动、默认关+授权确认。
+
+## 决策
+
+1. **规划师角色＝顾问，非执行者（建议制）**：AI 产出 `GoalPlanProposal`（里程碑草案/建议绑定组/体系建议/周契约建议/一句话说明）——全部草案，用户逐项确认/删改后**事务写入**；AI 失败/校验失败 → 回退 M1 规则草案（`suggest_milestones` 为永远可用的降级基线），目标创建/规划永不被 AI 阻断。
+2. **双入口同一协议**：访谈第 5 步「✨ 用 AI 规划」＋ 详情页「💡 AI 规划」（intent_json 现取现拼）；共用 `GoalPlanApprovalDialog` 确认流与协议校验（优化评审 #4 同哲学：双轨制是入口不是两套组件）。
+3. **体系联动＝只加引用通道**：`knowledge_links.target_type` 白名单 **+1（'goal'）**（TEXT 无 CHECK，命令层白名单与 group 先例同款，零迁移零破坏）；体系页「服务于目标 X」反标；**AI 初步体系**＝骨架建议（名称+核心问题+≥1 领域入口+初始概念 3-5 个），**门槛校验**（缺一即整条丢弃并诚实提示），确认后经既有体系命令逐项创建（一项一事务，骨架部分失败不污染目标层）。
+4. **概念弱项 M3 真实化**：目标绑定组→组卡→概念（跨 knowledge_links）的**低激活信号**（90 天无引用/未应用，concept_stale 判据理念）=规则信号现算；「最弱概念」块+AI 解读（可选）作为 `/goal` 与规划的输入。
+5. **预算与治理（硬约束延续）**：`budget_allocator` 档位化（轻量 4K/标准 10K/深度 30K，默认标准）+ 单次调用 ≤ 档位硬顶 + 超限按相关性截断且**诚实提示不静默**；content_gate 双闸门（目标 AI 开关默认关 + 授权弹窗）；token/成本入 ai_usage、提示词/回答入 ai_tasks.trajectory（AI 任务视图可见）；复用 v0.16 首次云端提示。
+6. **红线**：不接 agent 框架/记忆模块/自主规划/每日推送（维持）；AI 不直接执行任何写入；上传仅授权后的最小检索片段（L4.5 目标摘要现算 <1K token + L3 FTS top-K）。
+
+## 备选（否决）
+
+- **直接制（AI 建好后改）**：产出即落库——AI 输出质量不可完全契约化，撤回/半态治理成本高；建议制保住"人类判断领地"（用户裁决）。
+- **规划入知识体系架构（目标=体系节点）**：意图轴与结构轴重新混层——v0.18 已裁决分离建模，本设计用"引用通道"联动而非合并。
+- **流式规划**：一次性 JSON 输出（10K 量级 10-30s），任务化轮询足够；流式价值低，交互等待可接受。
+- **AI 主动推送每日任务**：用户未诉求；红线维持（人类判断领地）。
+
+## 影响
+
+- 正向：意图层获得 AI 顾问（规划/复盘的上下文来源）；目标↔体系↔概念闭环（"服务目标 X"可见/可问）；无 AI 时功能完整（规则基线）。
+- 代价：knowledge_links 白名单 +1（命令层回归）；新增 4 命令 + 1 确认流组件；设置页新增「目标 AI」段；M2 毕业仪式先行（排期 v0.18.1 → v0.18.2）。
+- 兼容：既有 goals/goal_milestones/goal_groups/contracts/knowledge_* 零 schema 变更（仅 knowledge_links 白名单+1 与新增辅助表无）；old goals 数据（无 intent 填空）走规则基线。
+
+## 合规性验证
+
+- Protocol 校验矩阵 golden（合法/缺门槛/超长/非法枚举→整条丢弃/整次降级）；预算 O(1) 恒定输出测试；双闸门路径测试（未开/未授权拒绝）；确认流落库事务测试（部分失败不污染）；cargo test/clippy/vitest/tsc 全绿（v0.18.2 验收 ①~⑧）
+
+## 相关决策
+
+- ADR-027（目标层建模——本 ADR 修订其 §5"AI 教练"范围扩展、"不做自动拆解"条款）· ADR-010（AI 为增强层·本地兜底铁律）· ADR-024（知识体系层——引用通道纪律）· ADR-026（AI 精修策略化——估费/预览范式复用）
+
+## 参考
+
+- v0.18.2 设计规格（§三~§八 交互/协议/联动/治理/验收）· v0.18 学习目标层设计 §八（记忆与预算架构）· v0.11.6 AI 平台 Provider 抽象
@@ -436,6 +436,22 @@
 | REQ-248 | 学习目标数据模型：goals/goal_milestones/goal_groups 三表（db_migrations 幂等；N:M 绑定 UNIQUE(goal_id,group_id)；判据配方/访谈答案 JSON；status 四态无 draft）+ metrics_events kind 扩展（goal_created/goal_milestone_done 写入；self_test_passed/failed 占位契约）+ 组删除 CASCADE 行为测试（goal_groups 级联清、ref_group_id SET NULL） | P1 | 已实施 | v0.18.0 | 意图层对象（目标=组的容器，组仍是唯一容器）；进度信号现算零双写；**代码已交付（2026-09-02，db_goals + 三表 + CASCADE/结算钩子测试）** |
 | REQ-249 | 访谈式目标设定：一套 InterviewDialog 双展开（访谈=四步向导+宣言确认，第 1/3 问必答、2/4 问折叠可跳过；快速=名称+期限判据走默认档）+ goal_interview 纯函数（答案→判据配方/suggest_milestones 里程碑草案/宣言组装，table-driven golden 6 条端到端+参数矩阵）+ 答案可回溯编辑（重新访谈配方重推） | P1 | 已实施 | v0.18.0 | 0 AI 本地规则（M3 叠加 AI 追问）；访谈中断不落库；**代码已交付（2026-09-02，goal_interview + 里程碑草案命令 + InterviewDialog/InterviewSteps）** |
 | REQ-250 | 目标聚合视图：GoalPage 独立 Tab（单行卡：名称/状态徽标/一句话进度/🎓可毕业）+ GoalDetail（里程碑勾选/关联组 N:M/判据明细/弱项块=FSRS 低稳定性卡占比 Top 组）+ goal_rules 四态状态机与毕业判据 + 埋点 + 组结算里程碑自动通过钩子 | P1 | 已实施 | v0.18.0 | 毕业仪式/回顾流/pause-abandon UI 属 M2（状态机纯函数与守卫已先行）；**代码已交付（2026-09-02，GoalPage/GoalCard/GoalDetail + goal_rules/goal_progress + 结算钩子）** |
+| REQ-255 | 毕业仪式与报告快照：goal_settle 命令（毕业判据守卫：未达标/重复毕业/已放弃拒绝）+ goal_graduation_reports 快照表（里程碑/子组结算/复习统计/成果物清单——目标删除后报告仍可读，快照独立于 goals 行）+ 埋点 goal_graduated | P1 | 已立项 | v0.18.1 | 毕业＝用户确认仪式（延续 v0.11.3 结算仪式纪律）；报告快照同 notes_versions「回滚不破坏历史」哲学 |
+| REQ-256 | 回顾流时间线：创建→里程碑→组结算→毕业 全时间线（现算：goals.created_at/milestones/settlements/graduation）+ 毕业报告永久入口 + RetroTimeline UI | P1 | 已立项 | v0.18.1 | 纯只读聚合零双写；毕业报告入口独立于目标存在性（目标删除仍可读） |
+| REQ-257 | 暂停/放弃显式动作（可选原因、无惩罚文案）+ 组删除降级提示 UI（bound 里程碑 ref_group_id SET NULL→「该组已删除，判据信号丢失」按手动确认） | P1 | 已立项 | v0.18.1 | 弹性承诺上延（断签不清零无惩罚）；状态机守卫已有（ADR-027 §3） |
+
+### v0.18.2 · AI 目标规划师（2026-09-02 用户裁决立项）
+
+> 依据：用户指令「目标仅规则算法——我想要接入 AI 用 AI 对目标进行规划，规划内容同步构建体系等等深度联动」＋ 用户逐项裁决（双入口/建议制确认落库/联动四项全选/**AI 提供初步体系**/默认关+授权确认）；
+> 排期：**v0.18.1（M2 毕业仪式）先行 → v0.18.2 实施**；
+> 设计：[2026-09-02-v0.18.2-ai-goal-planning-design.md](../superpowers/specs/2026-09-02-v0.18.2-ai-goal-planning-design.md) ＋ [ADR-028](../adr/ADR-028-ai-goal-planner.md)（已批准）。
+
+| REQ | 需求 | 优先级 | 状态 | 目标版本 | 备注 |
+|----|------|--------|------|---------|------|
+| REQ-251 | AI 规划协议与任务化：GoalPlanProposal（里程碑/组/体系/周契约/说明；serde 强校验：白名单/长度/id 有界/体系门槛）+ ai_goal_plan_estimate/start（ai_refine_estimate 范式；ai_tasks 任务化+轨迹）+ 建议制确认流（GoalPlanApprovalDialog 双入口共用；规则草案一键回退；失败整次降级） | P1 | 已立项 | v0.18.2 | **修订 spec §十六**：建议制 AI 拆解入列（人类确认+失败降级）；每日推送仍不做 |
+| REQ-252 | 目标↔体系深度联动：knowledge_links.target_type 白名单 +'goal'（零迁移）+ 目标详情「服务体系」区 + 体系页「服务于目标 X」反标 + **AI 初步体系**（骨架建议：名称+核心问题+≥1 领域入口+初始概念 3-5；门槛校验缺一丢弃；确认后既有体系命令逐项创建） | P1 | 已立项 | v0.18.2 | 只加引用通道（体系层零侵入）；骨架部分失败不污染目标层 |
+| REQ-253 | 目标↔概念弱项（M3 真实化）+ /goal 对话：目标内概念低激活信号（90 天无引用/未应用）+「最弱概念」块 + ai_chat `/goal` 命令（L4.5 目标摘要现算注入 <1K + L3 检索 top-K） | P1 | 已立项 | v0.18.2 | concept_stale 判据理念；摘要现算无缓存（优化评审 #1 延续） |
+| REQ-254 | 治理与设置：目标 AI 开关（默认关）+ 授权弹窗（content_gate）+ 预算档位化（4K/10K/30K 默认标准）+ 单次硬顶 + token/成本/trajectory 落库 + 设置页「目标 AI」段 | P1 | 已立项 | v0.18.2 | 复用 v0.11.6 Provider/v0.16 授权流/预算硬约束（ADR-027 §4） |
 
 ### V1.0 · 体验增强（远期）