# 0008 – Werkzeugunterstützung auf Claude Code fokussiert

Status: vorgeschlagen · Datum: 2026-09-04 · Beteiligte: AG QGIS · Ergänzt 0001

## Kontext
Der Leitfaden beschrieb fünf Werkzeug-Varianten (Claude Code CLI und VS Code, Codex CLI und VS Code, GitHub
Copilot) plus zwei Desktop-Apps und die reinen Chat-Oberflächen. Jede Variante brauchte eigene
Einrichtungsschritte, eigene Prüfschritte und eigene Fußnoten zu Skills und Anweisungsdateien. In der Praxis
wird Claude Code verwendet. Der Rest kostete Pflege, verwirrte Einsteiger und veraltete zwischen zwei
Anbieter-Releases.

## Entscheidung
`docs/leitfaden/04_werkzeuge_einrichten.md` beschreibt nur noch **Claude Code**, in zwei Formen: CLI und
VS-Code-Erweiterung. Die Vorlage `docs/vorlagen/copilot-instructions.md` entfällt.

**Die Dateistruktur bleibt werkzeugneutral.** Entscheidung 0001 gilt unverändert: `AGENTS.md` ist kanonisch,
`CLAUDE.md` ist ein Zeiger, Skills liegen in `.agents/skills/` und werden nach `.claude/skills/` gespiegelt.
Fokussiert wird die *Dokumentation*, nicht die *Struktur*.

Zusätzlich kommen Claude-Code-spezifische Dateien hinzu, die die Regeln durchsetzen statt sie nur zu
beschreiben: `.claude/settings.json` (Sperre für `git push`, `git merge`, `git tag`) und `.claude/commands/`
(Slash-Befehl `/hallo`). Beides ergänzt die neutralen Dateien, ersetzt sie nicht — die eigentliche Arbeit steckt
in `scripts/hallo.py` und ist auch ohne Claude Code nutzbar.

## Folgen
Der Leitfaden wird deutlich kürzer und bleibt aktuell. Wer ein anderes Werkzeug nutzen will, kann das weiterhin
tun — `AGENTS.md` und `.agents/skills/` sind der Standard, den auch andere Agenten lesen. Nur die
Schritt-für-Schritt-Anleitung dafür pflegen wir nicht mehr. Kommt ein zweites Werkzeug ins Team, wird diese
Entscheidung ersetzt.

`.vscode/` entfällt im Repository: es versionierte persönliche Pfade. Die brauchbaren Einstellungen stehen jetzt
als kopierbarer Block im Leitfaden, mit dem Hinweis, sie in die Benutzereinstellungen zu übernehmen.

## Verworfene Alternativen
Alle Varianten weiterpflegen (Aufwand ohne Nutzen, veraltet schneller als sie gelesen werden); vollständig auf
Claude Code umstellen und `AGENTS.md` durch `CLAUDE.md` ersetzen (Bindung an einen Anbieter, ohne dass es etwas
vereinfacht — die Spiegelung ist ein Skriptaufruf).