ai/ – Regeln, Standards und Kontext für KI-Agenten
| Ordner | Frage, die er beantwortet | Verbindlichkeit | Wer ändert |
|---|---|---|---|
rules/ |
Was darf/muss ich (nicht)? | verbindlich, Vorrang | Bediener; Agent nur auf ausdrückliche Anweisung |
common/ |
Wie machen wir Dinge? (Code, Doku, Architektur, Arbeitsweise) | Standard; Abweichung nur begründet | Bediener + Agent (mit Änderungsvermerk) |
context/ |
Für wen, wo, womit? (Personen, Stil, Umgebung) + Knowledge-DB | Faktenbasis | Bediener + Agent |
inbox/ |
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).