docs: fix full documentation review findings across the repository

Licensing and entry points:
- CONTRIBUTING permissions now match the dual MIT/CC-BY LICENSE
- README_cn hero rewritten for the challenge-platform narrative (TASK.md
  contracts, verify.py claim codes, paths badge routes)
- llms.txt: fix four template paths, add the three DA courses, refresh
  tagline and Radar description

Indexes and governance docs:
- README/CONTRIBUTING/AGENTS: complete the CI check list
  (verify_courses, verify_paths, --target both), add courses/, paths/,
  radar.json to the structure diagram, dependency-aware course contract
- CHANGELOG: record post-0.1.0 0.0.4 phase A under [Unreleased]
- CONSUMING: document radar.json as the third pinned export
- repo-plan-0.0.4: mark FP-334 done (v0.1.0)

Courses and examples:
- mcp-server-in-python: fix stale examples/mcp-server verify path in
  TASK pair; expect-failure now requires all named failures; REVIEW
  wording matches the actual scenario layout
- da-report: remove the unused pandas gate (verify.py, requirements,
  COURSE pair) — the course is stdlib-only
- agent-rules L01 pair: add the missing verifier command
- product-slug: fix punctuation-before-collapse ordering so removed
  punctuation cannot create duplicate separators; regression test added
- async-fetcher: solution uses asyncio.TaskGroup; TASK pair states the
  total-attempts retry semantics
- structured-pipeline: solution actually iterates in batch_size batches
- pydantic-validation: honest stdlib-by-design note (EN+ZH) and accurate
  verify message
- align DA badge ids to the course- prefix convention

Bilingual parity and paths:
- templates: add CODE_REVIEW/IMPLEMENTATION_PLAN CN pairs and link them
  from both indexes; fix EVAL_RECORD/AGENT_RULES CN drift
- guides: fix async-patterns_cn example, modern-typing_cn dropped
  clause, migrate guide EN em-dash sentence
- playbooks: CN footers deep-link the same resources anchors as EN
- paths: add README pair, resolve undefined C1-C4 labels to course
  slugs, link the index from the main READMEs

Hygiene:
- drop committed course .venv/__pycache__ artifacts, ignore
  .pytest_cache, exempt starter scaffolding imports from ruff F401

Validation: pytest 136 passed; ruff clean; catalog/radar/README/manifest
checks current; 5 examples, 8 courses, 2 paths verified.

Author: xxg1413

.gitignore

@@ -49,3 +49,6 @@ courses/*/scenario/*/report.json.tmp
 courses/*/out/
 paths/*/capstone/out/
 courses/*/scenario/*/results.json
+
+# Test caches
+.pytest_cache/

AGENTS.md

@@ -35,12 +35,17 @@ reviewed catalog data, and stable public JSON contracts.
   an AI coding agent from the files themselves: `COURSE.md` (metadata plus the
   teaching contract: audience, prerequisites, exact tool and version,
   lesson order, teaching-style rules, when to stop, how to use `verify.py`,
-  and what the course does not cover), `lessons/L01.md` with `L01_cn.md`
+  and what the course does not cover) with `id: course-<slug>` and `badge`
+  frontmatter, `lessons/L01.md` with `L01_cn.md`
   pairs (objective, exercise, checkpoint, expected evidence), `scenario/`
   data files for each skin, `TASK.md`/`TASK_cn.md` (task contract),
-  `starter/` and `solution/` runnable pairs, stdlib-only `verify.py` that
-  fails on `starter` and passes on `solution`, and `REVIEW.md` recording the
-  maintainer run-through (date, tool, version, observed agent deviations).
+  `starter/` and `solution/` runnable pairs, a self-contained `verify.py`
+  that fails on `starter` and passes on `solution`, exposes deterministic
+  claim codes through `verify.py progress` (five checkpoints), and runs on
+  the standard library unless the course ships its own `requirements.txt`
+  (as the pandas/matplotlib data-analysis courses do), and `REVIEW.md`
+  recording the maintainer run-through (date, tool, version, observed agent
+  deviations).
   A course is incomplete until every lesson ships EN+ZH in the same change;
   `COURSE.md` must name the exact tool version it was taught with, and a tool
   major release triggers re-review. Never claim guaranteed learning outcomes.
@@ -57,8 +62,9 @@ reviewed catalog data, and stable public JSON contracts.
   verify them with `python tools/render_readmes.py --check`.
 - Regenerate `content-manifest.json` and verify it with
   `python tools/build_content_manifest.py --check`.
