38 lines
2.3 KiB
Markdown
38 lines
2.3 KiB
Markdown
 
|
# 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).
|