125 lines
3.9 KiB
Markdown
125 lines
3.9 KiB
Markdown
# ODY Design Constitution
|
|
|
|
> Version 1.0 · 2026-07-19 · Single Source of Truth
|
|
|
|
Design decisions in this project follow these principles.
|
|
When in doubt, check: does this choice reinforce or contradict the constitution?
|
|
|
|
---
|
|
|
|
## Core Statement
|
|
|
|
**ODY ist kein Chatbot. ODY ist ein Werkzeug.**
|
|
|
|
Ein Werkzeug fragt den Nutzer nicht nach seinem Namen.
|
|
Ein Werkzeug erklärt sich nicht selbst.
|
|
Ein Werkzeug ist einfach da, wenn man es braucht.
|
|
|
|
---
|
|
|
|
## Grundprinzipien
|
|
|
|
### 1. Provision once. Depend never.
|
|
|
|
ODY wird einmal eingerichtet — bewusst, mit Zeit, mit Internet wenn nötig.
|
|
Danach gehört es dem Nutzer. Vollständig.
|
|
|
|
Der tägliche Betrieb darf nie von Cloud-Diensten, Accounts, Servern oder
|
|
Internetverbindungen abhängen. Nicht still, nicht sichtbar, nicht im Hintergrund.
|
|
|
|
**Drei Phasen:**
|
|
|
|
| Phase | Wann | Internet erlaubt? |
|
|
|---|---|---|
|
|
| **Provision** | Einmalig oder bewusst ausgelöst | Ja — Modell laden, Updates, Import |
|
|
| **Operate** | Täglich, überall | Nein — vollständig autark |
|
|
| **Maintain** | Selten, bewusst | Ja — Update, Backup, Gerätewechsel |
|
|
|
|
### 2. Offline-first, nicht Offline-only
|
|
|
|
ODY muss funktionieren wenn kein Internet da ist.
|
|
ODY darf Internet nutzen wenn der Nutzer es bewusst auslöst.
|
|
|
|
Das ist kein Dogma — es ist ein Qualitätsmerkmal.
|
|
Wie ein Messer das auch nach Jahren noch schneidet.
|
|
|
|
### 3. Personalisierung gehört zum Provisioning
|
|
|
|
Ein Werkzeug darf auf seinen Besitzer abgestimmt werden. Es darf den Nutzer aber nie zwingen,
|
|
sich immer wieder neu einzurichten.
|
|
|
|
Beim ersten Start darf ODY fragen:
|
|
- Name für den Assistenten (optional)
|
|
- Sprache und Stimme
|
|
- Modell auswählen
|
|
- Datenschutz-Entscheidungen bestätigen
|
|
|
|
Das ist kein Marketing-Onboarding. Das ist das Schärfen und Gravieren des Messers.
|
|
|
|
**Ab dem zweiten Start gilt kompromisslos:**
|
|
App öffnet direkt im Chat. Keine Begrüßung. Keine Tour. Keine erneuten Fragen.
|
|
Das Werkzeug ist bereit.
|
|
|
|
> Personalisierung ist Teil des Provisionings.
|
|
> Sie findet einmalig statt und darf den täglichen Betrieb niemals unterbrechen.
|
|
|
|
### 4. Vertrauen statt Marketing
|
|
|
|
ODY zeigt nicht was es kann.
|
|
ODY zeigt worauf man sich verlassen kann.
|
|
|
|
Der Header zeigt permanent:
|
|
```
|
|
🛡 Autark · 🧠 [Modell oder "Kein Modell"] · 📱 Dieses Gerät · 🔋 [Akku]
|
|
```
|
|
|
|
Kein Splash-Screen. Kein wiederholtes Onboarding. Kein Tutorial beim zweiten Start.
|
|
Ab dem zweiten Start: App öffnen — Cursor im Eingabefeld — loslegen.
|
|
|
|
### 5. Simulation wird immer gekennzeichnet
|
|
|
|
Wenn kein echtes Modell geladen ist, zeigt ODY `[Simulation]`.
|
|
Niemals wird eine simulierte Antwort als echte Inferenz dargestellt.
|
|
|
|
Wenn das lokale Modell aktiv ist: `Autark · Lokales Modell aktiv`
|
|
Wenn Stub aktiv ist: `[Simulation] · Kein Modell geladen`
|
|
|
|
### 6. Werkzeug-Philosophie
|
|
|
|
Sofort einsatzbereit: App öffnen → Cursor im Eingabefeld → loslegen.
|
|
|
|
Eine Hauptfunktion: Der Chat ist die zentrale Oberfläche.
|
|
Alles andere ist erreichbar, drängt sich aber nicht auf.
|
|
|
|
Keine Überraschungen: Offline bedeutet wirklich offline.
|
|
|
|
Kompakt, nützlich, vielseitig, strukturiert, einfach in der Handhabung.
|
|
Das Schweizer Taschenmesser — nicht das Schweizer Taschenmesser-Katalog.
|
|
|
|
---
|
|
|
|
## Was ODY nicht ist
|
|
|
|
- Kein Cloud-Chatbot mit Offline-Modus
|
|
- Kein Hugging-Face-Browser
|
|
- Kein verstecktes PocketPal
|
|
- Kein Feature-Showcase
|
|
- Kein Marketing-Produkt
|
|
|
|
---
|
|
|
|
## Für Entwickler und KI-Agenten
|
|
|
|
Vor jeder Entscheidung — Feature, Design, Architektur — diese Fragen:
|
|
|
|
1. Funktioniert das noch wenn kein Internet da ist? (Operate-Phase)
|
|
2. Schafft das eine Abhängigkeit die der Nutzer nicht kontrolliert?
|
|
3. Zeigt das dem Nutzer was er sich verlassen kann — oder was ODY kann?
|
|
4. Ist eine Simulation klar als Simulation gekennzeichnet?
|
|
|
|
Wenn eine dieser Fragen mit „Nein" beantwortet wird: Entscheidung überdenken.
|
|
|
|
---
|
|
|
|
*Dieses Dokument ist eine Verfassung, kein Lastenheft.*
|
|
*Wenige Grundsätze. Langer Bestand. Keine Sprint-Notizen.*
|