fix: list all 12 courses in llms.txt and guard its paths with a test

llms.txt listed 8 of 12 courses, pointed at a nonexistent
courses/hands-on-with-openai-codex-cli/ folder, and recommended
`uv run pytest`, which fails because pytest lives in the dev extra.
The new course lines reuse each COURSE.md summary. The new test fails
on any listed path that does not exist and on any unlisted course.

Co-authored-by: P小二 <xxg1413@gmail.com>

Author: cursoragent

llms.txt

@@ -4,7 +4,9 @@
 
 ## Quick API and Automation Commands
 
-- Run full test suite with uv: `uv run pytest`
+- Install development dependencies: `python -m pip install -r requirements-dev.lock.txt`
+- Run every CI check (lint, tests, exports, examples, courses, paths): `make check`
+- Run the test suite only: `python -m pytest`
 - Verify runnable examples: `python tools/verify_examples.py`
 - Verify course folders: `python tools/verify_courses.py`
 - Validate and inspect resource catalog: `python tools/validate_catalog.py`
@@ -19,7 +21,11 @@
 - `catalog/projects/`: One reviewed YAML file per Project Radar entry (discovery candidates are produced on demand by `tools/radar_scan.py`).
 - `courses/`: Challenge course folders — solve the `TASK.md` contract with a coding agent and prove it with `verify.py` claim codes; `COURSE.md` still offers a guided, agent-taught mode:
   - `courses/hands-on-python-with-claude-code/`: Task contract, bounded change, and objective verify.py evidence with Claude Code (EN+ZH lessons, three scenario skins).
-  - `courses/hands-on-with-openai-codex-cli/`: The same verified workflow taught with the OpenAI Codex CLI (EN+ZH lessons, reuses the flagship scenario skins).
+  - `courses/hands-on-with-openai-codex/`: The same verified workflow taught hands-on in the Codex desktop app, where an agent thread runs the loop and you supervise diffs and approvals (EN+ZH).
+  - `courses/hands-on-with-cursor/`: The same verified workflow taught hands-on in Cursor, where Agent mode runs the loop and you supervise diffs and project rules (EN+ZH).
+  - `courses/hands-on-with-deepseek-harness/`: The same verified workflow taught hands-on in DeepSeek Harness, where the agent loop is composed from plugins and every step lands in an inspectable trajectory (EN+ZH).
+  - `courses/hands-on-with-kimi-code/`: The same verified workflow taught hands-on in Kimi Code, where built-in subagents split read-only exploration, planning, and the edits you approve (EN+ZH).
+  - `courses/hands-on-with-zcode/`: The same verified workflow taught hands-on in the ZCode desktop workspace, where Goal Mode decomposes the work and the Git state shows every change (EN+ZH).
   - `courses/agent-rules-single-source/`: Build a checker that proves one AGENTS.md source of truth across CLAUDE.md and .cursorrules (EN+ZH, three drift scenarios).
   - `courses/verifying-ai-generated-code/`: Build the release-evidence machine: run checks, parse results, refuse zero-test projects, write SHIP-RECORD.json (EN+ZH, three project skins).
   - `courses/mcp-server-in-python/`: Build a stateless 2026-07-28 MCP tool server in pure Python — reuses the reviewed mcp-server example core (EN+ZH).

tests/test_llms_txt.py

@@ -0,0 +1,33 @@
+"""llms.txt is the entry point agents read first, so a stale path or a missing
+course sends them to a 404 or hides a course entirely."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+LLMS = ROOT / "llms.txt"
+REPO_PATH = re.compile(
+    r"`((?:catalog|courses|examples|guides|paths|playbooks|schema|templates|tools)/[^`\s]*)`"
+)
+
+
+def _listed_paths() -> list[str]:
+    return REPO_PATH.findall(LLMS.read_text(encoding="utf-8"))
+
+
+def test_every_repository_path_exists() -> None:
+    missing = [path for path in _listed_paths() if not (ROOT / path).exists()]
+    assert not missing, f"llms.txt points at paths that do not exist: {missing}"
+
+
+def test_every_course_folder_is_listed() -> None:
+    listed = {path.rstrip("/") for path in _listed_paths()}
+    courses = sorted(
+        f"courses/{course.name}"
+        for course in (ROOT / "courses").iterdir()
+        if (course / "COURSE.md").is_file()
+    )
+    unlisted = [course for course in courses if course not in listed]
+    assert not unlisted, f"llms.txt does not list these courses: {unlisted}"