docs: restructure READMEs and split full catalog tables into catalog/

The root READMEs shrank from 294 to 191 lines (EN) and 275 to 176 (ZH):

- render_readmes.py now renders a condensed catalog index (learning-path
  bullets linking into the catalog pages) into the root READMEs, and the
  full 33-resource tables into the new generated catalog/README.md and
  catalog/README_cn.md.
- Badges moved directly under the title and the tagline no longer repeats
  it; the internal "Current status" section collapsed to a one-line release
  pointer with the operational detail moved to docs/REPO_TO_WEBSITE.md.
- The course-verify section now lists the three checkpoint states
  ([open]/[passed]/[pending]) instead of prose.
- The validation commands duplicated from CONTRIBUTING.md were replaced by
  a Contribute section linking to it.
- Added assets/verify-demo.svg, a terminal demo built from a real
  verify.py --attest checkpoint report, embedded in both READMEs.
- The resource-exposure test now targets the catalog READMEs; a new test
  asserts the root READMEs link to the full catalog.

Website-consumed exports (catalog.json, radar.json,
content-manifest.json) are byte-identical; no pinned-consumer change is
required by this commit.

Author: xxg1413

CHANGELOG.md

@@ -4,6 +4,20 @@ This file records notable catalog-contract and maintenance changes.
 
 ## [Unreleased]
 
+### Changed — 2026-10-04 README restructure
+
+- Root READMEs now carry a condensed catalog index (learning-path bullets
+  linking into the catalog pages); the full 33-resource tables moved to the
+  new generated `catalog/README.md` and `catalog/README_cn.md`, both rendered
+  by `tools/render_readmes.py`.
+- Root READMEs: badges moved directly under the title, the internal
+  "Current status" section collapsed to a one-line release pointer (details
+  in `docs/REPO_TO_WEBSITE.md`), the course-verify section rewritten as a
+  checkpoint-state list, and the locally duplicated validation commands
+  replaced by a link to `CONTRIBUTING.md`.
+- Added `assets/verify-demo.svg`, a terminal demo of a real `verify.py`
+  checkpoint report, embedded in both READMEs.
+
 ### Fixed — 2026-10-04 CI and course setup
 
 - CI: `ruff` is pinned in `requirements-dev.lock.txt`. CI had installed the

Makefile

@@ -6,7 +6,7 @@ help:
 	@echo "FlyPython Development Workflow:"
 	@echo "  make check      - Run the same checks as CI: lint, tests, catalog, radar, export, readme, manifest, example, course, and path checks"
 	@echo "  make export     - Regenerate catalog.json and radar.json"
-	@echo "  make render     - Regenerate README and README_cn catalog indexes plus the Radar table"
+	@echo "  make render     - Regenerate root and catalog README indexes plus the Radar table"
 	@echo "  make manifest   - Regenerate content-manifest.json"
 	@echo "  make lint       - Run ruff"
 	@echo "  make test       - Run pytest test suite"

README.md

