blob: f02a0dce7d2a7ebe850bf580af76d5c20dc76e8a (
plain)
1
2
3
4
5
6
7
8
9
10
|
# AGENTS.md
## Scripting Policy
- For easy, cheap, standalone Python scripts in this repo, use `uv` inline script metadata.
- Use the `#!/usr/bin/env -S uv run --script` shebang.
- Add a PEP 723 inline TOML block with `requires-python` and `dependencies`.
- Keep dependency pins exact when a script has non-stdlib Python dependencies.
- Use common sense. Do not force this onto heavy or specialized runtimes, bespoke project environments, or scripts that intentionally run inside a dedicated external environment.
- In particular, avoid slapping `uv` metadata onto heavyweight OCR/runtime entrypoints just to satisfy the rule mechanically.
|