release: 0.0.4 phase A — courses, paths, claim codes, DA modules live

Author: xxg1413

.github/workflows/validate.yml

@@ -61,3 +61,5 @@ jobs:
 
       - name: Verify course folders
         run: .venv/bin/python tools/verify_courses.py
+      - name: Verify learning-path contracts
+        run: .venv/bin/python tools/verify_paths.py

.gitignore

@@ -46,3 +46,6 @@ reports/
 # Course scenario output written by learners running report_tool.py
 courses/*/scenario/*/report.json
 courses/*/scenario/*/report.json.tmp
+courses/*/out/
+paths/*/capstone/out/
+courses/*/scenario/*/results.json

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help check export render manifest test verify courses lint typecheck all
+.PHONY: help check export render manifest test verify courses paths lint typecheck all
 
 PYTHON ?= python3
 
@@ -11,6 +11,7 @@ help:
 	@echo "  make test       - Run pytest test suite"
 	@echo "  make verify     - Verify all runnable examples"
 	@echo "  make courses    - Verify all course folders"
+	@echo "  make paths      - Verify all learning-path contracts"
 	@echo "  make all        - Regenerate all exports and run all checks and tests"
 
 check:
@@ -20,6 +21,7 @@ check:
 	$(PYTHON) tools/build_content_manifest.py --check
 	$(PYTHON) tools/verify_examples.py
 	$(PYTHON) tools/verify_courses.py
+	$(PYTHON) tools/verify_paths.py
 
 export:
 	$(PYTHON) tools/export_catalog.py --target both
@@ -39,4 +41,7 @@ verify:
 courses:
 	$(PYTHON) tools/verify_courses.py
 
+paths:
+	$(PYTHON) tools/verify_paths.py
+
 all: export render manifest test check

README.md

@@ -6,11 +6,12 @@
 
 [English](README.md) · [中文](README_cn.md) · [🌐 Online Portal](https://flypython.com)
 
-> **New — agent-taught courses with objective verification.** Download a
-> folder from [`courses/`](courses/), open it in your coding agent, and say
-> *"start lesson 1"*. Every course ends with a `verify.py` command that
-> proves what you built. Continue the same journey on
-> [flypython.com](https://flypython.com/).
+> **Challenge courses with objective verification.** Pick a folder from
+> [`courses/`](courses/), solve the contract in `TASK.md` with your coding
+> agent as the tool, and prove it with `verify.py` — which prints a claim
+> code per checkpoint. Prefer a guided path? `COURSE.md` still runs an
+> agent-taught mode, and [`paths/`](paths/) sequences courses into badge
+> routes. Continue on [flypython.com](https://flypython.com/).
 
 FlyPython is a practical, bilingual repository for writing good Python and
 turning it into products people can rely on. It combines AI-coding methods,
@@ -41,7 +42,7 @@ to a coding agent (Cursor, Windsurf, Claude Code, Copilot) and make the starter
 
 | Goal | Start here | What you will produce |
 | --- | --- | --- |
-| Learn hands-on with your coding agent | [Agent-taught courses](courses/) | A verified project: task contract → bounded change → `verify.py` evidence |
+| Learn by solving challenges | [Challenge courses](courses/) · [Learning paths](paths/) | A verified project + checkpoint claim codes from `verify.py` |
 | Write and change Python safely | [AI Coding workflow](guides/ai-coding/workflow.md) | A bounded change with explicit context and evidence |
 | Turn Python into a reliable product | [Product quality guide](guides/python-engineering/product-quality.md) | A tested, observable, reversible product path |
 | Finish a recurring engineering task | [Playbooks](playbooks/README.md) | A bug fix, API change, integration, dependency upgrade, or release |

README_cn.md

@@ -38,7 +38,7 @@ python examples/product-slug/verify.py solution
 
 | 目标 | 从这里开始 | 最终产出 |
 | --- | --- | --- |
-| 跟随编码 Agent 动手实战 | [Agent 授课课程](courses/) | 一个通过验证的项目：任务契约 → 边界修改 → `verify.py` 证据 |
+| 解题式动手实战 | [挑战课程](courses/) · [学习路线](paths/) | 一个通过验证的项目 + `verify.py` 的检查点认领码 |
 | 安全地编写和修改 Python | [AI Coding 工作方法](guides/ai-coding/workflow_cn.md) | 上下文明确、有证据的边界修改 |
 | 把 Python 变成可靠产品 | [产品质量指南](guides/python-engineering/product-quality_cn.md) | 可测试、可观测、可回退的产品路径 |
 | 完成反复出现的工程任务 | [Playbook](playbooks/README_cn.md) | Bug 修复、API 修改、外部集成、依赖升级或发布 |

content-manifest.json

@@ -50,7 +50,7 @@
     {
       "id": "course-agent-rules",
       "type": "course",
-      "content_version": 1,
+      "content_version": 2,
       "status": "reviewed",
       "reviewed_on": "2026-09-12",
       "locales": [
@@ -59,14 +59,14 @@
           "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": "41aaa6f0681ea5a40263dd5372f0d4bf402c947b6727486c4ff5ba7f0a2a9cee"
+          "sha256": "d7dd7ed26db699c576046c2e103d6d94a2299805dca0d6b6153a4d6ccafcba6e"
         },
         {
           "lang": "zh-CN",
           "path": "courses/agent-rules-single-source/COURSE_cn.md",
           "title": "Agent 规则的单一真源",
           "summary": "不再同时维护彼此打架的 AGENTS.md、CLAUDE.md 与 .cursorrules——亲手构建一个能证明仓库只有一处规则真源的检查器，由你的编码 Agent 授课。",
-          "sha256": "5b90d5556cdff097812ef25ab9134b3939f677f6106c162c28ea15f1986091ee"
+          "sha256": "bf81ca5856328e1ef4f204707ad002f49704486ab2589d3b52cf366285e8222f"
         }
       ]
     },
@@ -188,7 +188,7 @@
     {
       "id": "course-claude-code",
       "type": "course",
-      "content_version": 1,
+      "content_version": 2,
       "status": "reviewed",
       "reviewed_on": "2026-09-12",
       "locales": [
@@ -197,14 +197,14 @@
           "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": "048b8f210dedc9d60bffb98a8347c89586295e5be3c16abd6be20ea50ef48563"
+          "sha256": "50165b3b9aa9979d565ab34057977b7b7264cec739be1900ec3988876731c132"
         },
         {
           "lang": "zh-CN",
           "path": "courses/hands-on-python-with-claude-code/COURSE_cn.md",
           "title": "用 Claude Code 实战 Python",
           "summary": "一门由 Agent 授课的课程：从下载课程文件夹到交付一个经过测试与验证的 Python 报表工具——包括任务契约、最小变更和客观的通过/失败证据。",
-          "sha256": "96c3287051153c42678be558538b9be16cc9835296fc8947711e48ea6ee0a145"
+          "sha256": "8c73c31d5901ff9bbe9e79e97342688b6737657ab05f1b71a767125ca398e2d3"
         }
       ]
     },
@@ -326,7 +326,7 @@
     {
       "id": "course-codex-cli",
       "type": "course",
-      "content_version": 1,
+      "content_version": 2,
       "status": "reviewed",
       "reviewed_on": "2026-09-12",
       "locales": [
@@ -335,14 +335,14 @@
           "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": "aa223ff4356ab25c32f55344362a5133fcba0f25851e05c6bd3c6bde9189a8aa"
+          "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": "4a31ae97c205ee1e28008f1149aadf1488d4d305176678da1c475475174944d5"
+          "sha256": "bbdf5d8a71d8243f1cb7a3c30d2aa4ddb656cb932d36aaae3d543e3b5f7ea3c2"
         }
       ]
     },
