# 0001 – `AGENTS.md` ist die kanonische Anweisungsdatei

Status: vorgeschlagen · Datum: 2026-09-02 · Beteiligte: AG QGIS (Vorschlag aus der Vorbereitungsphase)

## Kontext
Entwickler nutzen unterschiedliche Agenten (Claude Code, Codex, Copilot). Claude Code liest `CLAUDE.md`, Codex und
Copilot lesen `AGENTS.md`. Getrennte Dateien driften auseinander.

## Entscheidung
Es gibt genau eine Anweisungsdatei je Ordner: `AGENTS.md`. `CLAUDE.md` enthält nur `@AGENTS.md` und wenige
Claude-spezifische Zeilen. Eine Copilot-Zeigerdatei ist optional (`docs/vorlagen/copilot-instructions.md`).
`AGENTS.md` bleibt unter 150 Zeilen; Abläufe gehören in Skills, Beschreibungen in `docs/`.

## Folgen
Änderungen an Regeln passieren an einer Stelle. Claude Code fragt beim ersten Import einmal nach Zustimmung.
Windows-Symlinks werden vermieden.

## Verworfene Alternativen
Symlink `CLAUDE.md → AGENTS.md` (Windows-Rechte); je Werkzeug eigene Datei (Drift); Inhalt in README (zu lang, falsche Zielgruppe).