Files

T

AndreasTharangandClaude Sonnet 5 ab416fb34c Projektwissen: Git-Vorgaben, Ticketzugriff, Tests und Einstieg

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>

2026-09-04 11:57:26 +02:00

2.3 KiB

Raw Blame History

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).

2.3 KiB Raw Blame History Unescape Escape