Agent Playbook
Source Of Truth
AGENT.md for repository-wide engineering and agent rules.
README.md for installation, quick start, and CLI examples.
CONTRIBUTING.md for branch, commit, and release workflow.
pyproject.toml and Makefile for supported commands.
Repository Map
src/azure_functions_openapi/ package code.
tests/ CLI, generation, and utility coverage.
examples/ example Azure Functions apps.
docs/ documentation site content.
Change Workflow
- Confirm whether the change affects runtime API, CLI, schema output, or docs only.
- Update examples when they are used as public contract material.
- Keep tests and docs in lockstep for public behavior changes.
- Do not broaden supported Python versions or dependency ranges casually.
Validation
make test
make lint
make typecheck
make security
make build