Handbook
Examples
Cookbook entries (offline-first):
Updated
| Topic | Page |
|---|---|
| Basic task runner | basic-task-runner.md |
| Contracts and schemas | contracts-and-schemas.md |
| Operators | operators-recipes.md |
| RAG / evidence | rag-answer-from-evidence.md |
| Playwright discovery context | playwright-discovery.md |
| MCP and Cursor | mcp-cursor.md |
| Games | games.md |
Runnable scripts (repo root, venv active):
| Script | Purpose |
|---|---|
examples/basic/run_fake_task.py |
TaskRunner + pw_chunk_classify + fake chat |
examples/contracts/load_contract_spec.py |
load_contract_spec introspection |
examples/operators/fallback_chain_recipe.py |
fallback_chain without LLM |
examples/rag/answer_from_evidence_fake.py |
answer_from_evidence + fake JSON |
See also examples/mcp/README.md and examples/playwright_discovery/README.md.
Source code for runnable scripts lives in the repository examples/ directory at the repo root.
Offline-first
- Prefer Tutorial 101 —
run_task/TaskRunnerwith fakechat. - Benchmarks default to fake transport; see Benchmarks.
Topics represented in examples/
| Area | Hint |
|---|---|
| MCP / browser policy | Cross-check MCP client before running anything that touches browsers. |
| Games | See Games examples guide and src/forge_lcdl/games/. |
Verify locally
python -m compileall -q src tests examples
pytest -q
Use Troubleshooting if imports or markers fail unexpectedly.