20 lines
1001 B
Markdown
20 lines
1001 B
Markdown
 
|
# 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).
|