Björn RundenandClaude Opus 5.5
7f6b8ebe07
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>
44 lines
2.7 KiB
Markdown
44 lines
2.7 KiB
Markdown
# Knowledge-DB (Markdown)
|
||
|
||
> Dauerhaftes Wissen über Umgebung und Projekt – eine Datei pro Eintrag, Metadaten im YAML-Frontmatter,
|
||
> Übersicht in [`INDEX.md`](INDEX.md) (erzeugt von `bin/kb_index.sh`, nicht von Hand bearbeiten).
|
||
|
||
## Ablage
|
||
| Ordner | `type` | Inhalt | Beispiel |
|
||
|---|---|---|---|
|
||
| `systems/` | `system` | Hosts, VMs, Geräte (Server, Switch, AP, Firewall) | `systems/host01.md` |
|
||
| `network/` | `network` | Netze, VLANs, IP-Pläne, DNS-Zonen, VPN, Routing | `network/ip_plan.md` |
|
||
| `services/` | `service` | Dienste/Anwendungen (DNS, RADIUS, Backup, Mail) | `services/dns_resolver.md` |
|
||
| `decisions/` | `decision` | ADRs – Entscheidungen mit Begründung | `decisions/adr_0001_secret_store.md` |
|
||
| `howto/` | `howto` | Anleitungen, Runbooks, wiederkehrende Handgriffe | `howto/restore_backup.md` |
|
||
| `research/` | `research` | Recherchen mit Quellen und Datum | `research/wifi_controller_vergleich.md` |
|
||
| `topics/` | `topic` | Lerninhalte je LPIC-Prüfungsthema (Objective-Nummer im `id`) | `topics/lpic1_103_1_command_line.md` |
|
||
|
||
Dateiname = `id` + `.md` (Englisch/ASCII, klein, `_`). ADRs: `adr_NNNN_<slug>`.
|
||
|
||
## Frontmatter (Schlüssel englisch, Werte in Amtssprache)
|
||
```yaml
|
||
---
|
||
id: host01 # Pflicht, eindeutig, = Dateiname ohne .md
|
||
title: Virtualisierungshost 1 # Pflicht
|
||
type: system # Pflicht: system|network|service|decision|howto|research|topic
|
||
status: active # Pflicht: draft|active|deprecated|superseded
|
||
updated: 2026-10-07 # Pflicht, ISO
|
||
owner: br # Pflicht: Kürzel aus ../responsible.md
|
||
tags: [proxmox, server] # optional
|
||
sources: [] # optional: URLs (mit Abrufdatum im Text)
|
||
related: [dns_resolver] # optional: ids verwandter Einträge
|
||
supersedes: # optional (v. a. ADRs)
|
||
classification: intern # optional, Default intern; nie höher (rules/privacy.md)
|
||
---
|
||
```
|
||
Vorlage: [`../../common/templates/markdown/knowledge_entry.md`](../../common/templates/markdown/knowledge_entry.md), ADR: [`adr.md`](../../common/templates/markdown/adr.md).
|
||
|
||
## Regeln für Agenten
|
||
- **Lesen:** zuerst `INDEX.md`, dann gezielt Einträge. Suche: `grep -rl "tags:.*dns" ai/context/knowledge/`.
|
||
- **Schreiben:** bestehenden Eintrag aktualisieren statt neuen anlegen; `updated` setzen; Quellen mit Datum.
|
||
- **Fakten statt Erzählung:** Tabellen (Adressen, Ports, Versionen), Abschnitt „Stand/Änderungen“ unten mit Datum.
|
||
- **Nach jeder Änderung:** `bin/kb_index.sh` (prüft Pflichtfelder, doppelte ids, aktualisiert `INDEX.md`). `--check` für reine Prüfung.
|
||
- Veraltetes nicht löschen: `status: deprecated`/`superseded`, Verweis auf Nachfolger.
|
||
- Keine Geheimnisse, keine Personennamen außer Kürzeln aus `responsible.md`.
|