AndreasTharangandClaude Sonnet 5
ab416fb34c
Erster Stand des Repositories AG_QGIS/Projektwissen (bisher Arbeitstitel "Workspace", ADR 0006). Der lokale Ordner heisst weiter AG_QGIS, weil darin auch die Plugin-Klone liegen. Git verbindlich (ADR 0007), aus dem bisherigen Wiki-Konzept entwickelt: - docs/leitfaden/05_git_arbeitsweise.md mit Kanal-Kette, Branch-Namen und Gitea-Branch-Schutz. - Der Einstiegspunkt eines Fixes richtet sich nach dem Kanal, in dem der Fehler sitzt; ein Fix an testing oder stable ist erst mit der Rueckfuehrung nach unten abgeschlossen. Das fehlte bisher. - Der stabile Kanal heisst stable, nicht main: der Release-Workflow in Repository:hidden/workflows fuehrt git checkout "$CHANNEL" aus, der Branchname muss also dem Kanalnamen entsprechen. Er existiert in keinem Plugin-Repo und ist vom Maintainer anzulegen. - Der Mensch drueckt ab: .claude/settings.json sperrt push, merge, tag. - scripts/hallo.py und /hallo holen den Stand aller Klone, per Fast-Forward wo gefahrlos; nie mergen, stashen oder verwerfen. Ticketzugriff: - scripts/gitea.py liest Issues, Kommentare und PRs ueber die oeffentliche API, ohne Token, nur GET. Schreibendes nur als Entwurf in entwuerfe/. - Skill sn-ticket. Tests (ADR 0009): - docs/leitfaden/06_tests.md: Testebenen, Testpflicht, und wie eine Fachperson beurteilt, ob Tests fachlich sinnvoll sind. - scripts/testkatalog.py erzeugt docs/tests/testkatalog.md per ast-Parsing, ohne Import und ohne QGIS. Befund: nur 100 von 332 Tests haben einen Docstring, sn_basis keinen einzigen von 87. - Vorlage und erste Testkonzept-Seite mit Mermaid. Dabei gefunden und gegen origin geprueft: _ermittle_gebietstyp_aus_fbschl hat keinen Test, obwohl PR #44/#45 genau diese Funktion tolerant gemacht hat. - docs/konzept/07_qgis_tests_plan.md: Stufenplan fuer Tests gegen echtes QGIS. Dabei aufgefallen: QGIS 3.40 ist seit Januar 2026 End of Life, qgis_min steht aber noch darauf. Werkzeuge (ADR 0008): - 04_werkzeuge_einrichten.md nur noch Claude Code als CLI und in VS Code. - .vscode/ entfernt, brauchbare Einstellungen als persoenliche Vorlage. Ausserdem: README als Einstieg neu aufgebaut, Mermaid-Diagramm in schnittstellen.md repariert (unmaskierte Klammern, rendert seither nicht). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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).
|