Was macht Agency of One?
Warum es das gibt
Wenn man nach einer Website fragt, produziert ein Modell die wahrscheinlichste Website. Diesen Look zu verbannen, verschiebt ihn nur zum nächstwahrscheinlichen (Creme + Serife + Clay, Schwarz + Acid Green, AUGENBRAUEN IN VERSALIEN, → auf Links: die zweite Welle von Telltale-Zeichen). Und „kreativ“ ist auch nicht die Lösung: Eine Geschäftsseite muss so aussehen, als hätte eine außergewöhnliche Agentur sie gemacht – glaubwürdig und poliert, wo alles zusammenpasst.
Prioritätsreihenfolge: 1) schön und richtig für den Kunden, 2) klar und glaubwürdig, 3) unverwechselbar (nicht KI-aussehend). KI-Telltale zu vermeiden ist notwendig, aber nicht ausreichend: Eine Seite, die unverwechselbar, aber schlicht oder nicht markenkonform ist, hat versagt.
Diese Fähigkeit beginnt daher mit der Marke, die der Kunde bereits hat, nimmt dem Ersteller die riskantesten Entscheidungen ab und hält das Ergebnis an einen weltklasse Finish- und Schönheitsstandard:
- Die Marke und die Assets des Kunden zuerst, dann die Strategie: Logofarben, echte Fotos, Referenzen, Positionierung, Belege, Markenidee.
- Echter Zufall, markengebundene Farbe: Ein Skript zieht die Hebel (Komposition, Markenbaustein, Palettenstrategie, Typografiestrategie). Die Farbe stammt aus dem Kundenlogo, wenn eines vorhanden ist, ansonsten aus einer kuratierten, kontrastgeprüften Palettenbibliothek – niemals aus dem Geschmack des Modells.
- Ein unabhängiger Kritiker bewertet fünf Richtungen hinsichtlich Typikalität und Stärke; ein Skript wählt aus den atypischen und starken aus.
- Ein Handwerksstandard (
craft.md) und ein Hero-Schlüsselelement (Set Piece), das zuerst isoliert gebaut wird. - Checks, mit denen man nicht argumentieren kann: Lint bei jeder Bearbeitung, gerenderte Messung, Soll-Ist-Vergleich (plan-diff), projektübergreifender Speicher, gerenderte Beauty-Checks und ein blinder Prüfer, der zuerst Attraktivität und Markenpassung bewertet, dann Handwerk und Unverwechselbarkeit.
Bei Regelkonflikten gilt diese Reihenfolge: Das Briefing und die Marken-Assets des Kunden > Schönheit (craft.md Priorität, §2b) > die gezogene Palette und Karten > die Liste der Telltale. Eine Karte oder eine Regel zur Telltale-Vermeidung rechtfertigt niemals etwas Hässlicheres oder Markenfremdes.
$S = Ordner dieser Fähigkeit: das Basisverzeichnis, das Claude Code anzeigt, wenn die Fähigkeit geladen wird (${CLAUDE_PLUGIN_ROOT}/skills/agency-of-one als Plugin; .claude/skills/agency-of-one oder ~/.claude/skills/agency-of-one als Drop-In). Führe Skripte vom Repository-Root aus: node $S/scripts/<name>.mjs. Der Session-Hook gibt den absoluten Skript-Pfad aus; übergib diesen absoluten Pfad an jeden Subagenten (sie können $S nicht selbst auflösen). Öffne niemals references/decks.json. Karten kommen nur vom Skript.
Modus
- Agency (Standard): Geschäftsorientiert, professionell, poliert. Lies
references/agency.md. - Expressive (
--mode expressive): Nur wenn das Briefing etwas Experimentelles, Künstlerisches, Redaktionelles, Kampagnen- oder Veranstaltungsähnliches verlangt. Es verwendet nicht-web-bezogene Referenzmedien und -beschränkungen; liesreferences/process-notes.md.
Tor (Gate)
DESIGN.mdexistiert → befolge es genau; gehe zu Phase 3. Schlage Änderungen vor; weiche niemals stillschweigend ab. Wenn es keinen<!-- agency-of-one design v1.1 -->Marker hat, stammt es aus der Zeit vor der markenorientierten Farbe: führebrand-extract.mjsaus; wenn die Palette mit den Marken-Assets kollidiert (plan-diff meldet die Kollision), schlage dem Benutzer eine §4-Farbänderung vor, bevor du darauf aufbaust.- Das Briefing gibt eine Richtung oder einen Markenleitfaden vor → das Briefing hat Vorrang, auch wenn es ein bekanntes Telltale benennt. Zeichne es auf (und seine Ausnahmen in §9); gehe zu Phase 3.
- Ansonsten → Phasen 1–2, auch für „kleine“ Seiten.
Einrichtung einmal pro Repository: npm i -D playwright && npx playwright install chromium (als devDependency, damit späteres npm i es nicht entfernt).
Phase 1: Assets, Marke, Strategie (DESIGN.md §1)
- Echte Assets: zuerst fragen (agency.md Schritt 0). Logo, Fotos der Personen, Bio-Fakten, Kundennamen oder eine Fallstudie, Kontakt- und Rechtsdaten, echte Zahlen, Produktscreenshots. Bei blinden Überprüfungen stagnieren Glaubwürdigkeit und Bildmaterial ohne diese bei etwa 6/10, egal wie gut das Design ist. Fehlende werden zu professionellen Platzhaltern (agency.md Schritt 5), und dein Bericht beginnt mit dem, was bereitgestellt werden muss.
- Die Marke, die du bereits hast (agency.md Schritt 0a). Wenn es ein Logo, Wappen, eine bestehende Website oder Personenphotos gibt, führe
node $S/scripts/brand-extract.mjsaus (automatische Erkennung oder Pfade übergeben). Es schreibt.design-review/brand.json; von da an istdraw.mjsautomatisch markengebunden und plan-diff lehnt jede Palette ab, die die Logofarbe verliert. Mit Benutzerbeteiligung: Bestätige die extrahierte Markenfarbe mit dem Benutzer in einer Zeile. Bekämpfe niemals die eigenen Farben der Marke. - Referenzen (mit Benutzerbeteiligung): Frage nach 2–3 Websites, die der Kunde schön findet (beliebige Branche). Speichere Screenshots in
design-references/. Der Prüfer vergleicht damit. Sie setzen die Qualitätslatte, nicht das Aussehen. - Menschlicher Geschmack (nur mit Benutzerbeteiligung): Frage einmal: „2–3 Marken oder Objekte, die du bewunderst, und eine Konkurrenzseite, der du nicht ähneln möchtest.“
- Strategie (Agency-Modus, agency.md Schritt 1): Positionierungssatz, die eine Überzeugung, 5 Kategoriecodes mit Vermerk keep/break (break ≥ 2), Markenidee, Persönlichkeit mit „aber nicht“, Beleginventar (niemals Belege erfinden).
- Themeninventar: 8+ reale Artefakte, Orte, Materialien und Umgangssprachliches aus der Welt des Kunden (12+ im expressiven Modus). Im Agency-Modus dienen diese der Bildrichtung, dem Markenbaustein und dem Text, nicht der Verkleidung.
- Entwurf des Hero-Satzes und des primären Aktionslabels in der Stimme der Marke. Du kannst sie nach dem Ziehen verfeinern.
Phase 2: Ziehen → Baseline → Abweichen → Kritiker → Auswählen → Festschreiben
2a. Ziehen. node $S/scripts/draw.mjs --project "<name>" (Standardmäßig Agency-Modus) teilt eine Qualitätsreferenz, ein Kompositionssystem, einen Markenbaustein, eine Palettenstrategie und eine Typografiestrategie zu. Die Farbe ist automatisch markengebunden, wenn .design-review/brand.json existiert (Überschreibung nur mit --no-brand "<Grund>", z. B. ein vom Kunden gewünschtes Rebranding); ansonsten stammt sie aus einer kuratierten, kontrastgeprüften Palettenbibliothek: schöne Startpunkte, niemals rohe, zufällige Farbtöne. Füge sie in DESIGN.md §2 ein. Ein Vetorecht mit schriftlichem Grund: --redraw <Slot>. Wenn eine Karte etwas von der Telltale-Liste vorschreibt (z. B. ein sichtbares Grid), ist dies als kartenbedingte Ausnahme erlaubt: Protokolliere es in §9 als card: <Grund> und führe es als Struktur aus, nicht als Dekoration.
2b. Baselines. Schreibe zwei Zwillinge: den KI-Zwilling (was ein Modell für dieses Briefing machen würde: Schriftarten, Hexes, Hero, Abschnitte) und, im Agency-Modus, den Agentur-Klischee-Zwilling (die Award-Köder-Version). Überprüfe beide gegen references/tells.md.
2c. Abweichen. Schreibe 5 Richtungen (A–E) in .design-review/directions.md, zusammen mit einer kurzen Zusammenfassung und dem §1-Inventar. Jede Richtung erhält einen Ausdruck der Markenidee, wie jeder gezogene Hebel angewendet wird, die Hero-Komposition (ein kleines ASCII-Wireframe), Gesichtsklassen (noch keine spezifischen Gesichter), einen Palettenentwurf und den Markenbaustein. Bewerte sie nicht selbst. Mindestens 3 müssen sich in der Seitenarchitektur unterscheiden, nicht nur in der Haut.
2d. Unabhängiger Kritiker. Führe den Subagenten direction-critic aus (agency-of-one:direction-critic als Plugin) und gib ihm nur den Pfad. Er gibt Typikalität t und Stärke s für jede Richtung zurück, plus ein PICK_ARG.
2e. Auswählen. node $S/scripts/draw.mjs --pick "<PICK_ARG>". Im Agency-Modus nimmt es die stärksten Richtungen (s ≥ 8, innerhalb von 0,5 der besten), ausschließlich der eindeutig generischen (t ≥ 0,7). Im expressiven Modus bevorzugt es die atypischen. Exit-Code 3 bedeutet, dass keine qualifiziert: Schreibe 3 neue Richtungen (füge die STRONGEST_IDEA_TO_STEAL des Kritikers ein) und führe den Kritiker erneut aus. Baue das, was das Skript auswählt. Mit Benutzerbeteiligung: Zeige die Auswahl und den Zweitplatzierten in je einer Zeile und lass den Benutzer diese überschreiben.
2e′. Hero-Kompositionen (das Schönheitstor). Baue vor dem Festschreiben den Hero (Fold + erster Scroll, Desktop und Mobile) für die Auswahl und den Zweitplatzierten als zwei schnelle statische Kompositionen mit echten Assets. Mache Screenshots von beiden (screenshot.mjs --file comp-a.html comp-b.html), gib dann einem frischen design-reviewer nur die beiden Fold- und Mobile-Fold-Bilder, unbeschriftet, und bitte um eine erzwungene Wahl: Welche wäre der Kunde stolzer zu versenden, und warum? Baue den Gewinner. Wenn der Prüfer beide als schlicht oder markenfremd bezeichnet, zeichne neu, anstatt zu polieren.
2f. Diff. Fülle die Tabelle in DESIGN.md §3 gegen beide Zwillinge aus. Jede übereinstimmende Achse muss sich ändern, es sei denn, das Briefing erfordert sie. Austauschtest: Würde der Name eines Mitbewerbers passen? Wenn ja, ziehe mehr aus §1.
2g. Festschreiben von Tokens. Vervollständige templates/DESIGN.md → DESIGN.md, einschließlich des maschinenlesbaren tokens-Blocks, den plan-diff liest.
- Typografie:
references/typography.md. Rendere deine Shortlist mitnode $S/scripts/type-specimen.mjsund wähle durch Hinsehen aus. Verwende eine Verhältnisskala; markiere flüssige Display-Größen alsfluid. - Farbe: Beginne mit dem Vorschlag von brand.json (oder der kuratierten Palette): Marke wörtlich, brandForText für Text auf hellem Grund, tiefe / helle Tönungen, getönte Neutrale und Tinte (craft.md §4). Teste AA. Halte die Logofarbe erkennbar.
- Wiederholungsprüfung:
node $S/scripts/designlog.mjs check --project "<name>" [--brand-locked] --display … --body … --ground … --accent … --layout … --medium "<composition or primary medium>". Wenn es REPEAT meldet, ändere die wiederholten Achsen.
Phase 3: Bauen nach dem Handwerksstandard
3a. Hero-Schlüsselelement zuerst, isoliert. Baue nur den Hero (Agency-Modus: die gezogene Komposition einwandfrei ausgeführt; expressiver Modus: der charakteristische Mechanismus). Mache einen Screenshot davon (screenshot.mjs, mit --state für interaktive Zustände) und iteriere, bis er mindestens 8 auf jeder relevanten Handwerksachse in references/craft.md erreicht. Baue erst dann den Rest.
3b. Baue die Seite nur aus Tokens (CSS-Variablen / Tailwind v4 @theme), nach der Architektur von agency.md Schritt 3 oder dem expressiven Skelett. shadcn/Radix liefern nur das Verhalten; gestalte jedes Primitive neu. Der Text ist spezifisch, in Satzform und in der Markenstimme; Belege sind echt oder als Platzhalter. Der Lint-Hook markiert Telltale bei jeder Bearbeitung, also behebe sie, sobald sie auftauchen.
3c. Finish-Durchgang. Gehe references/craft.md §1–10 Zeile für Zeile durch: Typografische Details, Grid-Überprüfung, Rhythmus, Farbe und Kontrast, Bildmaterial und Platzhalter, Bewegung und Zustände, responsive Komposition bei 1440/1024/768/390, Textredaktion (−30%), technische Ausführung. Dieser Durchgang ist es, wo der „Agentur-Look“ herkommt. Überspringe ihn nicht.
Phase 4: Überprüfen (maximal 3 Runden, die beste behalten)
- Zuerst einen Schnappschuss erstellen: Committe (oder kopiere) den aktuellen Stand vor jeder Runde, damit eine schlechtere Überarbeitung rückgängig gemacht werden kann.
node $S/scripts/slop-lint.mjs: Null Fehler; jede Warnung behoben oder in §9 +slop-lint.config.jsonbegründet.node $S/scripts/screenshot.mjs --url <dev url> --routes / /about …(oder--file index.html about.html …für statische Seiten; jede Seite, nicht nur die Startseite)--state <name>=click:<sel>|hash:<#id>|scroll:<sel>|hover:<sel>für jeden signifikanten Zustand. Sieh dir den Fold, Mobile Fold, scroll50 und die Zustandsaufnahmen an.node $S/scripts/plan-diff.mjs: Die Logofarbe ist in der Palette, die geplanten Schriftarten geladen, die Palette gerendert, die Skala angewendet, keine ungeplanten Hintergründe, und die Beauty-Checks bei Desktop und 390px: keine durch Animationen unsichtbaren oder ohne JS versteckten Inhalte, keine Initialen-Avatare, konsistente Fotogruppen (Zuschnitt, Größe, Hintergrund), kein zentrierter mehrzeiliger Text, keine Label in Großbuchstaben, keine Trennlinien, ein gestalteter Seitenkopf auf jeder Seite.- Blinde Überprüfung: Der Subagent
design-reviewer(agency-of-one:design-reviewer) erhält nur die URL oder Datei, die Routen und.design-review/. Er bewertet zuerst Attraktivität und Markenpassung, dann Handwerk und Unverwechselbarkeit, verglichen mitdesign-references/, falls vorhanden. SHIP erfordert Attraktivität, Markenpassung und jede Handwerksachse ≥ 8. Das Urteil einer mehrseitigen Site ist die schwächste Seite. - Beheben und neu rendern. Behalte eine Überarbeitung nur, wenn der Prüfer sie höher bewertet als die vorherige Beste. Stoppe nach 3 Runden und berichte, was noch offen ist.
- Spiegelung: Entferne eine Dekoration, die nicht der Markenidee dient; notiere es in DESIGN.md §11.
- Protokollieren:
node $S/scripts/designlog.mjs add --project "…" …gleiche Flags wie check… --media "<Zusammenfassung des Zuges>" --signature "<Baustein / Schlüsselelement>"(--log <Pfad>, um das Protokoll im Repository zu behalten). - Bericht: Richtung (eine Zeile), Markenidee, Schlüsselelement, Lint/plan-diff/Überprüfungsergebnisse mit Handwerksbewertungen, offene Ausnahmen, alle Platzhalter und Annahmen, die der Kunde ausfüllen oder bestätigen muss.
Referenzdateien
| Datei | Wann |
|---|---|
references/agency.md | Agency-Modus: Strategie, Identitätssystem, Geschäftsarchitektur, Platzhalter, Glaubwürdigkeit |
references/craft.md | 3a, 3c, Phase 4: Der Ausführungsstandard, Ausrichtung, Fotosystem, Seitenköpfe, Bewertung |
references/patterns.md | 3b: Bewährte Rezepte für Personen-Grids, Seitenköpfe, Belegbänder, Events, Spenden, Formulare |
references/palettes.json | Kuratierte Palettenbibliothek (von draw.mjs gelesen; du kannst sie durchsuchen) |
references/tells.md | 2b, 2f, Phase 4: KI-Telltale (Gen 1–3) mit Signaturen und Quellen |
references/typography.md | 2g: Schriftarten-Verfahren, Quellen, Lizenzen, Skalierung |
references/process-notes.md | Expressiver Modus: Karteninterpretation; ausgearbeitete Beispiele |
templates/DESIGN.md | 2g |