This guide describes local development workflows, code quality gates, and release expectations.

uv venv
uv pip install -e ".[dev]"
cp proxmox-config/config.example.json proxmox-config/config.json

pytest
ruff .
mypy .
black .

• Keep behavior changes covered by tests
• Prefer explicit, typed interfaces for tool contracts
• Document security-impacting changes in Wiki pages
• Maintain README as a concise index, not a full manual

• Update Wiki pages for operational or integration changes
• Keep page titles stable to avoid link breakage
• Record upgrade-impacting changes in Release & Upgrade Notes