Jede Seite gibt es auch als Markdown unter ihrer Adresse mit .md: /farbe.md, /iphone.md, /en/stimme.md. Die Startseite heißt /index.md. Wo ein Mensch ein Farbfeld sieht, steht im Markdown eine Tabelle mit Token, Wert hell, Wert dunkel und Bedeutung.
/llms.txt folgt dem Vorschlag von llmstxt.org: ein kurzes Verzeichnis in Markdown, mit einem Satz je Kapitel und den Adressen der Daten. Ein Agent liest es zuerst und lädt dann nur, was er braucht. /llms-full.txt und /en/llms-full.txt enthalten alle Kapitel einer Sprache in einer Datei.
| Datei | Wann laden |
|---|
regeln.json | vor jedem Text und jeder Oberfläche: verbotene Wörter, Register mit Satzlängen, Format von Zeit und Datum, Gestaltungsregeln, Definition of Done |
tokens/tokens.json | vor jedem Code mit Farbe, Maß oder Schrift: jeder Token mit CSS-Variable, hell, dunkel und Bedeutung |
bauteile.json | vor jeder Oberfläche: alle Bauteile mit Quelle, Typen und Prompt |
Kapitel als .md | für die Aufgabe selbst, etwa iphone.md für einen Screen oder social-media.md für ein Motiv |
Die Namen von Tokens, Bauteilen und Props sind deutsch, mit Absicht. Ein Agent übersetzt sie nicht.
/skill/SKILL.md ist ein Agent-Skill. Er sagt einem Agenten, welche Dateien er zuerst lädt und welche Regeln nie gebrochen werden. Er entsteht beim Bau aus regeln.json.
So bindest du ihn in Claude Code ein:
# für dieses Repository
mkdir -p .claude/skills/hey-albert-brand
curl -s https://brand.heyalbert.family/skill/SKILL.md -o .claude/skills/hey-albert-brand/SKILL.md
# für alle eigenen Projekte
mkdir -p ~/.claude/skills/hey-albert-brand
curl -s https://brand.heyalbert.family/skill/SKILL.md -o ~/.claude/skills/hey-albert-brand/SKILL.md
Im Monorepo selbst gibt es dazu den Skill hey-albert-design. Er zeigt direkt auf packages/design-system und braucht keinen Download. Für Texte gibt es den Skill texten.
Gute Aufträge nennen die Quelle, die Familie, die Grenze und die Prüfung. Die folgenden Vorlagen lassen sich kopieren und anpassen.
Bau die Fläche „Heute“ für das iPhone in apps/web.
Lies zuerst https://brand.heyalbert.family/iphone.md, /bauteile.json und /tokens/tokens.json.
Nimm nur Bauteile aus packages/design-system; fehlt eines, leg es dort zuerst an.
Daten: Seed Familie Sonntag, Mittwoch 3. September. Lena (9) hat 15:30 Schwimmen, Tobias fährt.
Fertig heißt: leerer Zustand, Skelett, :focus-visible, hell und dunkel, Rückgängig, Zielflächen 44/56.
Prüfe am Ende mit dem Agenten design-pruefer und pnpm qa.
Schreib den leeren Zustand für die Einkaufsliste.
Register: Family Manager (R2), höchstens 12 Wörter je Satz. Regeln: /regeln.json.
Drei Teile: was hierher gehört, warum es leer ist, ein Knopf mit einem Verb.
Kein Ausrufezeichen, kein Emoji, „ihr“ zur Familie. Beispiel mit Familie Sonntag.
Gib zwei Fassungen und sag, welches Register du gewählt hast.
Entwirf einen Instagram-Beitrag 4:5 zum Thema Fahrten.
Lies /social-media.md und /bildsprache.md. Fläche Blau, weil es um eine Fahrt geht.
Titel als Szene mit Uhrzeit und Name: „Freitag, 18:40. Oma Grete fährt.“
Screen: Main (iPhone). Keine Kindergesichter, kein Stockfoto, kein erzeugtes Bild.
Wörter aus nie_in_der_vermarktung in /regeln.json sind tabu.
Prüfe apps/web/src/app/(albert)/(app)/heute gegen das Designsystem.
Grundlage: /regeln.json (gestaltung, fertig) und /tokens/tokens.json.
Finde Hex-Werte, Schatten, freie Radien, Deckkraft für inaktiv, :focus statt :focus-visible,
Zielflächen unter 44, verbotene Wörter, fehlende leere Zustände.
Ändere nichts. Gib je Fund Datei, Zeile, Regel und Vorschlag.
Zwei Dinge heißen ähnlich und sind getrennt.
Agenten beim Arbeiten schreiben Code, Texte und Entwürfe für das Team. Für sie gilt diese Seite.
Albert im Produkt liest nur Post, für die eine Regel der Familie greift. Jede Ableitung ist ein Vorschlag mit Vorschau, „Übernehmen“ und „Rückgängig“. Nichts wird still geändert oder versendet. An ein Modell geht erkannter Text, nie ein Bild, und kein Anbieter aus den USA liegt im Datenpfad. Gesundheits- und Kinderdaten bleiben auf dem Gerät. Die vollständigen Regeln stehen in docs/34-ki-und-daten.md.
In der Gestaltung zeigt sich das so: Jeder Vorschlag von Albert hat einen gestrichelten grauen Rand. Ein Mensch sieht damit ohne Nachdenken, dass der Vorschlag nicht von einem Menschen kam.
