content-manifest.json

{
  "schema_version": 1,
  "documents": [
    {
      "id": "add-a-python-api",
      "type": "playbook",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "playbooks/add-an-api/README.md",
          "title": "Add or Change a Python API",
          "summary": "Define the public contract first, then implement and verify success, error, and compatibility behavior.",
          "sha256": "75d12e8f14e5d5450fb7eeff10c11d86477758ae46a55fa8954f9105eb26d730"
        },
        {
          "lang": "zh-CN",
          "path": "playbooks/add-an-api/README_cn.md",
          "title": "增加或修改 Python API",
          "summary": "先定义公共契约，再实现并验证成功、错误和兼容性行为。",
          "sha256": "5c844ed892f4bfa591f11a7be9a329306c3b191b645935fe13bb3a536067b691"
        }
      ]
    },
    {
      "id": "ai-coding-context-budget",
      "type": "guide",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "guides/ai-coding/context-budget.md",
          "title": "Context Budgeting and Bounded Tasks for Coding Agents",
          "summary": "Maximize coding agent accuracy by controlling context size, writing explicit task contracts, and enforcing automated verification loops.",
          "sha256": "61f2cb3e8629978ddf69d0e9800b4bafde26467b1e44f8ac26384b9ad10a80cc"
        },
        {
          "lang": "zh-CN",
          "path": "guides/ai-coding/context-budget_cn.md",
          "title": "Coding Agent 上下文预算与精准任务设计",
          "summary": "通过控制上下文体积、编写明确任务契约与建立自动化验证闭环，最大化 Agent 编码准确率。",
          "sha256": "302168b4422f89d79fa38b63c1a49c5691ad170f684f6523df490c2bf2670be6"
        }
      ]
    },
    {
      "id": "course-agent-rules",
      "type": "course",
      "content_version": 2,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/agent-rules-single-source/COURSE.md",
          "title": "One source of truth for agent rules",
          "summary": "Stop maintaining diverging AGENTS.md, CLAUDE.md, and .cursorrules files — build a checker that proves your repository has exactly one rule source, taught hands-on with your coding agent.",
          "sha256": "d7dd7ed26db699c576046c2e103d6d94a2299805dca0d6b6153a4d6ccafcba6e"
        },
        {
          "lang": "zh-CN",
          "path": "courses/agent-rules-single-source/COURSE_cn.md",
          "title": "Agent 规则的单一真源",
          "summary": "不再同时维护彼此打架的 AGENTS.md、CLAUDE.md 与 .cursorrules——亲手构建一个能证明仓库只有一处规则真源的检查器，由你的编码 Agent 授课。",
          "sha256": "bf81ca5856328e1ef4f204707ad002f49704486ab2589d3b52cf366285e8222f"
        }
      ]
    },
    {
      "id": "course-agent-rules-l01",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/agent-rules-single-source/lessons/L01.md",
          "title": "Measure the drift you already have",
          "summary": "Run the checker against the three scenario repositories and read drift as a test failure, not a vibe.",
          "sha256": "5daf164c4b622a483df4bbf1e1df4a5753779fb43e6f70a9456124c959e012e6"
        },
        {
          "lang": "zh-CN",
          "path": "courses/agent-rules-single-source/lessons/L01_cn.md",
          "title": "量化你已经存在的漂移",
          "summary": "对三个场景仓库运行检查器，把漂移读成测试失败，而不是一种感觉。",
          "sha256": "a935a17b1e9d09f2f161580f480221ab36eb079c86711524bdf5e4508ed069d5"
        }
      ]
    },
    {
      "id": "course-agent-rules-l02",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/agent-rules-single-source/lessons/L02.md",
          "title": "Decide the source of truth",
          "summary": "AGENTS.md becomes the one file agents read; everything else is a pointer or a copy — decide, then write it down.",
          "sha256": "298d598f44af59a493f44a402d3faf9ab384a4f83088509bcfae70fc7a006999"
        },
        {
          "lang": "zh-CN",
          "path": "courses/agent-rules-single-source/lessons/L02_cn.md",
          "title": "确定唯一真源",
          "summary": "AGENTS.md 成为 Agent 唯一阅读的文件；其余都只能是指针或副本——先决定，再写下来。",
          "sha256": "1a9a3a076663df37d3f45c110ad4de1b805db7a220dcdefb413d9eb241748ce1"
        }
      ]
    },
    {
      "id": "course-agent-rules-l03",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/agent-rules-single-source/lessons/L03.md",
          "title": "Drive a bounded change, test by test",
          "summary": "Make the starter detect source, pointer, copy, and drift — one failing test group at a time.",
          "sha256": "b1b6dacafce0158965fc1721910514ceede367fd1b0d213adb8163d9e72dc4fc"
        },
        {
          "lang": "zh-CN",
          "path": "courses/agent-rules-single-source/lessons/L03_cn.md",
          "title": "按测试驱动一次有边界的变更",
          "summary": "让 starter 依次识别真源、指针、副本与漂移——一次一组失败测试。",
          "sha256": "4a58994b8080514e435124259416d325af4622275e5e3a70ecc0564f8949969d"
        }
      ]
    },
    {
      "id": "course-agent-rules-l04",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/agent-rules-single-source/lessons/L04.md",
          "title": "Verify and wire it in",
          "summary": "Prove both verifier directions, run all three skins, then add the checker to your repository's review loop.",
          "sha256": "24245a7159551c4565456f9f702a37595dcb895a2b153f6ea9191d9e2229521d"
        },
        {
          "lang": "zh-CN",
          "path": "courses/agent-rules-single-source/lessons/L04_cn.md",
          "title": "验证并接入流程",
          "summary": "证明验证器双向通过、跑完三个皮肤，然后把检查器接入你仓库的审查环。",
          "sha256": "bcdc8ecf6d6f864c157f81339f73517e8f3b76d94b23e8446d9737d415f3882b"
        }
      ]
    },
    {
      "id": "course-agent-rules-l05",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/agent-rules-single-source/lessons/L05.md",
          "title": "Apply this to your repository",
          "summary": "One AGENTS.md, thin pointers everywhere else, and a failing check when it breaks.",
          "sha256": "ce747d851a4844298b00415593f2153510605f0f0a69f3e289e7acb3370a0082"
        },
        {
          "lang": "zh-CN",
          "path": "courses/agent-rules-single-source/lessons/L05_cn.md",
          "title": "把这套方法带回你的仓库",
          "summary": "一个 AGENTS.md，其余全是瘦指针，一旦破坏检查就失败。",
          "sha256": "f3dd9ef2c01e90f90897ebbdf7c048961fed8469173fa8a92bb1617eb353213f"
        }
      ]
    },
    {
      "id": "course-claude-code",
      "type": "course",
      "content_version": 2,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-python-with-claude-code/COURSE.md",
          "title": "Hands-on Python with Claude Code",
          "summary": "An agent-taught course that takes you from a cloned folder to a tested, verified Python report tool using Claude Code — including the task contract, the bounded change, and the objective pass/fail evidence.",
          "sha256": "50165b3b9aa9979d565ab34057977b7b7264cec739be1900ec3988876731c132"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-python-with-claude-code/COURSE_cn.md",
          "title": "用 Claude Code 实战 Python",
          "summary": "一门由 Agent 授课的课程：从下载课程文件夹到交付一个经过测试与验证的 Python 报表工具——包括任务契约、最小变更和客观的通过/失败证据。",
          "sha256": "8c73c31d5901ff9bbe9e79e97342688b6737657ab05f1b71a767125ca398e2d3"
        }
      ]
    },
    {
      "id": "course-claude-code-l01",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-python-with-claude-code/lessons/L01.md",
          "title": "Lesson 1: Reproduce the failure before you fix anything",
          "summary": "Clone the folder, meet the starter, and make the failure objective with verify.py — the habit that separates \"it runs\" from \"it ships\".",
          "sha256": "824df537303329d4b3b48e3d4e03402a3025e8de6d38f85d2e8e8701b3a700c6"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-python-with-claude-code/lessons/L01_cn.md",
          "title": "第 1 课：先复现故障，再谈修复",
          "summary": "打开课程文件夹，认识 starter，用 verify.py 把\"坏了\"变成客观证据——这是\"能跑\"与\"能交付\"的分水岭。",
          "sha256": "055e8764b490399ce1a107448f5a8e9471aabba91d239448894f96d76a74b3f7"
        }
      ]
    },
    {
      "id": "course-claude-code-l02",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-python-with-claude-code/lessons/L02.md",
          "title": "Lesson 2: Write the task contract before the change",
          "summary": "Turn \"make it better\" into a bounded, testable contract — the single highest-leverage skill for working with coding agents.",
          "sha256": "61e96ecb739482e545f4480a6dd4c6ed6017e2d41cdb268156ec91131de2e320"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-python-with-claude-code/lessons/L02_cn.md",
          "title": "第 2 课：动手之前先写任务契约",
          "summary": "把\"优化一下\"变成有边界、可测试的契约——这是与编码 Agent 协作杠杆最大的一项技能。",
          "sha256": "83944c2772438743f920ad177cbce098f8777a3c12d267c74081be0c2280493b"
        }
      ]
    },
    {
      "id": "course-claude-code-l03",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-python-with-claude-code/lessons/L03.md",
          "title": "Lesson 3: Drive a bounded change, test by test",
          "summary": "Let the agent edit the starter under contract — smallest change, no new dependencies, red to green one group at a time.",
          "sha256": "8fe1f81ea3aeaa03d63bd2d016248df0178846c6100644f067241bea4bddf792"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-python-with-claude-code/lessons/L03_cn.md",
          "title": "第 3 课：按测试驱动一次有边界的变更",
          "summary": "让 Agent 在契约约束下修改 starter——最小变更、不新增依赖、一次一组测试从红到绿。",
          "sha256": "136f483cfaefbdf7fea0328973a301faad639fb2edc0b633fbe037524afb9aef"
        }
      ]
    },
    {
      "id": "course-claude-code-l04",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-python-with-claude-code/lessons/L04.md",
          "title": "Lesson 4: Verify like an engineer, review like a skeptic",
          "summary": "Run the full verification loop, review the agent's diff for scope and side effects, and record what you did — and did not — prove.",
          "sha256": "ec724dbdb8172c284a6c970c499056d084b5e36bb3d3e6b4a32f5c14bb39494c"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-python-with-claude-code/lessons/L04_cn.md",
          "title": "第 4 课：像工程师一样验证，像怀疑者一样审查",
          "summary": "跑完整验证闭环，审查 Agent 的 diff 是否越界、有无副作用，并如实记录证明了什么、没证明什么。",
          "sha256": "0c1f0532498a4f78a5c1255ad4309138890deed62039912677e6e44e5410ba23"
        }
      ]
    },
    {
      "id": "course-claude-code-l05",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-python-with-claude-code/lessons/L05.md",
          "title": "Lesson 5: Apply this to your own project",
          "summary": "Port the workflow — not the code — to one script you own: contract, isolation, rounding, atomic writes, and an honest verification record.",
          "sha256": "740a67fa1ce064eeca4b870578f036d4d241a96e730a9898fbc5d720e9bdcf79"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-python-with-claude-code/lessons/L05_cn.md",
          "title": "第 5 课：把这套方法带回你自己的项目",
          "summary": "迁移工作流——而不是代码——到你拥有的一个脚本上：契约、错误隔离、舍入、原子写入，以及一份诚实的验证记录。",
          "sha256": "62bf3fe25f4b27f6aff3b1bddded715f2fdd2ac674d2d2c69144b34d4648b41a"
        }
      ]
    },
    {
      "id": "course-codex-cli",
      "type": "course",
      "content_version": 2,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-with-openai-codex-cli/COURSE.md",
          "title": "Hands-on with OpenAI Codex CLI",
          "summary": "The same verified Python workflow as the Claude Code course — task contract, bounded change, objective verify.py evidence — taught hands-on with the OpenAI Codex CLI instead.",
          "sha256": "48e81f530f58ef69fe92e6312b08f01b4661f311cf07371809ce206e2eecd474"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-with-openai-codex-cli/COURSE_cn.md",
          "title": "OpenAI Codex CLI 实战",
          "summary": "与 Claude Code 课程相同的已验证 Python 工作流——任务契约、最小变更、客观 verify.py 证据——改用 OpenAI Codex CLI 完成实战。",
          "sha256": "bbdf5d8a71d8243f1cb7a3c30d2aa4ddb656cb932d36aaae3d543e3b5f7ea3c2"
        }
      ]
    },
    {
      "id": "course-codex-cli-l01",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L01.md",
          "title": "Lesson 1: Reproduce the failure with Codex in the loop",
          "summary": "Run the verifier both ways, map each failing test to a real-world failure class, and learn how to hand the folder to Codex.",
          "sha256": "1c316f7b5575741ce42c299d89e2075e10a162099c53cd6344e75ccf2487a5cf"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L01_cn.md",
          "title": "第 1 课：让 Codex 进环，先复现故障",
          "summary": "双向运行验证器，把每个失败测试对应到真实故障，并学会如何把文件夹交给 Codex。",
          "sha256": "878513b4bb6218655088cdec3fa873c4318e9c729b86ce176e5b14a93b8eee9a"
        }
      ]
    },
    {
      "id": "course-codex-cli-l02",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L02.md",
          "title": "Lesson 2: Write the task contract before the change",
          "summary": "Turn \"make it better\" into bounded, testable statements — the single highest-leverage skill for driving Codex.",
          "sha256": "e3d75d35a8585c4765f76f506d907c65136359306657943b1c657239495bab07"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L02_cn.md",
          "title": "第 2 课：动手之前先写任务契约",
          "summary": "把“优化一下”变成有边界、可测试的陈述——驱动 Codex 杠杆最大的一项技能。",
          "sha256": "9c0cc619fe1e9c4ec07733e02d7832c11709dcb491cbf0e3a2f574dc2dc47ea2"
        }
      ]
    },
    {
      "id": "course-codex-cli-l03",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L03.md",
          "title": "Lesson 3: Drive a bounded change, test by test",
          "summary": "Supervise Codex through seven small diffs — smallest change, no new dependencies, one failing test group at a time.",
          "sha256": "41adb2f3560d29b38d7d1a8254a51197323637e589aa463e4c8417f9c61e8686"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L03_cn.md",
          "title": "第 3 课：按测试驱动一次有边界的变更",
          "summary": "监督 Codex 完成七个小 diff——最小变更、不新增依赖、一次一组失败测试。",
          "sha256": "4f440f36af4c3eba76bd307085a3bf48020931b168b5a04edc9a6c190ec02c10"
        }
      ]
    },
    {
      "id": "course-codex-cli-l04",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L04.md",
          "title": "Lesson 4: Verify like an engineer, review like a skeptic",
          "summary": "Complete the evidence loop — both verification directions, all three skins, a scope-creep diff review, and a written record of what is not proven.",
          "sha256": "ac228870e7c4ef0df522664c27fb7895535c72090833c59c86e8b33e527a2703"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L04_cn.md",
          "title": "第 4 课：像工程师一样验证，像怀疑者一样审查",
          "summary": "完成证据闭环——双向验证、三个皮肤、范围蔓延 diff 审查，以及一份写明未证明内容的记录。",
          "sha256": "cb9d5ba62f101fa47d03740f5806930dd51986e310be04f255e93b422f9e1edc"
        }
      ]
    },
    {
      "id": "course-codex-cli-l05",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L05.md",
          "title": "Lesson 5: Apply this to your own project",
          "summary": "Port the workflow — not the code — to one script you own, with tests, a verify command, and honest limits.",
          "sha256": "352ea47aa0ae5093e3d4f38f0f82218323fadf393dcc4da0f63a6851ea9dd6b4"
        },
        {
          "lang": "zh-CN",
          "path": "courses/hands-on-with-openai-codex-cli/lessons/L05_cn.md",
          "title": "第 5 课：把这套方法带回你自己的项目",
          "summary": "迁移工作流——而不是代码——到你拥有的一个脚本上，附测试、验证命令与诚实的局限说明。",
          "sha256": "61565be72cae4e5ff14b5059bb108363d750a41e22073003d0d4de357a6944eb"
        }
      ]
    },
    {
      "id": "course-da-eda",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-eda/COURSE.md",
          "title": "Exploratory Data Analysis with an Agent",
          "summary": "A challenge course — point your agent at a messy shop export and produce a verified EDA summary (results.json) whose numbers are checked against ground truth. First non-stdlib course in the catalog; pandas is managed with uv.",
          "sha256": "3d5a7d05b6b48a667eeca51f7c6232e95c231d7cb4f78d3826de02c6a0a55b85"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-eda/COURSE_cn.md",
          "title": "用 Agent 做探索性数据分析",
          "summary": "挑战式课程——让你的 Agent 处理一份脏的商店导出数据，产出一份经过真值校验的 EDA 摘要（results.json）。目录中第一门非标准库课程；pandas 由 uv 管理。",
          "sha256": "ef5272a728fc540f4bedb3c650a1789d50a32cc90883aacd3202ba10360b4f00"
        }
      ]
    },
    {
      "id": "course-da-eda-l01",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-eda/lessons/L01.md",
          "title": "Challenge 01: What messy data looks like",
          "summary": "Profile the shop export before touching pandas: exact duplicates, unparseable amounts, one bad date — count the dirt first.",
          "sha256": "8c57798d7811e0ee23535e79bd03d17c963d25396892b78eb69047b4e290bfa4"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-eda/lessons/L01_cn.md",
          "title": "挑战 01：脏数据长什么样",
          "summary": "动手写 pandas 之前先给商店导出数据画像：完全重复、无法解析的金额、一条坏日期——先把脏数清楚。",
          "sha256": "735a4a37b713c45c4ae342afcddbf7f9410dfd8019b5833b8db608a673153448"
        }
      ]
    },
    {
      "id": "course-da-eda-l02",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-eda/lessons/L02.md",
          "title": "Challenge 02: Define the answer first",
          "summary": "Sketch results.json — keys, types, rounding — before letting the agent write eda.py.",
          "sha256": "4383de459c198d45aa36c148cf5239d32f8e3061855fd91ce4043011acf94d79"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-eda/lessons/L02_cn.md",
          "title": "挑战 02：先定答案",
          "summary": "先勾出 results.json 的键、类型与舍入规则，再让 Agent 写 eda.py。",
          "sha256": "70a68166ca660c84362157c8bea7e92abd16e22827f07f20a6cf1a5ca650e6d4"
        }
      ]
    },
    {
      "id": "course-da-eda-l03",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-eda/lessons/L03.md",
          "title": "Challenge 03: Clean and summarize",
          "summary": "Implement load_transactions, clean_transactions, summarize, write_results, main until all twelve tests pass.",
          "sha256": "347a34a7afa47c33b3db027e1fcb0824fb1e0de313281d03b5e241e7a8b72fee"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-eda/lessons/L03_cn.md",
          "title": "挑战 03：清洗与统计",
          "summary": "实现 load_transactions、clean_transactions、summarize、write_results、main，十二个测试全绿。",
          "sha256": "98b835ab40e7c9bf537a6c20b9ee7783a69761f71493699b9793a4e84bc6e40f"
        }
      ]
    },
    {
      "id": "course-da-eda-l04",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-eda/lessons/L04.md",
          "title": "Challenge 04: Check against ground truth",
          "summary": "The suite asserts exact numbers — 142 in, 137 clean, revenue 33347.89, top category Books; plausible-but-different fails.",
          "sha256": "bed37fda0b4c2e51adf9f6f5f9adeb0479e7089ce9de29786b2857e5904ce2d8"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-eda/lessons/L04_cn.md",
          "title": "挑战 04：核对真值",
          "summary": "套件断言精确数字——142 进 137 净、营收 33347.89、品类第一 Books；看着合理但不同即失败。",
          "sha256": "fe7c5b6dd9d8ee37db271b152b21a647565c3a913ae6953d680d43a36a1ff381"
        }
      ]
    },
    {
      "id": "course-da-eda-l05",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-eda/lessons/L05.md",
          "title": "Challenge 05: Run it on your own data",
          "summary": "Port the pipeline to a real export you own and record which assumptions break.",
          "sha256": "58eed4e2eb41ce3771a9508e772d003279d4664a92a6a1bc8f7db50675a6e4c6"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-eda/lessons/L05_cn.md",
          "title": "挑战 05：换成你自己的数据",
          "summary": "把流水线搬到你自己一份真实导出上，记下哪些假设崩了。",
          "sha256": "e8b859e7ff90b5c13f354374a14fb6f40bd1efef1bc3f440ca8889bdea47cbec"
        }
      ]
    },
    {
      "id": "course-da-report",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-report/COURSE.md",
          "title": "From Analysis to Report with an Agent",
          "summary": "Challenge course — turn a verified EDA summary into a structured report (report.json + report.md) where every number traces back to its input. Verification checks structure and number consistency, not writing quality.",
          "sha256": "d2b978ad0e561b90734d747c4551cda91dddf8619e4d388799b67a4b59344496"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-report/COURSE_cn.md",
          "title": "用 Agent 从分析到报告",
          "summary": "挑战课程——把经过验证的 EDA 摘要变成结构化报告（report.json + report.md），其中每个数字都可回溯到输入。验证检查结构与数字一致性，不评价文笔。",
          "sha256": "c825ca0039fd828e4133a1a14956907a7cf8a74ff0c2e736f387c16fd26723e7"
        }
      ]
    },
    {
      "id": "course-da-report-l01",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-report/lessons/L01.md",
          "title": "Challenge 01: A report is a contract with the reader",
          "summary": "List which numbers the report must carry and where each comes from in results.json.",
          "sha256": "0aedc261a20d54aa9fb79c6b294f5710b52bf7df421efb18c3ce913db52a542f"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-report/lessons/L01_cn.md",
          "title": "挑战 01：报告是与读者的契约",
          "summary": "列出报告必须携带哪些数字，以及各自来自 results.json 的哪个字段。",
          "sha256": "e0a0df3a5e537aa2f58feb5552d47ae3f1ba87cd0fe965ebbe440767ef189204"
        }
      ]
    },
    {
      "id": "course-da-report-l02",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-report/lessons/L02.md",
          "title": "Challenge 02: Structure before prose",
          "summary": "Title, exact section order Data quality → Findings → Appendix, and the metrics block — before any sentence.",
          "sha256": "b307e17338d44f3860b29fbedd3f12365a23ff3d28bac7fed0aacb8ba6590292"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-report/lessons/L02_cn.md",
          "title": "挑战 02：先结构，后文字",
          "summary": "标题、Data quality → Findings → Appendix 的确切顺序、metrics 块——先于任何句子。",
          "sha256": "a48efa135060f1e092dbecc061fcaedf5babb0710fbaaa1afdb28bfb0a51a992"
        }
      ]
    },
    {
      "id": "course-da-report-l03",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-report/lessons/L03.md",
          "title": "Challenge 03: Build and render the report",
          "summary": "Carry metrics through unchanged, emit # title then ## sections in order, money at two decimals.",
          "sha256": "3b9eb25b0c3377062114cdfff2ad560d6ba9241ccba55c0dcac695a83a0414e9"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-report/lessons/L03_cn.md",
          "title": "挑战 03：构建并渲染报告",
          "summary": "metrics 原样透传，先 # 标题再按序 ## 小节，金额两位小数。",
          "sha256": "01571a51e5c21976bac10b5d655e292b3de882b5acdd6fd0c197fbe257a98155"
        }
      ]
    },
    {
      "id": "course-da-report-l04",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-report/lessons/L04.md",
          "title": "Challenge 04: Numbers traceable to inputs",
          "summary": "Every metric in report.json equals its source field — the audit answer is a field name, not an explanation.",
          "sha256": "501e1fbb684a5e94701559311ad098ea1a3f31fb63da46cd5ddb3f3a37ce2bcf"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-report/lessons/L04_cn.md",
          "title": "挑战 04：数字可回溯到输入",
          "summary": "report.json 每个指标等于源字段——审计答案是字段名，不是解释。",
          "sha256": "6603a3bb907ed7f72ef685e2edc68d7a9f21c68cc8b8471347c71e9f8acfa00a"
        }
      ]
    },
    {
      "id": "course-da-report-l05",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-report/lessons/L05.md",
          "title": "Challenge 05: What report verification cannot see",
          "summary": "Structure and number consistency are checked; insight and honest conclusions are not — write the boundary sentence.",
          "sha256": "e267e245dbb43dfaf905189469fc1507fb46f814fc4778666363837e55b7eab4"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-report/lessons/L05_cn.md",
          "title": "挑战 05：报告验证看不到的东西",
          "summary": "结构与数字一致性被查；洞察与结论诚实不在其中——写下边界句。",
          "sha256": "60e8b47da3754b8bd76a9306a09cdb7a056f9c5b601132e71457c80113654b28"
        }
      ]
    },
    {
      "id": "course-da-visualization",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-visualization/COURSE.md",
          "title": "Data Visualization with an Agent",
          "summary": "Challenge course — turn a clean sales dataset into three spec'd charts plus a summary.json whose numbers are verified against the data. Charts must be generated from data, never hardcoded.",
          "sha256": "950c213e5093c415a6a78988fa7bb1c0056fd23b2d27225a762b977a70af3a5f"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-visualization/COURSE_cn.md",
          "title": "用 Agent 做数据可视化",
          "summary": "挑战课程——把干净的销售数据变成三张有规格的图和一份 summary.json，其中数字会与数据集校验。图必须由数据生成，不许硬编码。",
          "sha256": "6c614cb91314a2b75b51e677d50a6d214355047eeb48def66fa0fc3105c3a690"
        }
      ]
    },
    {
      "id": "course-da-visualization-l01",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-visualization/lessons/L01.md",
          "title": "Challenge 01: A chart is packaged evidence",
          "summary": "Say what claim each required PNG makes before writing code — the JSON summary is the auditable layer.",
          "sha256": "d3640c032fca4b748b83fef983ebda39fd0e7cda5dff210dac3113bfe0a9809e"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-visualization/lessons/L01_cn.md",
          "title": "挑战 01：图是证据的包装",
          "summary": "写码前先说出每张 PNG 声明什么——JSON 摘要才是可审计层。",
          "sha256": "5b1acf730a1aa6d73e127370cf29c497550c74c3b6be1884f1c066d673304ed0"
        }
      ]
    },
    {
      "id": "course-da-visualization-l02",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-visualization/lessons/L02.md",
          "title": "Challenge 02: Spec first, chart second",
          "summary": "Write which aggregation feeds each chart and what summary.json must contain before matplotlib opens.",
          "sha256": "ac12fed1fec38f46ab665999e219c570f6cb765088a3da3a8532e0d8cab478bb"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-visualization/lessons/L02_cn.md",
          "title": "挑战 02：先写规格，再画图",
          "summary": "在打开 matplotlib 之前写清每张图吃哪个聚合、summary.json 必须装什么。",
          "sha256": "5f860f5b8de7bad0cf408a690752246820ef56bc44ad1bb43e74e26c27ef3420"
        }
      ]
    },
    {
      "id": "course-da-visualization-l03",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-visualization/lessons/L03.md",
          "title": "Challenge 03: Three charts and a summary",
          "summary": "Implement the contract in starter/charts.py — Agg before pyplot, parsed dates, real PNG bytes.",
          "sha256": "16ddbb48daf45a5c9802424690ab028ce86bc6ea42c8f4b677b7d03da3b36b51"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-visualization/lessons/L03_cn.md",
          "title": "挑战 03：三张图与摘要",
          "summary": "在 starter/charts.py 实现契约——Agg 先于 pyplot、日期先解析、真 PNG 字节。",
          "sha256": "53532ad9115b7b3295ba0f693b59ea8f961b54a489a1aa8f0ecc1880dfe90ef9"
        }
      ]
    },
    {
      "id": "course-da-visualization-l04",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-visualization/lessons/L04.md",
          "title": "Challenge 04: Numbers match the charts",
          "summary": "summary.json is checked against ground truth; a chart disagreeing with the JSON is a failed chart.",
          "sha256": "5669523f09d8877d325c54f561dd595d713bf521a70d768095e009400c2ac4ca"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-visualization/lessons/L04_cn.md",
          "title": "挑战 04：数字与图一致",
          "summary": "summary.json 对照真值校验；图与 JSON 不一致就是失败的图。",
          "sha256": "08f3321adfa7764d58b5e81eec1aa1cb513ba7bfbfbd16ad2b98488d74b0cf28"
        }
      ]
    },
    {
      "id": "course-da-visualization-l05",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/da-visualization/lessons/L05.md",
          "title": "Challenge 05: Honest boundary",
          "summary": "The suite checks files and numbers — not readability or honest scales; state what was not verified.",
          "sha256": "2a2a7ce46664f4653b73b6c719071757a76456b0a10eb35694cee60fac4df6e8"
        },
        {
          "lang": "zh-CN",
          "path": "courses/da-visualization/lessons/L05_cn.md",
          "title": "挑战 05：诚实边界",
          "summary": "套件查文件与数字——不查可读性与刻度诚实；写清没验证什么。",
          "sha256": "7ac94ceda7e8e89e5c192399fcb0a1b0d9c410924d1ba0531ee9c4481e1ce595"
        }
      ]
    },
    {
      "id": "course-mcp-tools",
      "type": "course",
      "content_version": 2,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/mcp-server-in-python/COURSE.md",
          "title": "Give your agent tools with MCP (Python)",
          "summary": "Build a stateless Model Context Protocol tool server in pure Python — JSON-RPC 2.0 dispatch, schema validation, error isolation, and the 2026-07-28 input_required round-trip — and learn where a real tool belongs.",
          "sha256": "de677071dab7c06244ad0634a7266372619af38a8de60b8257af0570de1b9cb4"
        },
        {
          "lang": "zh-CN",
          "path": "courses/mcp-server-in-python/COURSE_cn.md",
          "title": "用 MCP 给你的 Agent 装上工具（Python）",
          "summary": "用纯 Python 构建一个无状态的 Model Context Protocol 工具服务——JSON-RPC 2.0 分发、schema 校验、错误隔离与 2026-07-28 的 input_required 多轮交互——并理解真正的工具该放在哪里。",
          "sha256": "d125779e096e3b76b97caf51db25577869ee9fadd23447e02f9aea1d5d5066ee"
        }
      ]
    },
    {
      "id": "course-mcp-tools-l01",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/mcp-server-in-python/lessons/L01.md",
          "title": "What MCP actually is (2026-07-28)",
          "summary": "A stateless JSON-RPC 2.0 surface for tools — no handshake, no sessions, versions in _meta.",
          "sha256": "a50dbc4673a7178344e7ff3d19dac2f53abbabe584ed3bfa4639b5b263064fc0"
        },
        {
          "lang": "zh-CN",
          "path": "courses/mcp-server-in-python/lessons/L01_cn.md",
          "title": "MCP 到底是什么（2026-07-28）",
          "summary": "一个面向工具的无状态 JSON-RPC 2.0 接口——无握手、无会话、版本放在 _meta 里。",
          "sha256": "1f89bd8f063956870cb01fe57593779ab0eb2566f52404c4a2bc9e76c48dc29f"
        }
      ]
    },
    {
      "id": "course-mcp-tools-l02",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/mcp-server-in-python/lessons/L02.md",
          "title": "The JSON-RPC dispatch contract",
          "summary": "Valid requests echo their id; invalid ones get -32600; unknown or removed methods get -32601.",
          "sha256": "2b0b57cd587d214f17f24864ba0b7fd632b1f8f18af113469e07843503fa8baf"
        },
        {
          "lang": "zh-CN",
          "path": "courses/mcp-server-in-python/lessons/L02_cn.md",
          "title": "JSON-RPC 分发契约",
          "summary": "合法请求回显 id；非法请求得 -32600；未知或已移除的方法得 -32601。",
          "sha256": "9cea20a365eb994ffd0a6db1d07df4b494dea86593d77f078c0825c9e9aa9995"
        }
      ]
    },
    {
      "id": "course-mcp-tools-l03",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/mcp-server-in-python/lessons/L03.md",
          "title": "Validation and error isolation",
          "summary": "Arguments are untrusted input: validate before execution, and never let a handler crash the transport.",
          "sha256": "7d55d1fab063f988ffc819f1f2dfa945ceeb4bc5208d7dadbf0e009c7dfa7196"
        },
        {
          "lang": "zh-CN",
          "path": "courses/mcp-server-in-python/lessons/L03_cn.md",
          "title": "校验与错误隔离",
          "summary": "参数是不可信输入：先校验再执行，绝不让处理函数打断传输。",
          "sha256": "bd546854dc1b42f03baafddf00eed80a7c601d0ed228a5f951d7e3daef8d4a0f"
        }
      ]
    },
    {
      "id": "course-mcp-tools-l04",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/mcp-server-in-python/lessons/L04.md",
          "title": "The input_required round-trip",
          "summary": "A tool can ask the client a question mid-call — return the requests, finish on the retry carrying answers.",
          "sha256": "2ba1145cdc807afabd09737b860c9531acdbdbf933870e51f640c5f1bbb3a631"
        },
        {
          "lang": "zh-CN",
          "path": "courses/mcp-server-in-python/lessons/L04_cn.md",
          "title": "input_required 多轮交互",
          "summary": "工具可以在调用中途向客户端提问——先返回问题，客户端带答案重试后完成。",
          "sha256": "8170e1bbec1865410e7ea0c8feb1b8cc182b3e119ce608f3c4e8fdc822ddcc70"
        }
      ]
    },
    {
      "id": "course-mcp-tools-l05",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/mcp-server-in-python/lessons/L05.md",
          "title": "Expose one real tool to your agent",
          "summary": "Wrap one function you actually own behind the validated, isolated boundary you just built.",
          "sha256": "8b7c0a177ee77b0e9a9c8972d42f89dca94576e5aa9c234e845d11d65cb128c6"
        },
        {
          "lang": "zh-CN",
          "path": "courses/mcp-server-in-python/lessons/L05_cn.md",
          "title": "给你的 Agent 暴露一个真实工具",
          "summary": "把你真正拥有的一个函数包进刚建好的“校验 + 隔离”边界。",
          "sha256": "4b33bc46cf447a9df0d0b7b0a37cab36eb825b9769d1c42ead1b0823af75014f"
        }
      ]
    },
    {
      "id": "course-verify-ship",
      "type": "course",
      "content_version": 2,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/verifying-ai-generated-code/COURSE.md",
          "title": "From \"it runs\" to \"it ships\": verifying AI-generated code",
          "summary": "Build the release-evidence machine your AI-written project is missing — a ship check that runs the tests, parses what actually ran, refuses zero-test projects, and writes an honest delivery record.",
          "sha256": "88b1a775241a69b11b868bfae72e2954ad93b608789a9230a46431549444e9ed"
        },
        {
          "lang": "zh-CN",
          "path": "courses/verifying-ai-generated-code/COURSE_cn.md",
          "title": "从「能跑」到「能上线」：验证 AI 写的代码",
          "summary": "为你的 AI 项目补上缺失的发布证据机器——一个 ship check：运行测试、解析实际跑了什么、拒绝零测试项目，并写出诚实的交付记录。",
          "sha256": "fe2cc54cd9e37ddebb2c80c2cba52f40f5ce272566fd818c448b97e80c03c8ba"
        }
      ]
    },
    {
      "id": "course-verify-ship-l01",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/verifying-ai-generated-code/lessons/L01.md",
          "title": "\"It runs\" is not evidence",
          "summary": "Watch the starter bless a project with no tests and a project with a failing one — then want better.",
          "sha256": "96f3b58d3884b1e28b189c944aaaa94e8bbe900f1209f22bbb6269994f92445e"
        },
        {
          "lang": "zh-CN",
          "path": "courses/verifying-ai-generated-code/lessons/L01_cn.md",
          "title": "“能跑”不是证据",
          "summary": "看着 starter 给零测试的项目和有失败的项目都盖章放行——然后想要更好的东西。",
          "sha256": "8ec0c0cdd759871e4ce758cec41d077dc83c20d4864b596a062de47904e85e24"
        }
      ]
    },
    {
      "id": "course-verify-ship-l02",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/verifying-ai-generated-code/lessons/L02.md",
          "title": "Define what a release record must prove",
          "summary": "Command, exit code, parsed count and outcome, an unverified list, and a verdict that refuses zero-test projects.",
          "sha256": "d39ff4180a0dbabca31ea3d2a66fe9bb82a4f87c2830bc32f165ef1f93d90c62"
        },
        {
          "lang": "zh-CN",
          "path": "courses/verifying-ai-generated-code/lessons/L02_cn.md",
          "title": "定义发布记录必须证明什么",
          "summary": "命令、退出码、解析出的数量与结果、一份未验证清单，以及一个拒绝零测试项目的判定。",
          "sha256": "b57eab0170a48047ab0e56d61bb92aac5d17680346acf8e82c5b0293c42852f5"
        }
      ]
    },
    {
      "id": "course-verify-ship-l03",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/verifying-ai-generated-code/lessons/L03.md",
          "title": "Build the ship check, test by test",
          "summary": "Parsing, verdicts, the unverified list, atomic writes, exit codes — one failing group at a time.",
          "sha256": "6d0491d3f534add4b354e311fbaa957b73b0abd388e06fb20366dc830d95395a"
        },
        {
          "lang": "zh-CN",
          "path": "courses/verifying-ai-generated-code/lessons/L03_cn.md",
          "title": "按测试逐组构建 ship check",
          "summary": "解析、判定、未验证清单、原子写入、退出码——一次一组失败测试。",
          "sha256": "5013df14fbad78914a55dd9fac568aaa60809c33b13d180ab958be8e5cd62eb5"
        }
      ]
    },
    {
      "id": "course-verify-ship-l04",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/verifying-ai-generated-code/lessons/L04.md",
          "title": "Read the record like a skeptic",
          "summary": "Green, red, and no-tests mean different things — prove you can tell them apart and say what the record does not prove.",
          "sha256": "14326a8b19d5c8db834bcd3071598135b6cc8a11a9e8aac974a6bf3c8fc82ced"
        },
        {
          "lang": "zh-CN",
          "path": "courses/verifying-ai-generated-code/lessons/L04_cn.md",
          "title": "像怀疑者一样读记录",
          "summary": "绿、红、零测试是三件不同的事——证明你能分辨，并说清记录不能证明什么。",
          "sha256": "263921bf47ea5db21b98548442fe638794fb3ad9a84abef885b7ff66b94da919"
        }
      ]
    },
    {
      "id": "course-verify-ship-l05",
      "type": "course",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "courses/verifying-ai-generated-code/lessons/L05.md",
          "title": "Gate your next release",
          "summary": "Take the ship check to a project you own and make the record part of shipping.",
          "sha256": "9e664fc5e21c28b4ab5b1217c6be273d62f8ae139a774634c826bda4814c2bf6"
        },
        {
          "lang": "zh-CN",
          "path": "courses/verifying-ai-generated-code/lessons/L05_cn.md",
          "title": "给你的下一次发布装上门禁",
          "summary": "把 ship check 带到你自己的项目，让记录成为交付的一部分。",
          "sha256": "667023ea75adf0c47c97de409f8a364027f897975d377b7fd3a7b9d00cda9e80"
        }
      ]
    },
    {
      "id": "example-async-fetcher",
      "type": "example",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "examples/async-fetcher/README.md",
          "title": "Async Batch Fetcher with Bounded Concurrency and Retries",
          "summary": "Implement a resilient async task batcher with Semaphore concurrency control, exponential backoff, and error isolation.",
          "sha256": "1a309f791eb6b17b5323b59ddd8f5f27c6039751de6cb7c51df607cdd8e0ffd9"
        },
        {
          "lang": "zh-CN",
          "path": "examples/async-fetcher/README_cn.md",
          "title": "带受控并发与重试的异步抓取器",
          "summary": "使用 Semaphore 信号量控制并发、指数退避重试与错误隔离，实现韧性异步任务批处理。",
          "sha256": "ee9a13cb4756abe75a19e28ba3b2ce837764f24dfdce1064e9bff765a139fcce"
        }
      ]
    },
    {
      "id": "example-mcp-server",
      "type": "example",
      "content_version": 2,
      "status": "reviewed",
      "reviewed_on": "2026-09-06",
      "locales": [
        {
          "lang": "en-US",
          "path": "examples/mcp-server/README.md",
          "title": "Model Context Protocol (MCP) Tool Server",
          "summary": "Build a stateless 2026-07-28 MCP tool server with JSON-RPC 2.0 dispatch, no initialize handshake, schema validation, error isolation, and the input_required round-trip.",
          "sha256": "bab7ca867883f2380acb131351634462ceacfcb397e2b6758f0ee460d3f977ab"
        },
        {
          "lang": "zh-CN",
          "path": "examples/mcp-server/README_cn.md",
          "title": "Model Context Protocol (MCP) 工具服务",
          "summary": "构建符合 2026-07-28 无状态规范的 MCP 工具服务，实现无需 initialize 握手的 JSON-RPC 2.0 分发、参数校验、错误隔离与 input_required 多轮交互。",
          "sha256": "03a6ec203daa98ee6af75a6bda99e9297e278424b6b813480b1bcfb42cc1c347"
        }
      ]
    },
    {
      "id": "example-pydantic-validation",
      "type": "example",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "examples/pydantic-validation/README.md",
          "title": "Validate Untrusted Boundary Payloads",
          "summary": "Parse, sanitize, and validate messy external payloads with field normalization and structured error contracts.",
          "sha256": "99e3fedc6e47fd915a24198cbe166ddafd51e4b6d3a4c7f1929bd56b2d27efa9"
        },
        {
          "lang": "zh-CN",
          "path": "examples/pydantic-validation/README_cn.md",
          "title": "验证不可信边界请求体",
          "summary": "使用字段规范化与结构化错误契约，清洗并验证混乱的外部数据载荷。",
          "sha256": "1e0f741e16df66623d58b6a9c0bf5128ebfc6fc9fe219f5287a683f647c232b6"
        }
      ]
    },
    {
      "id": "fix-a-python-bug",
      "type": "playbook",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "playbooks/fix-a-bug/README.md",
          "title": "Fix a Python Bug with a Regression Test",
          "summary": "Reproduce the behavior, constrain the cause, make the smallest fix, and prove the regression stays fixed.",
          "sha256": "1b97bcb5a4fd2fe8dc5863dce80555459a1e359732a710990107e66c492028b2"
        },
        {
          "lang": "zh-CN",
          "path": "playbooks/fix-a-bug/README_cn.md",
          "title": "用回归测试修复 Python Bug",
          "summary": "复现行为、缩小原因、完成最小修复，并证明回归问题不会再次出现。",
          "sha256": "cc770168300aa25cd4e42a00a7157a06aaf9a4c713678effdeb6b737a94e865f"
        }
      ]
    },
    {
      "id": "integrate-an-external-api",
      "type": "playbook",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "playbooks/integrate-an-external-api/README.md",
          "title": "Integrate an External API",
          "summary": "Wrap a third-party API behind a typed boundary with safe credentials, timeouts, retries, and deterministic tests.",
          "sha256": "412f1185e8e456b921ba284e898419bb35ae3bfb520cdc3663897506244f6cef"
        },
        {
          "lang": "zh-CN",
          "path": "playbooks/integrate-an-external-api/README_cn.md",
          "title": "接入外部 API",
          "summary": "用类型边界封装第三方 API，并安全处理凭据、超时、重试和确定性测试。",
          "sha256": "900582abc309374ecc190b29c117208a09bbd55e136f1adcc6d95ecac04114a4"
        }
      ]
    },
    {
      "id": "manage-database-migrations",
      "type": "playbook",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "playbooks/manage-database-migrations/README.md",
          "title": "Manage Database Schema Migrations",
          "summary": "Plan, execute, and verify reversible database migrations with zero-downtime compatibility and rollback safety.",
          "sha256": "82a62d3172e28bf98a32a2a3df8f1ba2e054df83264479258b789e13d95428ba"
        },
        {
          "lang": "zh-CN",
          "path": "playbooks/manage-database-migrations/README_cn.md",
          "title": "管理数据库架构迁移",
          "summary": "规划、执行并验证具备零停机兼容性与回滚安全性的可逆数据库迁移。",
          "sha256": "5458037a8359c85aa16abe22696a21054e040f04bdc51a0c1dda4304e4585d8a"
        }
      ]
    },
    {
      "id": "mcp-2026-07-28-migration",
      "type": "guide",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-06",
      "locales": [
        {
          "lang": "en-US",
          "path": "guides/mcp/migrate-2026-07-28.md",
          "title": "Migrate a Python MCP server to the 2026-07-28 specification",
          "summary": "Update a Python MCP server for the stateless 2026-07-28 specification by removing the initialize handshake, adopting the input_required round-trip, dropping deprecated features, and hardening authorization.",
          "sha256": "3e64c297b0449769d42b00302e8c20d24f470999f3360b1219927da4264f310f"
        },
        {
          "lang": "zh-CN",
          "path": "guides/mcp/migrate-2026-07-28_cn.md",
          "title": "将 Python MCP 服务端迁移到 2026-07-28 规范",
          "summary": "面向 2026-07-28 无状态规范更新 Python MCP 服务端，移除 initialize 握手、采用 input_required 多轮交互、放弃废弃特性并强化授权。",
          "sha256": "cc5360996f1d45cd8155dd1a0cd7a6c418d988247c54ba31ca0d5efaa1e81c8f"
        }
      ]
    },
    {
      "id": "path-da-capstone",
      "type": "path",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "paths/data-analysis/modules/capstone.md",
          "title": "Capstone: verified analysis of a real dataset",
          "summary": "Data Analysis path capstone — end-to-end clean, explore, and report on orders.csv with verify.py checking the numbers.",
          "sha256": "814507300283d9c7c27409138e35ebc57ab85dcc04a1f468e11b486783b580f1"
        },
        {
          "lang": "zh-CN",
          "path": "paths/data-analysis/modules/capstone_cn.md",
          "title": "综合项目：真实数据集的验证分析",
          "summary": "数据分析路线综合项目——在 orders.csv 上端到端完成清洗、探索与报告，verify.py 校验数字。",
          "sha256": "5f2af0b8b6c384e5fd430e603df573bee3c8cdfb564c500ad7d733d813b4778e"
        }
      ]
    },
    {
      "id": "path-foundation-challenge",
      "type": "path",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "paths/foundation/modules/route-challenge.md",
          "title": "Route challenge: dual-agent, double-verified",
          "summary": "Foundation path capstone — run the same task through Claude Code and Codex CLI and verify both outputs yourself.",
          "sha256": "12390205b366d179afd34fc60fc557ed3aca53d10f6474a73d922b2cbbf3045a"
        },
        {
          "lang": "zh-CN",
          "path": "paths/foundation/modules/route-challenge_cn.md",
          "title": "路线挑战：双 Agent、双重验证",
          "summary": "基础路线收官挑战——同一任务分别用 Claude Code 与 Codex CLI 完成并亲手双重验证。",
          "sha256": "86add318cc3094155f0a3f05eb05947d351af312c7f78f777f290be953cf27ab"
        }
      ]
    },
    {
      "id": "path-foundation-m0",
      "type": "path",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-12",
      "locales": [
        {
          "lang": "en-US",
          "path": "paths/foundation/modules/m0-orientation.md",
          "title": "The agent tool landscape",
          "summary": "Foundation path module 0 — orientation on Claude Code, Codex CLI, and Cursor; install one agent and observe its evidence habits.",
          "sha256": "2c40a01bff3ab9cf40c6f453201a381d4a4d02ebc7246af46984b2548496f40f"
        },
        {
          "lang": "zh-CN",
          "path": "paths/foundation/modules/m0-orientation_cn.md",
          "title": "Agent 工具生态总览",
          "summary": "基础路线模块 0——Claude Code、Codex CLI、Cursor 生态导览；装一个 Agent 并观察它的证据习惯。",
          "sha256": "4d6b4ecbc2eb0d0ef5c2e9522466f0c9ace056bd4ad8db4a9e116aa5916e64bb"
        }
      ]
    },
    {
      "id": "product-slug-example",
      "type": "example",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "examples/product-slug/README.md",
          "title": "Three-minute AI-coding change",
          "summary": "Reproduce a Python text-boundary bug, make a bounded fix, and verify it with the standard library.",
          "sha256": "8f240817e26384924c624ce4cc2e563fe17909d60e179d647f33b97a61f8b2b5"
        },
        {
          "lang": "zh-CN",
          "path": "examples/product-slug/README_cn.md",
          "title": "3 分钟完成一次 AI Coding 修改",
          "summary": "复现 Python 文本边界 Bug，完成范围明确的修复，并只用标准库验证结果。",
          "sha256": "698ae339a14f4b56b59accd1a03eb29028b663495613b2bfb6fff2ae8663ed0b"
        }
      ]
    },
    {
      "id": "python-ai-coding-workflow",
      "type": "guide",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "guides/ai-coding/workflow.md",
          "title": "Use Python Well with AI Coding",
          "summary": "A contract-first workflow for using coding agents to make small, testable, and safe Python changes.",
          "sha256": "aa29ed9752b83991f93a5a4c7d5282a514c67cf4108d56c147ea2d6a970c0fd9"
        },
        {
          "lang": "zh-CN",
          "path": "guides/ai-coding/workflow_cn.md",
          "title": "用 AI Coding 写好 Python",
          "summary": "一套契约优先的工作方法，用 coding agent 完成小而可测、能够安全交付的 Python 修改。",
          "sha256": "5e3e4534f557a37321ab9e1eb795bfff1a36d2577e544ccd1c23f12ed1c38860"
        }
      ]
    },
    {
      "id": "python-async-patterns",
      "type": "guide",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "guides/python-engineering/async-patterns.md",
          "title": "Reliable Async Python Patterns and Pitfalls",
          "summary": "Build resilient concurrent Python applications by avoiding common async antipatterns and managing task lifecycles.",
          "sha256": "b883d9dcc72ac355812a6880592c1913eff34cd0d1b48617b004c3bf22248000"
        },
        {
          "lang": "zh-CN",
          "path": "guides/python-engineering/async-patterns_cn.md",
          "title": "异步 Python 可靠模式与避坑指南",
          "summary": "通过避免常见异步反模式与规范管理任务生命周期，构建高韧性的并发 Python 应用。",
          "sha256": "614ac9617cc77b94ba8030a9c6490b862b83d2e4bf8c7679109f6c6cd67113ed"
        }
      ]
    },
    {
      "id": "python-modern-typing",
      "type": "guide",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "guides/python-engineering/modern-typing.md",
          "title": "Modern Python Typing in Practice",
          "summary": "Use explicit Python types as machine-checkable contracts for reliable AI-assisted engineering.",
          "sha256": "fa69b55d3b122c5086e1836d4404c3b34181608fabe9a4345751040a2b03a54f"
        },
        {
          "lang": "zh-CN",
          "path": "guides/python-engineering/modern-typing_cn.md",
          "title": "现代 Python 类型系统实战",
          "summary": "将明确的 Python 类型作为机器可读的契约，指导可靠的 AI 辅助编程与工程交付。",
          "sha256": "1fb7f63ea5675d58102c3d8178d1ffbf9720e69ebf9083036372ae1ddedeabab"
        }
      ]
    },
    {
      "id": "python-product-quality",
      "type": "guide",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "guides/python-engineering/product-quality.md",
          "title": "Build a Python Product That Can Be Changed Safely",
          "summary": "A practical quality model for moving from a useful script to an operable Python product.",
          "sha256": "6ab42b0a271d22c4c250e33d4d76d2a441f2b3c258ec253c36bfc2ddb308f0fd"
        },
        {
          "lang": "zh-CN",
          "path": "guides/python-engineering/product-quality_cn.md",
          "title": "构建能够持续修改的 Python 产品",
          "summary": "从有用脚本走向可运行、可维护 Python 产品的一套实用质量模型。",
          "sha256": "94fce6390a97e84e65628bf77b4ae6c560ef726879464e4a68adf4326f0c5891"
        }
      ]
    },
    {
      "id": "setup-structured-logging",
      "type": "playbook",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "playbooks/setup-structured-logging/README.md",
          "title": "Set Up Production Structured Logging",
          "summary": "Configure structured JSON logging with context propagation, sensitive data redaction, and environment isolation.",
          "sha256": "9ef0a7edc6a4d08c2c216706a29ada10f677bc08c516f5c5dca7161b4204167e"
        },
        {
          "lang": "zh-CN",
          "path": "playbooks/setup-structured-logging/README_cn.md",
          "title": "搭建生产级结构化日志",
          "summary": "配置具备上下文贯穿、敏感数据脱敏与环境隔离的 JSON 结构化日志体系。",
          "sha256": "a1f9fd0417c8d1f51a272e0b4f6fd5f0d401f505d84887ae7ee2c5343706af11"
        }
      ]
    },
    {
      "id": "ship-a-python-release",
      "type": "playbook",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "playbooks/ship-a-release/README.md",
          "title": "Ship a Python Release",
          "summary": "Produce a traceable package or service release and verify the real deployed behavior and rollback path.",
          "sha256": "8c9b410dbfc088ac8abba7f44cd87463d3d829a81801717f61b80069bbeb54b7"
        },
        {
          "lang": "zh-CN",
          "path": "playbooks/ship-a-release/README_cn.md",
          "title": "发布 Python 版本",
          "summary": "交付可追踪的包或服务版本，并验证真实线上行为与回退路径。",
          "sha256": "faa5387b7a6f394f22a16d4d4f4a3aaaeb4766018eb6c7a086c2533f7af5b8e9"
        }
      ]
    },
    {
      "id": "structured-pipeline-example",
      "type": "example",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "examples/structured-pipeline/README.md",
          "title": "Resilient batch data pipeline",
          "summary": "Build an isolated, bounded data batch processing pipeline with error recovery using the standard library.",
          "sha256": "cbfe3b304da301b503229a4043092eea39e5ca531049fb074b672c64e2ea7cb6"
        },
        {
          "lang": "zh-CN",
          "path": "examples/structured-pipeline/README_cn.md",
          "title": "鲁棒批处理数据流水线",
          "summary": "使用标准库实现具备错误隔离、类型校验与批处理统计的鲁棒数据流水线。",
          "sha256": "be0baacb411a0d0661da5b24136343cb26b862d3aaeb39ab8b603cc7598f8cbc"
        }
      ]
    },
    {
      "id": "upgrade-python-dependencies",
      "type": "playbook",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "playbooks/upgrade-dependencies/README.md",
          "title": "Upgrade Python Dependencies",
          "summary": "Upgrade dependencies in a bounded change with lockfile, compatibility, security, and runtime evidence.",
          "sha256": "d4a7f7e5972e3a6cc953a1d07475a8064ae2d6df0c47b24296584246b67584b1"
        },
        {
          "lang": "zh-CN",
          "path": "playbooks/upgrade-dependencies/README_cn.md",
          "title": "升级 Python 依赖",
          "summary": "在边界明确的修改中，用锁文件、兼容性、安全和运行证据完成依赖升级。",
          "sha256": "755df574181670b18a6ddbd1a24d2949b0a56c31790109e1d26aa4b6bdffdf27"
        }
      ]
    },
    {
      "id": "write-llm-evals",
      "type": "playbook",
      "content_version": 1,
      "status": "reviewed",
      "reviewed_on": "2026-09-02",
      "locales": [
        {
          "lang": "en-US",
          "path": "playbooks/write-llm-evals/README.md",
          "title": "Write Deterministic Evals for LLMs and Agents",
          "summary": "Build regression test suites for LLM prompt changes and tool-calling agents with golden datasets and schema assertions.",
          "sha256": "d96648fa2e4a3a5c73bf6a83ea853f9b4757416823b05c088d03354c9ed4d5b1"
        },
        {
          "lang": "zh-CN",
          "path": "playbooks/write-llm-evals/README_cn.md",
          "title": "为大模型与 Agent 编写确定性评测",
          "summary": "结合黄金测试集与 Schema 断言，为 Prompt 调整与工具调用 Agent 构建防劣化回归测试套件。",
          "sha256": "516a779f37b4f36b86be0807125f391bf08d6ea7d9270969e609331ca153c0e2"
        }
      ]
    }
  ]
}