# Regel: Header mit Verantwortlichen

> Stand: 08.10.2026 · gilt für: jede Code-, Konfigurations- und Template-Datei, die in diesem Repo entsteht

## Pflicht
Jede Datei beginnt (nach Shebang bzw. `---`) mit einem Header im **bashdoc-Stil** (`## @tag`), eingerahmt von `#-----`-Linien:

| Tag | Pflicht | Inhalt |
|---|---|---|
| `@file` | ja | Dateiname |
| `@brief` | ja | Zweck in einem Satz |
| `@author` | ja | `Name <mail>` des verantwortlichen Menschen (aus `ai/context/responsible.md`) – nie die KI. Mehrere Autoren: Zeile `@author` wiederholen, Hauptautor zuerst |
| `@owner` | ja | `Name <mail>` oder Rolle des fachlich Verantwortlichen (aus `responsible.md`) |
| `@assist` | wenn KI beteiligt | `KI-unterstützt (<Modell>), geprüft von <author>` |
| `@version` | ja | SemVer + Datum `x.y.z (TT.MM.JJJJ)` |
| `@usage` | Scripts/Playbooks | Aufruf; Optionen bei Bash über `## @OPTIONS@` (generiert) |

- Agenten tragen Namen und Mail exakt wie in `responsible.md` (Spalte „Header-String“) ein. Fehlt dort ein Eintrag: Platzhalter `<AUTOR>` stehen lassen und den Bediener darauf hinweisen – **keine Namen erfinden**.
- Bei inhaltlicher Änderung: `@version` erhöhen, Datum aktualisieren; `@author` nur ändern, wenn die Verantwortung wechselt.
- Kommentar-Präfix je Sprache: Bash/YAML/Python `##`, Jinja `{#- … -#}`, SQL `--`. Format der Tags bleibt gleich.

## Vorlagen
`ai/common/templates/` – Bash (`bash/script_template.sh`), Ansible (`ansible/playbooks/example.yml`), Docker (`docker/docker-compose.yml`).

## Beispiel (mehrere Autoren)
```bash
## @author   Erika Muster <erika.muster@example.org>
## @author   Max Beispiel <max.beispiel@example.org>
## @owner    Clara Fach <clara.fach@example.org>
```

## Änderungsprotokoll
- 07.10.2026 – angelegt.
- 08.10.2026 – `Name <mail>`-Format, mehrere `@author` erlaubt.
- 23.10.2026 – Mandantenbezug entfernt (Einzelprojekt).