llms.txt

# FlyPython Repository Index for LLMs and AI Agents

> FlyPython provides production-tested Python engineering playbooks, agent-taught courses with objective verification, verifiable test-driven starter examples, task contracts, and agent IDE rules.

## Quick API and Automation Commands

- Run full test suite with uv: `uv run 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`
- Discover Radar review candidates: `python tools/radar_scan.py --dry-run`
- Structured Content Manifest: `content-manifest.json`
- Full curated catalog data: `catalog.json`
- Project Radar data: `radar.json`

## Machine-Readable Directories

- `catalog/resources/`: YAML files representing verified libraries, tools, and platforms.
- `catalog/projects/`: One reviewed YAML file per Project Radar entry, plus the discovery queue `candidates.json`.
- `courses/`: Agent-taught course folders; download one and say "start lesson 1":
  - `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/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).
- `examples/`: Reproducible test projects with failing starters and verified solutions:
  - `examples/product-slug/`: String normalization edge cases and regex safety.
  - `examples/pydantic-validation/`: Model boundaries and custom validators.
  - `examples/mcp-server/`: JSON-RPC 2.0 Model Context Protocol tool server with schema validation.
  - `examples/async-fetcher/`: Async concurrency control with Semaphore and backoff retry.
  - `examples/structured-pipeline/`: Batch data pipeline with error isolation and schema checking.
- `templates/`:
  - `templates/AGENT_RULES.example.md`: Universal rule set for Cursor (.cursorrules), Windsurf, and Copilot.
  - `templates/AGENT_RULES.example_cn.md`: Universal rule set in Chinese.
  - `templates/AGENTS.example.md`: Repository instruction policy for coding agents.
  - `templates/AGENTS.example_cn.md`: Repository instruction policy in Chinese.
  - `templates/TASK_CONTRACT.example.md`: Scoped specification template for coding agents.
  - `templates/TASK_PLAN.example.md`: Implementation plan template.
  - `templates/TASK_REVIEW.example.md`: Code change review template.
  - `templates/VERIFICATION_RECORD.example.md`: Evidence record for reproducible tests.

## Official Portal

- Official Website: https://flypython.com
- Website LLMs Index: https://flypython.com/llms.txt
- Complete Text Knowledge Dump: https://flypython.com/llms-full.txt