191 lines
6.7 KiB
Markdown
191 lines
6.7 KiB
Markdown
# 🧭 KI-Cluster Roadmap
|
|
|
|
## 🎯 Projektziel
|
|
Ein autonomes, modulares KI-Entwicklungscluster für dein Homelab, das in der Lage ist:
|
|
- Software eigenständig zu **planen**, **entwickeln**, **testen** und **dokumentieren**,
|
|
- mit dir als Benutzer **strategisch zu planen** und **Entscheidungen abzustimmen**,
|
|
- **Langzeitwissen** zu speichern und daraus zu lernen,
|
|
- und die gesamte Arbeit in **Planung** und **Code** klar zu trennen.
|
|
|
|
---
|
|
|
|
## 🗂️ Strukturprinzip
|
|
|
|
Jeder Roadmap-Punkt ist ein **eigener Unterordner**, der zwei Hauptbereiche enthält:
|
|
|
|
| Ordner | Zweck |
|
|
|--------|--------|
|
|
| **/Planung** | Enthält alle Konzepte, Architekturideen, Diagramme, Systembeschreibungen und Spezifikationen. |
|
|
| **/Entworfener_Code** | Beinhaltet den von der KI erzeugten, getesteten und funktionsfähigen Code, Skripte oder fertige Module. |
|
|
|
|
Diese Trennung erlaubt eine saubere Zusammenarbeit zwischen **Strategie- und Builder-Agenten**:
|
|
- Die Planung dient als Input für den Builder-Agenten.
|
|
- Der fertige Code landet im Unterordner `/Entworfener_Code/`.
|
|
|
|
---
|
|
|
|
## 📁 Verzeichnisstruktur
|
|
|
|
```plaintext
|
|
/KI-Cluster
|
|
│
|
|
├── readme.markdown ← Diese Datei (Projektübersicht)
|
|
│
|
|
├──/00_Globale_Richtlinien/Entworfener_Code/
|
|
│ │
|
|
│ ├── start.py ← Einstiegspunkt für jede Komponente
|
|
│ ├── config.yaml ← Globale Laufzeitkonfiguration (Port, Logging)
|
|
│ ├── README.md ← Beschreibung der Basiskomponente
|
|
│ │
|
|
│ ├── src/
|
|
│ │ ├── webserver.py ← Einheitlicher HTTP-Server (zeigt README, bietet /api/)
|
|
│ │ ├── logmodul.py ← Zentrales Logging-System mit Rotation
|
|
│ │ └── placeholder_logic.py ← Beispielhafte Logik als Platzhalter
|
|
│ │
|
|
│ └── log/ ← Automatisch angelegte Logdateien (7 Tage / 12 MB Rotation)
|
|
│
|
|
├── 01_Zieldefinition_und_Subsysteme/
|
|
│ ├── Planung/
|
|
│ │ ├── Zieldefinition.md
|
|
│ │ ├── Systemvision.md
|
|
│ │ ├── Subsystem_Uebersicht.md
|
|
│ │ └── Agenten_Uebersicht.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (spätere Prototypen oder System-Demos)
|
|
│ └── README.md
|
|
│
|
|
├── 02_API_Design_und_Kommunikation/
|
|
│ ├── Planung/
|
|
│ │ ├── API_Schnittstelle.md
|
|
│ │ ├── Kommunikationsprotokolle.md
|
|
│ │ └── Nachrichtenformate.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (API-Spezifikationen, JSON/YAML-Dateien, Tests)
|
|
│ └── README.md
|
|
│
|
|
├── 03_Router_und_Orchestrator/
|
|
│ ├── Planung/
|
|
│ │ ├── Router.md
|
|
│ │ ├── Routing_Logik.md
|
|
│ │ ├── Ereignissteuerung.md
|
|
│ │ └── Router_API_Integration.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (Router-Implementierungen, Skripte)
|
|
│ └── README.md
|
|
│
|
|
├── 04_Hauptagenten/
|
|
│ ├── Planung/
|
|
│ │ ├── StrategieAgent.md
|
|
│ │ ├── DenkerAgent.md
|
|
│ │ ├── BuilderAgent.md
|
|
│ │ ├── DiagrammAgent.md
|
|
│ │ ├── GedaechtnisAgent.md
|
|
│ │ └── Agenten_Logik_Vergleich.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (Agenten-Prototypen, Skripte, Konfigurationen)
|
|
│ └── README.md
|
|
│
|
|
├── 05_Hilfsagenten/
|
|
│ ├── Planung/
|
|
│ │ ├── MemoryManager.md
|
|
│ │ ├── WebResearchAgent.md
|
|
│ │ ├── EvaluatorAgent.md
|
|
│ │ ├── PolicyAgent.md
|
|
│ │ └── KommunikationsAgent.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (Hilfsagenten-Code, Datenmodule)
|
|
│ └── README.md
|
|
│
|
|
├── 06_Datenspeicher_und_Gedaechtnis/
|
|
│ ├── Planung/
|
|
│ │ ├── Speicherstruktur.md
|
|
│ │ ├── Projektkontext_Index.md
|
|
│ │ └── Zugriffssysteme.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (z. B. Datenbankadapter, Index-System)
|
|
│ └── README.md
|
|
│
|
|
├── 07_Workflow_und_Kommunikationsfluss/
|
|
│ ├── Planung/
|
|
│ │ ├── Workflow_Uebersicht.md
|
|
│ │ ├── Diagramme.md
|
|
│ │ └── Agenten_Fluss.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (Eventsteuerung, Workflow-Skripte)
|
|
│ └── README.md
|
|
│
|
|
├── 08_Builder_Autonomie/
|
|
│ ├── Planung/
|
|
│ │ ├── Builder_Prozess.md
|
|
│ │ ├── Testsysteme.md
|
|
│ │ ├── Dokumentationspipeline.md
|
|
│ │ └── Autonomie_Fluss.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (Builder-Agent Code, Testframeworks)
|
|
│ └── README.md
|
|
│
|
|
├── 09_Dokumentationssystem/
|
|
│ ├── Planung/
|
|
│ │ ├── HowTo_Generator.md
|
|
│ │ ├── API_Doku_Generator.md
|
|
│ │ └── Strukturkonzept.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (Dokumentationsgenerator, Skripte)
|
|
│ └── README.md
|
|
│
|
|
├── 10_Sicherheit_und_Policy/
|
|
│ ├── Planung/
|
|
│ │ ├── Datenschutz.md
|
|
│ │ ├── Compliance.md
|
|
│ │ └── Zugriffskontrolle.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (Policy-Module, Audit-Systeme)
|
|
│ └── README.md
|
|
│
|
|
├── 11_Infrastruktur/
|
|
│ ├── Planung/
|
|
│ │ ├── Deployment_Struktur.md
|
|
│ │ ├── Container_Setup.md
|
|
│ │ ├── Monitoring_System.md
|
|
│ │ └── Netzwerkarchitektur.md
|
|
│ ├── Entworfener_Code/
|
|
│ │ └── (Dockerfiles, Setup-Skripte)
|
|
│ └── README.md
|
|
│
|
|
└── 12_Zukunft_und_Erweiterungen/
|
|
├── Planung/
|
|
│ ├── Neue_Modelle.md
|
|
│ ├── CrossCluster_KI.md
|
|
│ └── Lernsysteme.md
|
|
├── Entworfener_Code/
|
|
│ └── (Prototypische Erweiterungen)
|
|
└── README.md
|
|
yaml
|
|
Code kopieren
|
|
|
|
---
|
|
|
|
## ⚙️ Arbeitsweise
|
|
|
|
1. **Planungsphase**
|
|
- Hier entsteht das Wissen, die Logik und die Struktur.
|
|
- Alles, was gedanklich erarbeitet oder modelliert wird, liegt in `/Planung/`.
|
|
|
|
2. **Implementierungsphase (KI-generiert)**
|
|
- Der Builder-Agent oder eine andere KI liest aus `/Planung/`.
|
|
- Sie erzeugt daraus Code, Tests und Dokumentation → legt alles in `/Entworfener_Code/` ab.
|
|
|
|
3. **Validierung & Rückkopplung**
|
|
- Wenn der Code funktioniert, kann der Builder-Agent automatisch
|
|
Planungsdokumente oder Diagramme in `/Planung/` aktualisieren.
|
|
|
|
---
|
|
|
|
## 🔗 Querverweise
|
|
|
|
Jeder Unterordner enthält am Ende seiner README:
|
|
```markdown
|
|
## Verweise
|
|
- [⬅ Zurück zur Hauptroadmap](../readme.markdown)
|
|
- Nächster Schritt: [Router und Orchestrator](../03_Router_und_Orchestrator/README.md)
|