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>
2.7 KiB
2.7 KiB
Knowledge-DB (Markdown)
Dauerhaftes Wissen über Umgebung und Projekt – eine Datei pro Eintrag, Metadaten im YAML-Frontmatter, Übersicht in
INDEX.md(erzeugt vonbin/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)
---
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, ADR: 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;
updatedsetzen; 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, aktualisiertINDEX.md).--checkfü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.