- Own repository-shipped configuration defaults and templates.
- Keep clean-checkout defaults safe, portable, and free of user-specific state.
model_providers.yamldefines built-in provider metadata and LiteLLM wiring defaults.*.default.gitignorefiles define templates copied or used for generated user/project/workdir directories.- Runtime user settings belong under ignored
usr/local state and are not documented with local DOX files.
- Do not commit API keys, provider secrets, local account identifiers, or private endpoints.
- Keep provider IDs and settings keys stable unless all loaders, UI references, migrations, and tests are updated.
- Defaults must work in a clean checkout and in Docker.
- Templates must avoid accidentally unignoring private runtime content.
- Prefer adding provider metadata here only when it is broadly useful to shipped Agent Zero.
- Keep comments concise and operational.
- Coordinate provider changes with model settings UI, plugin model overrides, and docs.
- Run targeted model/provider tests after changing
model_providers.yaml. - Check generated ignore templates manually when changing
*.default.gitignore.
No child DOX files.