@@ -462,25 +462,94 @@
       ]
     },
     {
-      "id": "course-mcp-tools",
+      "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-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-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-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": "bab5f79922a15ac52c736a549bc69a392718fff274e20cae0ad7c3428e00c4f6"
+          "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": "a11236fcd046e9e84e54b22ebcce7e01b925ef71f12014ebb1f1b8bcb536cb63"
+          "sha256": "d125779e096e3b76b97caf51db25577869ee9fadd23447e02f9aea1d5d5066ee"
         }
       ]
     },
@@ -602,7 +671,7 @@
     {
       "id": "course-verify-ship",
       "type": "course",
-      "content_version": 1,
+      "content_version": 2,
       "status": "reviewed",
       "reviewed_on": "2026-09-12",
       "locales": [
@@ -611,14 +680,14 @@
           "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": "7765ea8ad032cc16eb5d34b0f65401c28c8c56cc1f44c496c9cc298f44cb7cd3"
+          "sha256": "88b1a775241a69b11b868bfae72e2954ad93b608789a9230a46431549444e9ed"
         },
         {
           "lang": "zh-CN",
           "path": "courses/verifying-ai-generated-code/COURSE_cn.md",
           "title": "从「能跑」到「能上线」：验证 AI 写的代码",
           "summary": "为你的 AI 项目补上缺失的发布证据机器——一个 ship check：运行测试、解析实际跑了什么、拒绝零测试项目，并写出诚实的交付记录。",
-          "sha256": "55eda6add807fff2147c7829da190e8c7cdfdbb537d3dcfdb85b461e2c0a21f2"
+          "sha256": "fe2cc54cd9e37ddebb2c80c2cba52f40f5ce272566fd818c448b97e80c03c8ba"
         }
       ]
     },
@@ -898,6 +967,75 @@
         }
       ]
     },
+    {
+      "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",

courses/agent-rules-single-source/COURSE.md

@@ -4,9 +4,15 @@ type: course
 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.
 lang: en-US
-content_version: 1
+content_version: 2
 status: reviewed
 reviewed_on: 2026-09-12
+badge:
+  id: course-agent-rules
+  name_en: Measure the drift
+  name_zh: 规则漂移检测
+  requires: All five checkpoints claimed (L01–L05)
+course_id: course-agent-rules
 ---
 
 # One source of truth for agent rules
@@ -58,8 +64,17 @@ and the AGENTS.md guide on flypython.com), multi-repo setups, or
 machine-policy enforcement. The checker is deliberately narrow: one
 directory, three file names, one truth.
 
+
+## Badge contract
+
+- Badge: **Measure the drift Badge** (badge id `course-agent-rules`) - earned by claiming all five checkpoints.
+- Challenges: L01-L05 checkpoints, 10 points each; +50 course-badge bonus when all five are claimed on flypython.com.
+- Evidence: `python verify.py progress` - L03 (bounded change) and L04 (verify & review) are objectively gated by the suite; L01/L02/L05 are learner-attested.
+- Submission: each passed checkpoint prints a deterministic claim code; record it on flypython.com against your account. Self-reported evidence, never a certificate.
+
 ## Folder map
 
+
 `COURSE.md`/`COURSE_cn.md`, bilingual `lessons/`, `scenario/` repositories,
 `TASK.md`/`TASK_cn.md` (the code contract), `starter/`, `solution/`, `tests/`
 (11 tests), `verify.py`, `REVIEW.md`.