Robert RappandClaude Opus 5.5
4a1bda3409
ci / test (push) Failing after 22s
main (bis 13.10.) enthielt eine parallele Fassung von Task 0.4 (c81e372) sowie
KNOW-Befunde und die Ontologie. Konflikte zugunsten des Plan-Branches gelöst
(ausgerollter Stand); übernommen aus main: Ontologie (core/src/knaster/ontology,
ontology/, Tests, Router-Image), KNOW-Doku, cpu_roles im Placement samt
Kennzeichnung von pve61 und gode-pc-05/06 im Inventar und Test.
infra-stack kopiert jetzt auch ontology/ nach infra (Router-Build braucht es).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
cluster-knaster
Ein starkes LLM erarbeitet neue Aufgaben und destilliert sie zu Skills. Danach übernehmen kleinere, selbst gehostete Modelle diese Aufgaben. Embeddings erkennen wieder, routen und treffen einfache Entscheidungen. Betrieb auf einem Proxmox-Cluster mit gemischten GPUs, gesteuert über n8n, mit halbautomatischer Pflege (Human-in-the-Loop).
Anfrage → n8n → Router-Service ──▶ Stufe 3 Embedding-Classifier (CPU)
│ ├─▶ Stufe 2 Programm (CPU)
│ ├─▶ Stufe 1 schwaches LLM + Skill (+LoRA) über LiteLLM → vLLM
│ └─▶ Stufe 0 starkes LLM über LiteLLM → OpenRouter
└─ Verifier → bestanden: Antwort + Fall speichern
→ nicht bestanden: Eskalation + Präferenzpaar
Dokumentation
| Dokument | Inhalt |
|---|---|
| AGENTS.md | Einstieg für Agenten und neue Admins: Arbeitsweise, Regeln, Muster |
| project-map.md | Was wo läuft: Rechner, Adressen, Dienste, Ports, Namespaces, Repo, Orte der Geheimnisse |
| known-issues.md | Bekannte Probleme und Fallen |
| docs/NOTFALL-ADMIN-UEBERGABE.md | Notfall: Verwaltung an eine andere Person übergeben (für die Geschäftsführung) |
| docs/PLAN.md | Architektur und Betrieb: Proxmox, Pflege, Autohealing, Lifecycle, Finetuning, Problemerkennung, Portabilität |
| docs/adr/ | Architekturentscheidungen |
| docs/spec/ | Spezifikationen der Komponenten |
| docs/superpowers/plans/2026-10-12-aufbau-cluster-knaster.md | Aufbauplan auf echter Hardware: Phasen, Entscheidungen D1–D5, Zuordnung zu Planner Epic 7 |
| docs/IMPLEMENTATION.md | Arbeitspakete, Teststrategie, Stand der Verifikation |
| ontology/know.yaml | Ontologie der Datenhaltung (Quelle); Pflege und Abgleich in SPEC-ontology |
| docs/reference/KNOW-schema.md | Bestehende n8n-Wissensdatenbank KNOW/KGW: Tabellen, wer schreibt und liest, Auffälligkeiten |
| docs/BETRIEB.md | Skill-Lebenszyklus, Rolle von Hermes, Pflege per Prompt, Dry-Run aufheben, Rollback |
| n8n/README.md | Workflows und Import |
| platform/proxmox/README.md | Proxmox-Ablauf (OpenTofu + Ansible) |
Repo-Struktur
core/ Python-Paket `knaster` (Router-Service) + Tests
config/ Policy, Healer-Regeln, Grenzwerte (portabel)
catalog/ Modell- und Rollenkatalog mit Hardware-Anforderungen
skills/ SKILL.md-Bibliothek
deploy/ Docker Compose pro Rolle, LiteLLM, Prometheus, Alertmanager
n8n/workflows/ importierbare n8n-Workflows
platform/proxmox/ OpenTofu + Ansible
sites/knaster/ standortspezifisch: Inventar, Registry
Entwicklung
make dev # venv + Abhängigkeiten
make test # Unit- und Integrationstests
make lint # ruff
make validate # Konsistenz Registry/Skills/LiteLLM/Healer/Policy/Katalog + Placement
make compose-check # docker compose config für alle Rollen
Alle Aktionen gegen Infrastruktur laufen standardmäßig im Dry-Run (KNASTER_DRY_RUN=true).