Basis aus 2nd-brain für LPIC-Prüfungsvorbereitung übernommen
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>
This commit is contained in:
commit
7f6b8ebe07
70 files changed
+2816
No files matched your search
@@ -0,0 +1,43 @@
|
||||
# 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`.
|
||||
Reference in new issue
Block a user