维护者文档（协调者：mark）。学习者只需关心 START_HERE / STUDY_PLAN / 模块内容。
foundations → Claude → API/tools → MCP/RAG → agents → production → certification
| # | 目录 | 主题 | 必须覆盖的教学点 | Track |
|---|---|---|---|---|
| 1 | 01-llm-foundations | LLM 基础 (LLM Foundations) | token/tokenization、transformer 直觉、attention、next-token prediction、上下文窗口 (Context Window)、temperature 与采样、幻觉 (hallucination)、推理 (reasoning)、训练 vs 推理 | foundations |
| 2 | 02-claude-models | Claude 模型与消息 | 模型家族与生命周期（必须带日期标注）、system prompt、user/assistant 消息、多模态输入、token 计量、stop reasons、streaming、rate limits、延迟与成本 | foundations |
| 3 | 03-claude-api | Claude API 实战 | 认证、Messages API、SDK、请求/响应结构、streaming、token usage、错误处理、重试与指数退避 (exponential backoff)、rate limits、超时、并发、prompt caching、Message Batches | foundations |
| 4 | 04-tool-use | 工具使用 (Tool Use) | 完整回路 User → Claude → tool selection → 应用执行 → tool result → Claude；tool_choice；工具错误处理；架构判断：什么该 Claude 决定、什么该确定性代码决定、何时需人工审批 (human approval) | foundations |
| 5 | 05-prompting-structured-output | 提示工程与结构化输出 | prompt engineering、结构化输出 (Structured Output)/JSON 校验、few-shot、extended thinking | core |
| 6 | 06-mcp | MCP (Model Context Protocol) | 架构、server/client、tools/resources/prompts、transports、Agent → MCP → database/API 模式、何时用 MCP vs 直接 API 集成 | core |
| 7 | 07-rag-context-engineering | RAG 与上下文工程 | embeddings、向量检索、BM25/lexical、混合检索 (hybrid retrieval)、chunking、metadata filters、Top-K、reranking、groundedness | core |
| 8 | 08-agents | 智能体 (Agents) | workflow vs agent（以官方 Building Effective Agents 为准）、agent loop、目标/推理/规划/行动/观察、停止条件、编排模式（routing、chaining、parallelization、evaluator-optimizer、planner/executor、manager/worker、multi-agent） | core |
| 9 | 09-claude-code | Claude Code | 当前文档为准：基础用法、agent loop、仓库理解、CLAUDE.md、planning、permissions、tools、Skills、hooks、commands、plugins、subagents、MCP、context management | production |
| 10 | 10-production | 生产架构 | 部署环境、secrets/配置、可观测性 (observability)、可审计性 (auditability)、故障处理、成本/延迟/可靠性权衡、模型升级、参考架构（网关 → 编排 → Claude/检索/MCP/工具/状态 → 人审升级） | production |
| 11 | 11-security | 安全 | prompt injection、权限体系、LLM 指令 ≠ 应用层强制 (LLM instruction vs application enforcement)、数据隐私、工具安全 | production |
| 12 | 12-evaluation-observability | 评估与可观测性 | evals、golden datasets、回归测试、task success、tool correctness、answer correctness、groundedness、幻觉评估、检索指标、延迟监控 | production |
| 13 | 13-capstone-project | Capstone | 完整参考架构（Mermaid 图）+ 决策工作簿（模型选择/提示/上下文/RAG/工具/MCP/agent vs workflow/权限/人审/安全/评估/日志/成本/可靠性/部署/故障）+ 项目规格 + 评分标准 | capstone |
| 14 | 14-certification-prep | 认证备考 | exam-domain-map、exam-vocabulary、exam-strategy、common-traps、last-week-review、last-day-review、模拟题（中文题干+英文术语，独立答案册） | certification |
README.md 主课：概念讲解 + 至少 1 张 Mermaid 图（有用处时）+ 具体示例 + bad vs better 架构对比 + tradeoffs + 常见错误 (common mistakes) + 重要英文术语 + 认证相关性examples/ 可运行代码（无密钥内嵌；无 key 可跑的必须能跑；需 key 的做静态校验并注明）labs/lab.md 动手实验questions/architect-questions.md 架构师问答题questions/exam-style.md 考试题型题（英文术语保持英文）flashcards/flashcards-NN.csv ≥15 张（列：question,answer,category,difficulty,certification_domain）glossary/glossary-<track>.md 追加本模块术语（term / 翻译 / 通俗解释 / 架构师相关性 / 常见混淆）sources/sources-<track>.csv 本模块来源（含 access_status 与访问日期）每个场景决策题提供：Scenario / Constraints / Options / Best choice / Why / Why others are weaker / Tradeoffs / What would change the answer
仅用本仓库的学习者应能回答：
简报允许优化结构（"You may improve this structure…Do NOT remove the basic progression"）。本仓库按知识依赖重排如下，主线不变：
| 简报模块 | 本仓库模块 | 说明 |
|---|---|---|
| M1 LLM Foundations | 01-llm-foundations | 一致；embeddings/向量库概念分流到 01+07 |
| M2 Claude Platform | 02-claude-models + 03-claude-api | 平台与 API 拆为两模块 |
| M3 Prompt Engineering | 05-prompting-structured-output | 与结构化输出合并，置于 API 之后 |
| M4 Claude API | 03-claude-api | 见 M2 行 |
| M5 Tool Use | 04-tool-use | 一致（编号前移） |
| M6 MCP | 06-mcp | 一致 |
| M7 RAG & Context Engineering | 07-rag-context-engineering | 一致 |
| M8 Agentic Architecture | 08-agents | 一致 |
| M9 Claude Code | 09-claude-code | 一致 |
| M10 Production Architecture | 10-production | 一致 |
| M11 Security & Governance | 11-security | 一致 |
| M12 Evaluation & Observability | 12-evaluation-observability | 一致 |
| M13 Capstone | 13-capstone-project | 结构改为 README+决策工作簿+参考架构+bad-vs-better+rubric（覆盖简报 12 文件内容点） |
| — | 14-certification-prep | 简报第 12 节认证备考独立成模块 |
| architecture-exercises/ | architecture-exercises/ | 简报第 9 节 30+ 场景集中训练（补建中） |
| mock-exams/ | mock-exams/ | 简报第 13 节 4 套英文模拟卷（补建中） |