CLAUDE.md — one.OS Projektkontext

Pflichtlektüre vor jeder Session. Zuerst lesen, dann handeln. Detaillierte Agent-Specs: AGENTS.md + Agents/AGENT_*.md | Code-Navigation: CODE_INDEX.md

1. Projekt

one.OS — Autonome Kognitive Ökosystem-Plattform. Europäisches KI-Betriebssystem für Bildung, Wirtschaft und Innovation aus Heilbronn. Verbindet Hochschulen, Unternehmen und Forschung über ein Single Pane of Glass mit KI-Infrastruktur, Legal-Automatisierung und Agenten-Orchestrierung.

Kernbotschaft: „Das Ökosystem der Zukunft aus Heilbronn für Europa"

Aktuelle Basis: one.OS_local_v1.7.21.html | Nächste: v1.7.22 oder v1.8.0

Layer 0: ICP — Intelligent Campus Platform   (Single Pane of Glass)
Layer 1: Liquid AI                           (xPU-Pool, Site Clustering)
Layer 2: Sovereign Trust & Legal Fabric      (DCR, Verträge, Compliance)
Layer 3: ACE Intelligence                    (Multi-Agenten-Orchestrierung)
Layer 4: Ambient Interface                   (Datei-Analyse, Dokumenterstellung)

Parallelprojekte: myway100-vercel (Supabase + Vercel) · one_os_webapp (Tornado REST API)

2. Arbeitsweise — Wie Claude hier arbeitet

Schritt 1: Aufgabe verstehen (95%-Regel)

Kein Code, kein Design, keine Datei — bevor die Aufgabe zu ≥ 95% klar ist.

→ Was genau soll entstehen oder geändert werden?
→ In welcher Datei / auf welcher Seite?
→ Gibt es Constraints oder Nicht-Ziele?
Erst wenn diese drei Punkte klar sind: beginnen.

Schritt 2: Richtigen Agenten auswählen (aus AGENTS.md)

Wenn die Anfrage...	Dann...
analysiert, prüft, vergleicht	→ ANALYST (haiku) lesen lassen
ein neues Feature / neue Seite baut	→ ORCHESTRATOR → DESIGNER + DEVELOPER (sonnet)
einen Bug fixt oder UI tweakt	→ DEVELOPER (sonnet) direkt
Features aus Altdatei portiert	→ ORCHESTRATOR → INTEGRATOR (sonnet)
eine Version finalisiert	→ REVIEWER (haiku) → VERSIONER (haiku)

Modell-Routing: Sonnet → Coding & Design · Haiku → Analyse, Sub-Agenten, Versionierung · Opus → nur nach expliziter Bestätigung durch Jonas.

Schritt 3: Sub-Agenten parallel einsetzen

✅ Gleichzeitig: ANALYST (Quelle lesen) + ANALYST (Ziel lesen)
✅ Gleichzeitig: DESIGNER (CSS) + DEVELOPER (JS-Logik planen)
❌ Sequenziell: ANALYST → DESIGNER → DEVELOPER → REVIEWER → VERSIONER

Schritt 4: Qualitätsgate vor Ausgabe

Kein Hardcode — ausschließlich CSS-Variablen (Design-Tokens)
Glassmorphism konsistent (backdrop-filter + glass-bg + glass-border)
Alle neuen Funktionen mit Header-Kommentar
Neue Datei angelegt, keine bestehende überschrieben
CODE_INDEX.md aktualisiert (bei neuen Seiten/Funktionen)

3. Design-System (nie abweichen ohne Freigabe)

/* Design-Tokens — Pflicht, keine Hardcodes */
--bg-primary:   #050d1a    /* Deep Navy */
--accent-blue:  #2563eb    /* Electric Blue */
--accent-cyan:  #06b6d4    /* Cyan */
--accent-lime:  #84cc16    /* Neon-Lime */
--glass-bg:     rgba(255,255,255,0.04)
--glass-border: rgba(255,255,255,0.08)
--text-primary: #f1f5f9
--text-muted:   #94a3b8

Typografie: Syne (Display) · Outfit (Body) · JetBrains Mono (Code)

Glassmorphism-Standard:

background: var(--glass-bg);
border: 1px solid var(--glass-border);
backdrop-filter: blur(16px);
border-radius: 16px;

Animationen: max. 300ms · ease-out · nur transform + opacity · prefers-reduced-motion berücksichtigen

Verboten: Bootstrap/Tailwind-Klassen · neue Schriftarten ohne Freigabe · neue Farben ohne Freigabe · !important für Layout

4. Code-Standards (PFLICHT)

Single-File-Prinzip: Alles in einer HTML-Datei — kein separates CSS/JS
Vanilla JS: const/let, named functions, kein var, kein eval(), kein Framework
Bestehende Helfer nutzen: toast(), go(), icn(), icnBox(), openModal(), escHtml()
State: immer über STATE.* + Accessor-Funktionen, nie direkt in Closures mutieren
Suche: immer CODE_INDEX.md zuerst → gezielt in HTML springen, nie Vollsuche

Pflicht-Header für neue Funktionen:

// ─── [Agent] · [functionName] ──────────────────────────────────────────────
// [Was sie tut — 1 Satz]
// Called by: [Aufrufstelle] | Side effects: [STATE.x, toast(), go()]

5. Feature-Status (Stand: 2026-04-03)

Status	Feature
✅	Login/SSO, ICP, Liquid AI (Site Clustering), ACE (6 Agenten), Workspace-Wizard, Dashboard, Toast, AI Readiness Check
🔴	Layer 2 Legal Fabric (DCR, Vertragsgen., IP-Schutz) — Referenz: `one-os.html`
🔴	Ambient Interface Integration (Datei-Upload + KI-Analyse) — Referenz: `one-os.html`
🔴	Work Together Seite — Referenz: `one-os.html`
🟠	Workload-Slider (Liquid AI), Nutzerprofile Self-Marketing, WeMeet/Project/RiskAgent-Formulare
🟡	Communities/LMS, Policy Library, ROI-Kalkulation, Rollenbasiertes Routing

6. Versionierung (PFLICHT)

Änderungstyp	Inkrement	Beispiel
Bugfix, UI-Detail	PATCH	1.7.21 → 1.7.22
Neue Seite, neues Modul	MINOR	1.7.22 → 1.8.0
Redesign, Layer-Wechsel	MAJOR	1.8.x → 2.0.0

Regel: Neue Datei anlegen. Nie überschreiben. ANCHOR → MD5-Prüfsumme in Versions/ANCHOR_v*.md.

7. Dateistruktur

/claude.oneos/
├── CLAUDE.md          ← Diese Datei (Pflichtlektüre)
├── AGENTS.md          ← Agent-Routing, Modell-Zuweisung, Workflows
├── CODE_INDEX.md      ← Code-Navigation (Zeilen je Seite/Funktion)
├── Agents/            ← Individuelle Agent-Specs (AGENT_*.md)
├── Versions/          ← ANCHOR-Dokumentation + Feature-Audit
├── one_os_webapp/     ← Tornado REST Backend (Python)
├── myway100-vercel/   ← Vercel Serverless + Supabase
└── Demo Versions/     ← Präsentationsdateien

8. Eskalation — immer Jonas fragen

Neues Framework / externe Library benötigt
ANCHOR-Datei soll verändert werden
Aufgabe erfordert Opus-Modell
Grundlegende Architekturänderung
Neue Farbe oder Schriftart außerhalb des Design-Systems

CLAUDE.md v2.0 | 2026-04-03 | Änderungen nur mit Freigabe Jonas

6.4 KiB Raw Permalink Blame History