- Each top level directory is a separate Python project created with the
uvtool. - Most scripts have a verbose flag where more
vs increase the verbosity level. So use-vvfor more verbose output. - Use the
uv addanduv removecommands to manage dependencies. Do not usepiporpoetryto manage dependencies. - Project scripts should be run with
uv run <script_name>.
- For projects that include Google Agent Development Kit (ADK)
google-adkin the pyproject.toml file, based your answers primarily on the Google Agent Development Kit (ADK) documentation. - Strongly prefer explicit Python typing over duck typing.
- Keep the README.md in each top level directory up to date with a short description of each script.
- Use Mermaid diagrams in README.md files to illustrate the sequence of events in each script.
- Always put a new sentence on a new line in markdown documents so that changes to README.md files are easier to review in pull requests.