# ai/ – Regeln, Standards und Kontext für KI-Agenten

| Ordner | Frage, die er beantwortet | Verbindlichkeit | Wer ändert |
|---|---|---|---|
| [`rules/`](rules/README.md) | **Was darf/muss ich (nicht)?** | verbindlich, Vorrang | Bediener; Agent nur auf ausdrückliche Anweisung |
| [`common/`](common/README.md) | **Wie machen wir Dinge?** (Code, Doku, Architektur, Arbeitsweise) | Standard; Abweichung nur begründet | Bediener + Agent (mit Änderungsvermerk) |
| [`context/`](context/README.md) | **Für wen, wo, womit?** (Personen, Stil, Umgebung) + Knowledge-DB | Faktenbasis | Bediener + Agent |
| [`inbox/`](inbox/README.md) | **Was ist neu hereingekommen?** (vom Bediener abgelegte `.md`) | temporär | Bediener legt ab, Agent ordnet ein |

## Lesereihenfolge
`rules/` → `common/agents.md` → aufgabenbezogener Standard aus `common/` → `context/*.md` → `context/knowledge/INDEX.md` (gezielt) → `../context.md`.

## Abgrenzung (wohin gehört eine neue Information?)
| Information | Ziel |
|---|---|
| Verbot/Erlaubnis, Grenze, Pflicht | `rules/<thema>.md` (eine Regel pro Datei) |
| Konvention, Vorgehen, Vorlage | `common/<thema>.md`, Vorlage in `common/templates/` |
| Wer/wo/womit (Überblick) | `context/<thema>.md` |
| Fakt, Entscheidung, Anleitung, Recherche mit Bestand | `context/knowledge/<typ>/…` |
| Projektstand, Ziel, offene Fragen | `../context.md` |
| Code (Übungen, Lab) | `../bash/`, `../ansible/`, `../stacks/` – Ordner erst bei Bedarf anlegen |

## Namenskonventionen der Basis
- Datei- und Ordnernamen: Englisch, Kleinbuchstaben, `_` als Trenner, ASCII → stabil bei Klonen mit anderer Amtssprache.
- Inhalte: Amtssprache (siehe `AGENTS.md`).