Das ganze Regelwerk
Aerona wird nach aufgeschriebenen Regeln gebaut. Ein Thema, eine Datei – wer eine Regel ändert, ändert sie an einer Stelle. Hier stehen alle, jede mit ihrem Kern. Zusammengeführt wurde das Regelwerk am 25. Juli 2026, und seither wird daran weitergeschrieben: Zuletzt kamen die Regeln 32 zur Designsprache und 33 zur Bewegung dazu, beide gültig für jedes Aerona-Produkt. Vollständig nachlesen lässt sich jede Regel unter Die Regeln einzeln.
Auf einen Blick
Dateien im Regelwerk
Zeilen höchstens je Datei
Thema je Datei
Die zwanzig Grundsätze
Über den einzelnen Dateien stehen zwanzig Grundsätze. Jeder nennt die Regel, in der er ausführlich steht. Sie stehen ganz oben im Inhaltsverzeichnis des Regelwerks, noch vor der Liste der Dateien. Wer einen genauer wissen will, folgt der Nummer in der letzten Spalte.
| Nr. | Grundsatz | Worum es geht | Regel |
|---|---|---|---|
| 1 | 1000-%-Prinzip | Premium-Niveau, keine drittklassige Software. | 00 Anspruch |
| 2 | Alles-Vereiner | Wie Windows, aber mit dem Besten aller Systeme. | 00 Vision |
| 3 | 300-Zeilen-Regel | Keine Quelldatei darf mehr als 300 Zeilen haben. | 02, zerlegt wird nach 03 |
| 4 | Immer Deutsch | Antworten und Kommentare deutsch, Code englisch. | 04 |
| 5 | Voller Code | Niemals „// Rest bleibt gleich“. | 02 |
| 6 | Git ist Pflicht | Vor jedem Umbau eine Sicherung. | 05 |
| 7 | Nichts geht verloren | Archiv statt Löschen, Beweis vor dem Löschen. | 06 |
| 8 | Erst denken, dann coden | Die Ursache suchen, nicht das Symptom. | 01 und 07 |
| 9 | Engine ≠ Content | Engine und Inhalt sind strikt getrennt, damit die Engine aktualisierbar bleibt. | 00 Anspruch |
| 10 | Charme in den Momenten | Kalt ist genauso durchgefallen wie billig. | 21 |
| 11 | Local First | Was auf dem Rechner bleiben kann, verlässt ihn nicht. | 27 |
| 12 | Datenhaltbarkeit | Was Aerona schreibt, kann Aerona in zehn Jahren noch lesen. | 28 |
| 13 | Nicht raten, messen | Jede Behauptung braucht eine Quelle. | 31 |
| 14 | Eine eigene Welt | Alles selbst gemacht, nichts Standard, immer die neueste eigene Fassung. | 34 |
| 15 | Selbstständig, aber belegt | Selbst entscheiden und weiterbauen; Unumkehrbares ist gesperrt, jede Behauptung hat einen Beleg. | 35 |
| 16 | Aeri wirbt immer mit | Jedes Werbemotiv aus eigenem Code, ehrlich, auf Englisch, mit Aeri. | 36 |
| 17 | Für jeden, auf jedem Gerät | Vom alten Handy bis zum großen Bildschirm; eine Maschine misst jede Seite. | 37 |
| 18 | Scharf bis 8K | Alles, was man sieht, ist auf 8K gestochen scharf; nichts wird hochgerechnet. | 38 |
| 19 | Takt und Qualität | Schnell arbeiten ohne Abstriche; fertig ist erst, was gebaut und geprüft ist. | 39 |
| 20 | Lange Abläufe | Minuten statt Stunden: nur Neues rechnen, gleichzeitig, fortsetzbar – ohne eine Prüfung wegzulassen. | 40 |
„Bei Unsicherheit gilt immer: lieber nachfragen als raten.“
Aus dem Inhaltsverzeichnis der Regeln
Alle Regeln
| Nr. | Regel | Der Kern |
|---|---|---|
| 00 | Anspruch, Architektur und Design-Philosophie | Gearbeitet wird auf höchstem Niveau – das 1000-Prozent-Prinzip. |
| 00 | Die Vision | Alles, was jedes Betriebssystem der Welt hat. AetherOS bedient sich so vertraut wie Windows. |
| 01 | Zusammenarbeit mit KI-Assistenten | Die KI arbeitet wie eine erfahrene Entwicklerin und antwortet immer auf Deutsch. |
| 02 | Architektur und Code | Keine Quelldatei darf mehr als 300 Zeilen haben. |
| 03 | Zerlegen nach der 300-Zeilen-Regel | Wie jede Art von Datei richtig zerlegt wird – und wann man es besser lässt. |
| 04 | Code-Sprache, Kommentare und Dokumentation | Code englisch, alles Erklärende deutsch. |
| 05 | Git und Versionierung | Jedes Projekt ist ein Git-Repository, ohne Ausnahme. |
| 06 | Aufräumen ohne Verlust | Nichts Sichtbares oder Funktionierendes darf verschwinden. Archiv statt Löschen. |
| 07 | Sicherheit, Qualität und Fehlersuche | Die Ursache heilen, nicht das Symptom flicken. |
| 08 | Das Bautagebuch | Jeder Bauschritt wird mitgeschrieben, fertig für die Webseite. |
| 09 | Ordnerstruktur und Pfade | Nummerierte Themenbereiche, keine festen Laufwerkspfade. |
| 10 | Oberfläche, Design und Frontend | Was nur funktioniert, aber billig aussieht, ist durchgefallen. |
| 11 | CSS-Architektur | Einfaches CSS in Modulen, jede Datei unter 300 Zeilen. |
| 12 | App Engine und React | Die App Engine läuft auf React, alles andere auf HTML, CSS und JavaScript. |
| 13 | Übersetzungen: das 85-Sprachen-System | Kein sichtbarer Text steht direkt im Code. |
| 14 | Zustand und Browser-Speicher | Alle gespeicherten Schlüssel beginnen mit „aerona_“. |
| 15 | Simulator und Entwicklerwerkzeuge | Der Simulator zeigt die Oberfläche auf echten Geräten. |
| 16 | Auslieferung, Electron und Veröffentlichungen | Aerona läuft als Windows-Anwendung über Electron. |
| 17 | Markenidentität und Tonfall | Hochwertige Software, gefertigt in Deutschland. |
| 18 | Updatetexte | Die verbindliche Vorgabe für Änderungsberichte – ihre Quelle ist das Bautagebuch. |
| 19 | Das App-Format .aero | Ein eigenes App-Format als offizieller Weg. |
| 20 | Sparsam arbeiten | KI-Kontingente sind begrenzt – also sparsam arbeiten. |
| 21 | Charme, Verspieltheit und Belohnung | Durchgefallen ist auch, was sich nach niemandem anfühlt. |
| 22 | Leistung und Ladezeit | Zeit sparen beim Benutzen – belegt mit gemessenen Zahlen. |
| 23 | Bildsprache: Emojis, Symbole, Illustrationen | 3.979 eigene Emojis im aktuellen Satz, in 50 Kategorien. |
| 24 | Prüfen und Messen | Wie geprüft wird – und wie man eine Prüfung erkennt, die nichts prüft. |
| 25 | Barrierefreiheit | „Aerona ist exklusiv im Look und inklusiv in der Nutzbarkeit.“ |
| 26 | Erster Start und Einführung | Der erste Start lässt sich nicht wiederholen. |
| 27 | Datenschutz und Local First | Die Daten der Nutzer bleiben geschützt – und zuerst auf dem eigenen Gerät. |
| 28 | Datenhaltbarkeit und Migration | Was Aerona schreibt, muss es in zehn Jahren noch öffnen können. |
| 29 | Fremdcode und Abhängigkeiten | Fremdpakete wie React oder Electron sind in Ordnung – mit Bedacht. |
| 30 | Wenn es beim Nutzer bricht | Ohne Telemetrie erfahren wir Fehler nur, wenn Nutzer sie melden. |
| 31 | Nicht raten, sondern messen | Jede Behauptung braucht eine Quelle. |
| 32 | Die Designsprache | Was in jedem Aerona-Produkt gleich ist. |
| 33 | Bewegung | Keine Bewegung ist Standard. |
| 34 | Eine eigene Welt | Alles, was man sieht, hört oder anfasst, ist selbst gemacht. |
| 35 | Selbstständig weiterbauen – aber belegt | Selbst entscheiden über eine Leiter; was sich nicht zurückholen lässt, ist gesperrt. |
| 36 | Marketing und Werbung | Werbung aus eigenem Code, auf Englisch, mit Aeri und jeder Zahl nachgezählt. |
| 37 | Für jeden, auf jedem Gerät | Jedes eigene Teil hat einen Rückfall, gemessen auf fünf Geräten. |
| 38 | Scharf bis 8K | Code und Vektor zuerst, Bilder nur in ihrer 8K-Größe. |
| 39 | Takt und Qualität | Nie leer warten, bündeln, gezielt prüfen – ohne eine andere Regel zu lockern. |
| 40 | Lange Abläufe | Nur Neues rechnen, gleichzeitig, fortsetzbar – ohne eine Prüfung wegzulassen. |
Der Kern steht so am Anfang jeder Regeldatei. Die Tafel ist vom 15. September 2026, die Zeilen für 32 und 33 kamen am 25. September dazu, die für 34 bis 40 am 5. Oktober. Es sind 42 Zeilen für 43 Dateien, weil die dreiundvierzigste das Inhaltsverzeichnis selbst ist. Die Kurzfassung mit den neun wichtigsten Regeln steht auf So arbeiten wir.
Zwei Teile
Das Regelwerk ist in zwei Teile gegliedert. Der erste gilt immer, der zweite nur für bestimmte Aufgaben. Welche Regeln aus dem zweiten Teil man liest, hängt davon ab, woran man arbeitet – das steht weiter unten unter „In welcher Reihenfolge man sie liest“.
Regeln in Teil A – sie gelten immer, in jedem Projekt
Regeln in Teil B – je nach Aufgabenbereich
Teil A
Dazu gehören Vision und Anspruch, Code und Git, Aufräumen, Sicherheit, das Bautagebuch, Leistung, Prüfen, Datenschutz, Datenhaltbarkeit und Fremdcode – außerdem die Zusammenarbeit mit KI, Ordner und Pfade, sparsames Arbeiten, was geschieht, wenn es beim Nutzer bricht, und die Regel, nicht zu raten. Sie gelten in jedem Projekt, egal woran man gerade arbeitet.
Teil B
Dazu gehören Oberfläche und CSS, Übersetzungen, die Marke, Charme, Bildsprache, Barrierefreiheit und der erste Start, dazu App Engine und React, Browser-Speicher, Simulator, Auslieferung, Updatetexte und das App-Format. Seit September stehen hier auch die Designsprache und die Bewegung; diese beiden gelten für jedes Produkt, das ein Mensch zu Gesicht bekommt.
Zusammengeführt wurde das Regelwerk am 25. Juli 2026. Die drei früheren Fassungen aus Januar, Februar und Juli 2026 liegen unverändert im Archiv. Nachschlagen darf man sie – als Regel gelten sie nicht mehr. Ebenfalls dort liegen alte Anleitungen für Server, die ein Backend beschreiben, das nicht mehr zu Aerona gehört.
Die Regeln, die am häufigsten zählen
300 Zeilen
Keine Quelldatei darf mehr als 300 Zeilen haben. Kein Vorschlag, eine Grenze. Nähert sich eine Datei ihr, ab etwa 250 Zeilen, wird sie vorher zerlegt. Im Betriebssystem gibt es seit dem 13. September 2026 keine Ausnahme mehr.
Archiv statt Löschen
Vor dem Löschen braucht es den Beweis, dass etwas tot ist. Sonst kommt es ins Archiv. Das Regelwerk selbst ist ein Beispiel: Seine drei früheren Fassungen gelten nicht mehr, liegen aber unverändert dort.
Das Bautagebuch
Jeder sichtbare Bauschritt wird aufgeschrieben – daraus entstehen die Änderungsberichte. Jeder Eintrag ist so geschrieben, dass er ohne Umschreiben auf die Webseite kann; ausgenommen sind nur Übersetzungen und Aufräumarbeit ohne sichtbare Wirkung. Nachlesen kann man es unter Das Bautagebuch.
Nicht raten, sondern messen
Jede Zahl auf dieser Webseite soll gezählt sein. Was sich nicht belegen lässt, kommt raus. Deshalb nennen Zahlen hier ihren Tag, und wo eine Zählung falsch war, steht auch das – unter Aerona in Zahlen.
In welcher Reihenfolge man sie liest
Wer neu dazukommt, ob Mensch oder KI-Werkzeug, liest zuerst neun Regeln in fester Reihenfolge. Davor kommt noch ein Blick auf den Stand: Ein Werkzeug zeigt in Sekunden, was es gibt und welche Dateien zu lang sind, statt dass man sich durch Ordner liest.
- 20 · Sparsam arbeiten – erst messen, dann lesen.
- 31 · Nicht raten, sondern messen – warum hier nichts geraten wird.
- 00 · Die Vision – wohin AetherOS soll.
- 00 · Anspruch, Architektur und Design-Philosophie – das Arbeitsniveau.
- 02 · Architektur und Code – der Code-Stil.
- 04 · Code-Sprache, Kommentare und Dokumentation – Code englisch, Erklärungen deutsch.
- 05 · Git und Versionierung – vor jedem Umbau eine Sicherung.
- 06 · Aufräumen ohne Verlust – Archiv statt Löschen.
- 24 · Prüfen und Messen – warum eine grüne Prüfung noch nichts beweist.
An der Webseite
Dazu die Regeln 10, 11, 13 und 18: Oberfläche, CSS, Übersetzungen und Updatetexte.
Am Betriebssystem
Dazu die Regeln 03, 19 und 16: Zerlegen, das App-Format und die Auslieferung.
An einer Oberfläche für Menschen
Zusätzlich die Regeln 32 und 33 – die Designsprache gilt in jedem Produkt gleich – sowie 21, 25 und 26: Charme, Barrierefreiheit und der erste Start.
Etwas schneller machen
Dazu Regel 22. Dort stehen auch die Sackgassen, die schon jemand abgelaufen ist.
Ein Format, das beim Nutzer landet
Dazu Regel 28 – und zwar bevor die erste Zeile geändert wird.
Wie eine Regel entsteht
Viele Regeln wurden nicht am Schreibtisch erdacht, sondern haben einen Anlass: etwas, das schiefging, und die Frage, warum. Vier Beispiele aus einer einzigen Regel – der über die Oberfläche –, so wie sie dort stehen.
| Regel | Was passiert ist | Was seitdem gilt |
|---|---|---|
| 10.12 · Ring oder Fläche erweitert am 07.09.2026 | Ein durchsichtiger Hinweisknopf bekam einen Ring aus Punkten und zusätzlich eine Fläche aus Punkten – heraus kam ein graues Raster. Kevin: „das mit den Punkten gibt es nur bei Kästen, die in Aerona-Farben sind, weil man da den Rahmen nicht sehen würde.“ | Ring oder Fläche, der Grund entscheidet – nie beides gleichzeitig. |
| 10.15 · Die Grenze der Unschärfe Hauswert seit 13.09.2026 | Durch zwei Glasscheiben im Design-Schaukasten sah man nichts. Nachgemessen lag es am Radius: vierzehn Pixel Unschärfe auf elf Pixel Linienabstand. | Der Radius wird gerechnet, nicht geschätzt. Für die ganze Webseite gilt ein Wert: vier Pixel. |
| 10.16 · Was ein Kasten wegschneidet gemeldet am 07.09.2026 | „jetzt kommt nichts mehr“ – dabei war der Ring an allen sechs gemessenen Bauteilen da. Vier davon schnitten ihn mit ihrem eigenen Rand weg. | Wer einen Ring anhängt, prüft zuerst, ob der Kasten schneidet. |
| 10.17 · Antworten statt Ausweichen Glas starr seit 13.09.2026 | An den Kacheln des Verzeichnisses kam der Ring – aber die Kachel hob sich daneben um drei Pixel, und man sah nur das. | Glaskästen bleiben beim Zeigen stehen. Antworten darf nur, was sich im Kasten regt. |
„Die Regel war also da — sie stand nur nirgends. Deshalb konnte man sie nicht nachlesen, sondern nur verletzen.“
Regel 10 · Oberfläche, Design und Frontend
Was eine Maschine prüft
Regeln, die niemand nachprüft, sind Papier. Einen Teil davon prüfen deshalb Werkzeuge, den Rest ein Mensch. Welche Regel wie geprüft wird, steht im Inhaltsverzeichnis des Regelwerks – samt dem Hinweis, dass auch diese Angabe eine Behauptung ist, die nachgezogen werden muss.
Das Regel-Werkzeug
Es macht dreizehn Prüfungen zu neun Regeln: 09, 10, 11, 16, 22, 25, 27, 29 und 34. Nachgezählt am 6. Oktober 2026. Kommt eine Prüfung dazu oder fällt eine weg, ändert sich die Zahl – deshalb steht das Datum dabei.
Die 300-Zeilen-Grenze
Ein zweites Werkzeug misst sie für den ganzen Bestand. Es gehört zum ersten Blick auf den Stand, noch vor jeder Arbeit – so fällt eine zu lange Datei auf, bevor sich jemand an sie gewöhnt.
Bewusst nicht geprüft
Eine Prüfung, die hunderte richtige Zeilen meldet, wird ignoriert. Was ausgelassen wird, ist deshalb am ganzen Bestand gemessen und begründet. Die Gründe stehen im Kopf des Werkzeugs selbst.
Der Rest
Alle übrigen Regeln brauchen weiter einen Menschen, der hinsieht. Dazu gehören etwa Tonfall, Charme und Bildsprache – Regeln, bei denen es auf ein Urteil ankommt.
Weiter
So arbeiten wir
Die neun wichtigsten Regeln als Kurzfassung, jede mit ihrem Grund – und vier davon mit dem Beleg, woran man sie heute sieht.
Klare Haltung
Wo Aerona nicht vertreten ist – und warum. Zwei Entscheidungen, jede mit ihren Gründen.
Barrierefreiheit
Was die Webseite dafür tut. Die Grundlage ist Regel 25: exklusiv im Look, inklusiv in der Nutzbarkeit.