-- Verify every runnable example with `python tools/verify_examples.py` and
-  every course folder with `python tools/verify_courses.py`.
+- Verify every runnable example with `python tools/verify_examples.py`,
+  every course folder with `python tools/verify_courses.py`, and every
+  learning path with `python tools/verify_paths.py`.
 - Website consumers must pin a full repository commit and verify the catalog
   checksum. Do not make production builds depend on a moving branch.
 - Keep external-link checks read-only, rate-limited, retryable, and blocked from

CHANGELOG.md

@@ -2,6 +2,31 @@
 
 This file records notable catalog-contract and maintenance changes.
 
+## [Unreleased]
+
+0.0.4 phase A — challenge-platform rework on top of 0.1.0.
+
+### Added
+
+- Per-checkpoint claim codes, badge frontmatter contracts, and the
+  deterministic `verify.py progress` subcommand (FP-411/412/415), enforced
+  by `tools/verify_courses.py`.
+- The data-analysis course track: `da-eda`, `da-visualization`, and
+  `da-report` (EN+ZH), each with pandas/matplotlib `requirements.txt` where
+  needed and a stdlib-only report capstone.
+- `paths/` learning paths sequencing courses into badge routes, plus
+  `tools/verify_paths.py` enforcing the path contract (FP-413/416/417/418,
+  wired into the Makefile and the validation workflow).
+- `content-manifest.json` path entries (`type: "path"`) for the website.
+- Checkpoint hints, the branch-path contract, and agent-solvability review
+  records across all eight courses (2026-09-13).
+
+### Changed
+
+- Repository narrative moved from agent-taught courses to challenge courses
+  with `TASK.md` contracts and `verify.py` claim codes; `COURSE.md` remains
+  the guided mode. README, README_cn, and `llms.txt` now reflect it.
+
 ## [0.1.0] - 2026-09-12
 
 First versioned release: agent-taught courses, the Project Radar

CONTRIBUTING.md

@@ -11,10 +11,12 @@ Read the [curation policy](docs/CURATION_POLICY.md) before contributing.
 
 ## Permissions
 
-This repository currently does not grant a general license to reuse its content
-or code. Public visibility is not permission to copy, redistribute, or relicense
-repository material. Contributors must submit only material they have the right
-to submit and retain required third-party notices.
+This repository is dual-licensed as described in [LICENSE](LICENSE): code
+(examples, tools, templates, course starters/solutions/verifiers) under the MIT
+License, and written content (guides, playbooks, lessons, catalog records,
+READMEs) under CC BY 4.0 with attribution "FlyPython (flypython.com)".
+Contributors must submit only material they have the right to submit and retain
+required third-party notices; a file's own license header, when present, wins.
 
 ## Propose a change
 
@@ -23,6 +25,7 @@ Use the matching issue form before a larger change:
 - **Resource proposal** for a new official source.
 - **Project proposal** for a current Python project that should receive human
   review for Project Radar.
+- **Course feedback** for running a course or reporting a course problem.
 - **Broken link** for an unreachable or replaced resource.
 - **Security report** for a vulnerability; follow [SECURITY.md](SECURITY.md)
   instead of opening a public issue.
@@ -86,10 +89,12 @@ Run the same deterministic checks as CI:
 ```bash
 python -m pytest
 python tools/validate_catalog.py
-python tools/export_catalog.py --check
+python tools/export_catalog.py --check --target both
 python tools/render_readmes.py --check
 python tools/build_content_manifest.py --check
 python tools/verify_examples.py
+python tools/verify_courses.py
+python tools/verify_paths.py
 ```
 
 Maintainers can run the networked link audit through GitHub Actions. For a

README.md