@@ -0,0 +1,87 @@
+# Reviewed source catalog
+
+Every entry below passed maintainer review: why it is included, who it suits,
+and which access or safety constraints deserve attention. The canonical source
+data lives in the surrounding `catalog/` YAML files — this page is generated by
+`tools/render_readmes.py` and must not be edited by hand.
+
+[English](README.md) · [中文](README_cn.md) · [Repository README](../README.md)
+
+<!-- catalog-index:start -->
+<!-- Generated by tools/render_readmes.py; edit catalog/ instead. -->
+> **33 reviewed resources** · Catalog reviewed 2026-09-06 · 25 intermediate or advanced · Primary sources first
+
+### Choose a learning path
+
+- [**Python foundations**](#path-foundations) — Learn the language, environments, dependencies, typing, and tests that reliable Python work depends on. (8 resources)
+- [**Web and APIs**](#path-web-apis) — Build typed services and applications that connect Python logic to users and other systems. (7 resources)
+- [**Automation**](#path-automation) — Turn repeatable work into maintainable scripts, browser workflows, and data pipelines. (7 resources)
+- [**AI agents**](#path-ai-agents) — Learn tools, structured output, state, evaluation, and the safety boundaries of agent systems. (11 resources)
+
+<a id="path-foundations"></a>
+### Python foundations
+
+Learn the language, environments, dependencies, typing, and tests that reliable Python work depends on.
+
+| Resource | Why it is useful | Level and language | Access and risk | Reviewed |
+| --- | --- | --- | --- | --- |
+| [The Python Tutorial](https://docs.python.org/3/tutorial/)<br><sub>Official docs · Featured</sub> | The primary introduction to Python syntax, data structures, modules, errors, classes, and the standard library. | Beginner<br>English | No API key<br>Low risk | 2026-08-31 |
+| [venv — Creation of virtual environments](https://docs.python.org/3/library/venv.html)<br><sub>Official docs</sub> | The standard-library reference for creating isolated Python environments and understanding their behavior. | Beginner<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Python Packaging User Guide](https://packaging.python.org/en/latest/tutorials/packaging-projects/)<br><sub>Official docs</sub> | The PyPA tutorial for project layout, build metadata, distributions, and publishing Python packages. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
+| [uv documentation](https://docs.astral.sh/uv/)<br><sub>Official project · Featured</sub> | A modern workflow for Python versions, virtual environments, dependencies, lockfiles, and project commands. | All levels<br>English | No API key<br>Low risk | 2026-08-31 |
+| [pytest documentation](https://docs.pytest.org/en/stable/)<br><sub>Official project</sub> | The official guide to test discovery, assertions, fixtures, parametrization, and maintainable test suites. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Python typing documentation](https://typing.python.org/en/latest/)<br><sub>Official docs</sub> | The canonical home for Python's type-system specification, guides, and typing best practices. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Ruff documentation](https://docs.astral.sh/ruff/)<br><sub>Official project · Featured</sub> | An extremely fast Python linter and code formatter written in Rust, replacing Flake8, Black, isort, and more. | All levels<br>English | No API key<br>Low risk | 2026-09-02 |
+| [Mypy documentation](https://mypy.readthedocs.io/en/stable/)<br><sub>Official project</sub> | The standard static type checker for Python to catch bugs and verify type contracts before running code. | Intermediate<br>English | No API key<br>Low risk | 2026-09-02 |
+
+<a id="path-web-apis"></a>
+### Web and APIs
+
+Build typed services and applications that connect Python logic to users and other systems.
+
+| Resource | Why it is useful | Level and language | Access and risk | Reviewed |
+| --- | --- | --- | --- | --- |
+| [FastAPI documentation](https://fastapi.tiangolo.com/)<br><sub>Official docs · Featured</sub> | A direct route from typed Python functions to tested APIs with validation and generated documentation. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Django documentation: First steps](https://docs.djangoproject.com/en/stable/intro/tutorial01/)<br><sub>Official docs</sub> | The official path through Django projects, models, views, templates, forms, tests, and reusable apps. | Beginner<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Flask documentation](https://flask.palletsprojects.com/en/stable/)<br><sub>Official docs</sub> | The maintained reference and tutorial for Flask applications, requests, templates, testing, and deployment. | Beginner<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Pydantic documentation](https://pydantic.dev/docs/validation/latest/get-started/)<br><sub>Official docs</sub> | The primary guide to validating untrusted data and expressing typed contracts at Python system boundaries. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
+| [HTTPX documentation](https://www.python-httpx.org/)<br><sub>Official project</sub> | The official reference for synchronous and asynchronous HTTP clients, timeouts, streaming, and transport control. | Intermediate<br>English | No API key<br>Low risk | 2026-08-31 |
+| [SQLAlchemy documentation](https://docs.sqlalchemy.org/en/20/)<br><sub>Official project</sub> | The definitive Python SQL toolkit and Object Relational Mapper, providing type-safe database access and migrations. | Intermediate<br>English | No API key<br>Low risk | 2026-09-02 |
+| [Alembic documentation](https://alembic.sqlalchemy.org/en/latest/)<br><sub>Official project</sub> | Database migration tool for SQLAlchemy, providing transactional schema changes and rollback support. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-09-02 |
+
+<a id="path-automation"></a>
+### Automation
+
+Turn repeatable work into maintainable scripts, browser workflows, and data pipelines.
+
+| Resource | Why it is useful | Level and language | Access and risk | Reviewed |
+| --- | --- | --- | --- | --- |
+| [pathlib — Object-oriented filesystem paths](https://docs.python.org/3/library/pathlib.html)<br><sub>Official docs</sub> | The standard-library reference for readable, cross-platform file and directory automation. | Beginner<br>English | No API key<br>Low risk | 2026-08-31 |
+| [subprocess — Subprocess management](https://docs.python.org/3/library/subprocess.html)<br><sub>Official docs</sub> | The standard-library contract for launching processes, capturing output, handling failures, and avoiding unsafe shell usage. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-08-31 |
+| [Playwright for Python](https://playwright.dev/python/docs/intro)<br><sub>Official docs</sub> | The official Python guide to reliable browser automation, locators, assertions, traces, and isolated contexts. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-08-31 |
+| [Scrapy tutorial](https://docs.scrapy.org/en/latest/intro/tutorial.html)<br><sub>Official docs</sub> | The official introduction to crawl structure, extraction, item pipelines, persistence, and responsible operation. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-08-31 |
+| [pandas getting started guides](https://pandas.pydata.org/docs/getting_started/index.html)<br><sub>Official docs</sub> | The primary entry point for tabular data loading, cleaning, transformation, analysis, and export. | Beginner<br>English | No API key<br>Low risk | 2026-08-31 |
+| [Polars documentation](https://docs.pola.rs/)<br><sub>Official project</sub> | Lightning-fast DataFrame library built on Apache Arrow and Rust, optimized for efficient data pipelines and parallel processing. | Intermediate<br>English | No API key<br>Low risk | 2026-09-02 |
+| [DuckDB Python API documentation](https://duckdb.org/docs/api/python/overview)<br><sub>Official project</sub> | Fast in-process analytical SQL engine for automated data transformation, Parquet querying, and embedded analytics. | Intermediate<br>English | No API key<br>Low risk | 2026-09-02 |
+
+<a id="path-ai-agents"></a>
+### AI agents
+
+Learn tools, structured output, state, evaluation, and the safety boundaries of agent systems.
+
+| Resource | Why it is useful | Level and language | Access and risk | Reviewed |
+| --- | --- | --- | --- | --- |
+| [OpenAI Agents SDK](https://openai.github.io/openai-agents-python/)<br><sub>Official docs · Featured</sub> | The official Python toolkit for agents, tools, handoffs, guardrails, sessions, tracing, and orchestration. | Intermediate<br>English | API key typically required<br>Review permissions and side effects | 2026-08-31 |
+| [Pydantic AI](https://pydantic.dev/docs/ai/overview/)<br><sub>Official docs · Featured</sub> | Typed agent development built around validated inputs, structured output, tools, testing, and model portability. | Intermediate<br>English | API key typically required<br>Review permissions and side effects | 2026-08-31 |
+| [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro)<br><sub>Official standard · Featured</sub> | The open protocol and reference documentation for connecting AI applications to tools, data, and reusable context. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-08-31 |
+| [LangGraph overview](https://docs.langchain.com/oss/python/langgraph/overview)<br><sub>Official docs</sub> | The official Python guide to stateful graph workflows, durable execution, memory, interrupts, and human review. | Advanced<br>English | API key typically required<br>Review permissions and side effects | 2026-08-31 |
+| [Google Agent Development Kit](https://adk.dev/)<br><sub>Official docs</sub> | Google's official documentation for developing, evaluating, and deploying modular agent systems. | Advanced<br>English | API key typically required<br>Review permissions and side effects | 2026-08-31 |
+| [Instructor documentation](https://python.useinstructor.com/)<br><sub>Official project</sub> | Structured outputs and validation for LLMs powered by Pydantic, enabling predictable tool calling and schema enforcement. | Intermediate<br>English | API key typically required<br>Review permissions and side effects | 2026-09-02 |
+| [Model Context Protocol Python SDK](https://github.com/modelcontextprotocol/python-sdk)<br><sub>Official project</sub> | Official Python implementation of the Model Context Protocol for building MCP servers and clients. | Intermediate<br>English | No API key<br>Review permissions and side effects | 2026-09-02 |
+| [MCP 2026-07-28 specification release](https://blog.modelcontextprotocol.io/posts/2026-07-28/)<br><sub>Official docs</sub> | The official release announcement for the 2026-07-28 Model Context Protocol specification, covering the stateless redesign and breaking changes. | Intermediate<br>English | No API key<br>Low risk | 2026-09-06 |
+| [MCP 2026-07-28 release candidate overview](https://blog.modelcontextprotocol.io/posts/2026-07-28-release-candidate/)<br><sub>Official docs</sub> | The official release-candidate post that enumerates the 2026-07-28 breaking changes and the migration window for SDK maintainers. | Intermediate<br>English | No API key<br>Low risk | 2026-09-06 |
+| [Anthropic donating MCP to the Agentic AI Foundation](https://www.anthropic.com/news/donating-the-model-context-protocol-and-establishing-of-the-agentic-ai-foundation)<br><sub>Official docs</sub> | Anthropic's announcement establishing neutral Linux Foundation governance for MCP under the Agentic AI Foundation. | Intermediate<br>English | No API key<br>Low risk | 2026-09-06 |
+| [MCP under the Agentic AI Foundation](https://aaif.io/projects/model-context-protocol)<br><sub>Official project</sub> | The Agentic AI Foundation project page for MCP, the neutral governance home for specification development and roadmaps. | Intermediate<br>English | No API key<br>Low risk | 2026-09-06 |
+
+Missing an important official source? [Propose a resource or report a correction](https://github.com/flypythoncom/python/issues/new/choose).
+<!-- catalog-index:end -->