Regeln, Standards, Kontextstruktur und Werkzeuge übernommen; 2nd-brain- Inhalte (Stacks, Ansible-Inventar, Architektur, Knowledge) entfernt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
26 lines
1.6 KiB
Markdown
26 lines
1.6 KiB
Markdown
# 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`).
|