build: configure Python development environment

docs/DEVELOPMENT_SETUP.md

@@ -0,0 +1,38 @@
+# Entwicklungsumgebung
+
+Stand: 30.07.2026, Branch `feat/core-chat`.
+
+## Installierte Werkzeuge
+
+| Werkzeug | Version | Speicherort |
+|---|---:|---|
+| uv | 0.11.32 | `D:\Javis-Tools\uv` |
+| CPython | 3.12.13 | `D:\Javis-Tools\python` |
+| Ruff | 0.16.0 | lokale Projektumgebung `.venv` |
+| VS Code Python | 2026.4.0 | Benutzerprofil von VS Code |
+| VS Code Pylance | 2026.3.1 | Benutzerprofil von VS Code |
+| VS Code Python Environments | 1.36.0 | Benutzerprofil von VS Code |
+| VS Code Debugpy | 2026.6.0 | Abhängigkeit der Python-Erweiterung |
+
+`uv` und Python wurden isoliert auf `D:` installiert. Eine vorhandene Python-Version wurde nicht ersetzt und der Windows-Benutzer- oder System-`PATH` wurde nicht verändert.
+
+## Projektumgebung
+
+- gewünschte Python-Linie: `3.12`, festgehalten in `.python-version`
+- lokale Umgebung: `.venv`, durch Git ignoriert
+- Abhängigkeiten: `pyproject.toml`
+- reproduzierbare Auflösung: `uv.lock`
+- einzige Entwicklungsabhängigkeit in dieser Phase: Ruff
+
+Typische Befehle aus dem Repository:
+
+```powershell
+$env:UV_PYTHON_INSTALL_DIR = 'D:\Javis-Tools\python'
+$env:UV_CACHE_DIR = 'D:\Javis-Tools\uv-cache'
+& 'D:\Javis-Tools\uv\uv.exe' sync --dev
+& 'D:\Javis-Tools\uv\uv.exe' run javis chat
+& 'D:\Javis-Tools\uv\uv.exe' run ruff check .
+& 'D:\Javis-Tools\uv\uv.exe' run ruff format --check .
+```
+
+Die absoluten Pfade sind ausschließlich lokale Entwicklungsdokumentation. Der Anwendungscode darf keine festen Windows-Pfade enthalten.