AGENTS.md

Instructions for coding agents

Adding new azd environment variables

An azd environment variable is stored by the azd CLI for each environment. It is passed to the "azd up" command and can configure both provisioning options and application settings. When adding new azd environment variables, update:

1. infra/main.parameters.json : Add the new parameter with a Bicep-friendly variable name and map to the new environment variable
2. infra/main.bicep: Add the new Bicep parameter at the top, and add it to the webAppEnv object
3. .github/workflows/azure-dev.yml: Add the new environment variable under env section. If it's a @secure variable in main.bicep, it should come from secrets, otherwise from vars.

Upgrading Python packages

1. Update the version constraint in src/backend/pyproject.toml

2. Re-compile src/backend/requirements.txt from the src folder:

   uv pip compile pyproject.toml -o requirements.txt --python-version 3.10

3. Reinstall with:

   python -m pip install -r src/backend/requirements.txt