@@ -10,7 +10,7 @@
 > [`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
+> agent-taught mode, and [`paths/`](paths/README.md) sequences courses into badge
 > routes. Continue on [flypython.com](https://flypython.com/).
 
 FlyPython is a practical, bilingual repository for writing good Python and
@@ -25,7 +25,8 @@ versions into a browsable learning experience.
 
 ## Start in three minutes
 
-No installation is required beyond Python 3.11+:
+No installation is required beyond Python 3.11+ (development pins 3.12
+through `.python-version`):
 
 ```bash
 git clone https://github.com/flypythoncom/python.git
@@ -42,7 +43,7 @@ to a coding agent (Cursor, Windsurf, Claude Code, Copilot) and make the starter
 
 | Goal | Start here | What you will produce |
 | --- | --- | --- |
-| Learn by solving challenges | [Challenge courses](courses/) · [Learning paths](paths/) | A verified project + checkpoint claim codes from `verify.py` |
+| Learn by solving challenges | [Challenge courses](courses/) · [Learning paths](paths/README.md) | 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 |
@@ -175,13 +176,16 @@ catalog/
   paths.yml          bilingual learning-path definitions
   resources/         one reviewed resource per YAML file
   projects/          human-review queue for current Python projects
+courses/              challenge courses with TASK.md contracts and verify.py claim codes
+paths/                learning paths sequencing courses into badge routes
 guides/               Python engineering and AI-coding methods
 playbooks/            repeatable task procedures and definitions of done
 examples/             small runnable projects with automated verification
 templates/            task, plan, review, and verification starters
 schema/
   *.schema.json       versioned machine-readable contracts
 catalog.json         deterministic public export for consumers
+radar.json            deterministic Project Radar export for consumers
 content-manifest.json versioned paths, summaries, and checksums for the website
 tools/                generation, validation, example, and link-audit commands
 tests/                content consistency and behavior tests
@@ -227,10 +231,12 @@ Run the deterministic checks:
 ```bash
 python -m pytest
 python tools/validate_catalog.py
-python tools/export_catalog.py --check
+python tools/export_catalog.py --check --target both
 python tools/render_readmes.py --check
 python tools/build_content_manifest.py --check
 python tools/verify_examples.py
+python tools/verify_courses.py
+python tools/verify_paths.py
 ```
 
 After changing catalog sources, regenerate the public export before running the

README_cn.md

@@ -6,10 +6,11 @@
 
 [English](README.md) · [中文](README_cn.md) · [🌐 官方在线门户](https://flypython.com)
 
-> **新——由 Agent 授课、带客观验证的实战课程。** 从 [`courses/`](courses/) 下载一个
-> 文件夹，在你的编码 Agent 中打开，说一句*“开始第 1 课”*。每门课程都以一条
-> `verify.py` 命令收尾，证明你确实做出了什么。同一旅程可继续在
-> [flypython.com](https://flypython.com/) 上进行。
+> **带客观验证的挑战课程。** 从 [`courses/`](courses/) 挑一个文件夹，把
+> `TASK.md` 中的契约交给你的编码 Agent 去解决，并用 `verify.py` 证明结果——
+> 它会在每个检查点打印一个认领码。想要有人带？`COURSE.md` 仍支持 Agent
+> 授课模式，[`paths/`](paths/README.md) 则把课程串成徽章路线。可继续在
+> [flypython.com](https://flypython.com/) 上学习。
 
 FlyPython 是一个面向实践的双语仓库，帮助你写好 Python，并把代码变成用户可以依赖的
 产品。这里同时提供 AI Coding 方法、任务 Playbook、可运行示例、复用模板，以及 API、
@@ -21,7 +22,7 @@ FlyPython 是一个面向实践的双语仓库，帮助你写好 Python，并把
 
 ## 3 分钟开始
 
-只需要 Python 3.11+：
+只需要 Python 3.11+（开发环境通过 `.python-version` 固定在 3.12）：
 
 ```bash
 git clone https://github.com/flypythoncom/python.git
@@ -38,7 +39,7 @@ python examples/product-slug/verify.py solution
 
 | 目标 | 从这里开始 | 最终产出 |
 | --- | --- | --- |
-| 解题式动手实战 | [挑战课程](courses/) · [学习路线](paths/) | 一个通过验证的项目 + `verify.py` 的检查点认领码 |
+| 解题式动手实战 | [挑战课程](courses/) · [学习路线](paths/README.md) | 一个通过验证的项目 + `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 修改、外部集成、依赖升级或发布 |
@@ -166,13 +167,16 @@ catalog/
   paths.yml          中英文学习路径定义
   resources/         每项资源一个 YAML 文件
   projects/          最新 Python 项目的人工审核队列
+courses/              带 TASK.md 契约和 verify.py 认领码的挑战课程
+paths/                把课程串成徽章路线的学习路径
 guides/               Python 工程与 AI Coding 方法
 playbooks/            可重复任务步骤与完成标准
 examples/             带自动验证的可运行小项目
 templates/            任务、计划、Review 和验证模板
 schema/
   *.schema.json       带版本的机器可读契约
 catalog.json         提供给网站使用的确定性公开导出
+radar.json            提供给网站使用的确定性 Project Radar 导出
 content-manifest.json 网站使用的版本、路径、摘要与校验值
 tools/                生成、校验、示例和链接审计工具
 tests/                内容一致性与行为测试
@@ -215,10 +219,12 @@ pytest
 ```bash
 python -m pytest
 python tools/validate_catalog.py
-python tools/export_catalog.py --check
+python tools/export_catalog.py --check --target both
 python tools/render_readmes.py --check
 python tools/build_content_manifest.py --check
 python tools/verify_examples.py
+python tools/verify_courses.py
+python tools/verify_paths.py
 ```
 
 修改源内容后重新生成：