Glyphe verbessern
Eine bestehende Piktogramm-Glyphe in der viz/-Visualisierungsschicht verbessern — das aktuelle Rendering ueberpruefen, visuelle Probleme diagnostizieren, gezielte Modifikationen anwenden, neu rendern und Vorher/Nachher vergleichen. Funktioniert fuer Skill-, Agent- und Team-Glyphen.
Wann verwenden
- Eine Glyphe rendert bei kleinen Groessen schlecht (Details gehen verloren, Formen verschmelzen)
- Die visuelle Metapher einer Glyphe ist unklar oder passt nicht zur dargestellten Entitaet
- Eine Glyphe hat Proportionsprobleme (zu gross, zu klein, dezentriert)
- Der Neon-Glow-Effekt uebertrifft oder unterdrueckt die Glyphe
- Eine Glyphe sieht in einer Palette gut aus, aber in anderen schlecht
- Batch-Verbesserung nach dem Hinzufuegen neuer Paletten oder Aenderungen an der Rendering-Pipeline
Eingaben
- Erforderlich: Entitaetstyp —
skill, agent oder team
- Erforderlich: Entitaets-ID der zu verbessernden Glyphe (z.B.
commit-changes, mystic, tending)
- Erforderlich: Spezifisches Problem (Lesbarkeit, Proportionen, Glow, Paletten-Kompatibilitaet)
- Optional: Referenz-Glyphe, die das gewuenschte Qualitaetsniveau demonstriert
- Optional: Zielpalette(n) zur Optimierung (Standard: alle Paletten)
Verfahren
Schritt 1: Pruefung — Aktuellen Zustand bewerten
Die aktuelle Glyphe untersuchen und spezifische Probleme identifizieren.
- Die Glyphen-Funktion basierend auf dem Entitaetstyp lokalisieren:
- Skills:
viz/R/primitives*.R (19 domaenengruppierte Dateien), zugeordnet in viz/R/glyphs.R
- Agents:
viz/R/agent_primitives.R, zugeordnet in viz/R/agent_glyphs.R
- Teams:
viz/R/team_primitives.R, zugeordnet in viz/R/team_glyphs.R
- Die Glyphen-Funktion lesen, um ihre Struktur zu verstehen:
- Wie viele Ebenen verwendet sie?
- Welche Primitives ruft sie auf?
- Welche Skalierungsfaktoren und Positionierung sind gesetzt?
- Die gerenderte Ausgabe ansehen:
- Skills:
viz/public/icons/cyberpunk/<domain>/<skillId>.webp
- Agents:
viz/public/icons/cyberpunk/agents/<agentId>.webp
- Teams:
viz/public/icons/cyberpunk/teams/<teamId>.webp
- Falls verfuegbar, 2-3 weitere Paletten fuer palettenuebergreifendes Rendering pruefen
- Bei Icon-Groesse (
48px im Graph) und Panel-Groesse (160px im Detail-Panel) betrachten
- Die Glyphe auf den Qualitaetsdimensionen bewerten:
Glyph Quality Dimensions:
+----------------+------+-----------------------------------------------+
| Dimension | 1-5 | Assessment Criteria |
+----------------+------+-----------------------------------------------+
| Readability | | Recognizable at 48px? Clear at 160px? |
| Proportions | | Well-centered? Good use of the 100x100 canvas?|
| Metaphor | | Does the shape clearly represent the entity? |
| Glow balance | | Glow enhances without overwhelming? |
| Palette compat | | Looks good across cyberpunk + viridis palettes?|
| Complexity | | Appropriate layer count (not too busy/sparse)? |
+----------------+------+-----------------------------------------------+
- Die 1-2 Dimensionen mit den niedrigsten Bewertungen identifizieren — das sind die Verbesserungsziele
Erwartet: Eine klare Diagnose, was mit der Glyphe nicht stimmt und welche Dimensionen verbessert werden sollen. Die Pruefung sollte spezifisch sein: "Proportionen: Glyphe nutzt nur 40% der Leinwand", nicht "sieht schlecht aus".
Bei Fehler: Falls die Glyphen-Funktion fehlt oder die Entitaet nicht in ihrer *_glyphs.R-Zuordnung ist, wurde die Glyphe moeglicherweise noch nicht erstellt — stattdessen create-glyph verwenden.
Schritt 2: Diagnostizieren — Ursachenanalyse
Bestimmen, warum die identifizierten Probleme bestehen.
- Bei Lesbarkeits-Problemen:
- Zu viele feine Details, die bei kleinen Groessen verschmelzen?
- Unzureichender Kontrast zwischen Glyphen-Elementen?
- Linien zu duenn (< 1.5
size bei s=1.0)?
- Elemente zu nah beieinander?
- Bei Proportions-Problemen:
- Skalierungsfaktor
s zu klein oder zu gross?
- Zentrum von (50, 50) verschoben?
- Elemente dehnen sich ueber den sicheren Bereich (10-90) hinaus aus?
- Bei Glow-Problemen:
- Glyphen-Strichbreite interagiert mit
ggfx::with_outer_glow():
- Duenne Linien: Glow macht sie unscharf
- Dicke Fuellungen: Glow erzeugt uebertriebenes Leuchten
- Mehrere ueberlappende Elemente: zusammengesetzter Glow erzeugt Hotspots
- Bei Palettenkompatibilitaets-Problemen:
- Glyphe verwendet hartcodierte Farben statt
col/bright-Parameter?
- Kontrastarme Paletten (cividis, mako) machen die Glyphe unsichtbar?
- Die Glyphe haengt von Farbvariation ab, die manche Paletten nicht bieten?
- Die spezifische Ursache fuer jedes Problem dokumentieren
Erwartet: Ursachen, die direkt auf Code-Aenderungen hinweisen. "Die Glyphe ist zu klein" -> "Skalierungsfaktor ist 0.6, sollte aber 0.8 sein." "Glow uebertrifft" -> "Drei ueberlappende gefuellte Polygone erzeugen jeweils Glow."
Bei Fehler: Falls die Ursache nicht offensichtlich aus der Code-Inspektion ist, die Glyphe isoliert mit verschiedenen Parametern rendern, um das Problem einzugrenzen. render_glyph() mit einer einzelnen Glyphe zum Testen verwenden.
Schritt 3: Modifizieren — Gezielte Korrekturen anwenden
Die Glyphen-Funktion bearbeiten, um die diagnostizierten Probleme zu beheben.
- Die Datei oeffnen, die die Glyphen-Funktion enthaelt
- Modifikationen entsprechend der Diagnose anwenden:
- Skalierung/Proportionen:
s-Multiplikator oder Element-Offsets anpassen
- Lesbarkeit: Komplexe Elemente vereinfachen, Strichbreite erhoehen, Abstaende vergroessern
- Glow-Balance: Ueberlappende gefuellte Bereiche reduzieren, Umrisse statt Fuellungen verwenden, wo Fuellungen Leuchten erzeugen
- Palettenkompatibilitaet: Sicherstellen, dass alle Farben von
col/bright-Parametern abgeleitet werden, Alpha fuer Tiefe hinzufuegen
- Dem Glyphen-Funktionsvertrag folgen:
glyph_name <- function(cx, cy, s, col, bright) {
# cx, cy = center (50, 50)
# s = scale (1.0 = ~70% of canvas)
# col = domain color, bright = brightened variant
# Returns: list() of ggplot2 layers
}
- Die Funktionssignatur beibehalten — Parameter nicht aendern
- Modifikationen minimal halten: die diagnostizierten Probleme beheben, nicht die gesamte Glyphe neu gestalten
Erwartet: Eine modifizierte Glyphen-Funktion, die die in Schritten 1-2 identifizierten spezifischen Probleme behebt. Aenderungen sind gezielt und minimal — verbessern, nicht neu gestalten.
Bei Fehler: Falls die Modifikationen andere Dimensionen verschlechtern (z.B. Proportionsfix bricht Lesbarkeit), Aenderungen rueckgaengig machen und einen anderen Ansatz versuchen. Falls die Glyphe eine vollstaendige Neugestaltung benoetigt, stattdessen create-glyph verwenden.
Schritt 4: Neu rendern — Aktualisierte Icons generieren
Die modifizierte Glyphe rendern und die Korrektur verifizieren.
Basierend auf dem Entitaetstyp neu rendern:
# From project root — use --no-cache to force re-render of modified glyph
bash viz/build.sh --only <domain> --no-cache # skills
bash viz/build.sh --type agent --only <id> --no-cache # agents
bash viz/build.sh --type team --only <id> --no-cache # teams
Ausgabedateien am erwarteten Pfad fuer jede Palette pruefen
Dateigroessen pruefen — Icons sollten 2-15 KB (WebP) sein:
- Unter 2 KB: Glyphe ist moeglicherweise zu einfach oder Rendering ist fehlgeschlagen
- Ueber 15 KB: Glyphe ist moeglicherweise zu komplex (zu viele Ebenen)
Erwartet: Frische Icon-Dateien fuer alle Paletten generiert. Dateigroessen im erwarteten Bereich.
Bei Fehler: Falls das Build-Skript Fehler ausgibt, die R-Konsolenausgabe auf den spezifischen Fehler pruefen. Haeufige Ursachen: fehlende schliessende Klammer in der Glyphen-Funktion, Referenzierung undefinierter Primitives oder Rueckgabe eines Nicht-Listen-Objekts. Falls das Rendering erfolgreich ist, aber die Ausgabe leer, koennten die Glyphen-Ebenen ausserhalb der Leinwandgrenzen liegen.
Schritt 5: Vergleichen — Vorher/Nachher-Verifikation
Ueberpruefen, ob die Verbesserung die Zieldimensionen verbessert hat.
- Alte und neue Renderings vergleichen:
- Die Cyberpunk-Palettenversion bei Icon- (48px) und Panel-Groesse (160px) betrachten
- Mindestens 2 weitere Paletten pruefen (eine helle wie Turbo, eine dunkle wie Mako)
- Die Qualitaetsdimensionen aus Schritt 1 erneut bewerten:
- Zieldimensionen sollten sich um mindestens 1 Punkt verbessern
- Nicht-Zieldimensionen sollten sich nicht verschlechtern
- Falls die Glyphe im Force-Graph verwendet wird, dort testen:
- HTTP-Server starten:
python3 -m http.server 8080 von viz/ aus
- Den Graph laden und den Entitaetsknoten finden
- Verifizieren, dass das Icon bei Standard-Zoom und beim Hineinzoomen korrekt rendert
- Die vorgenommenen Aenderungen und die erzielte Verbesserung dokumentieren
Erwartet: Messbare Verbesserung auf den Zieldimensionen ohne Verschlechterung bei anderen. Die Glyphe sieht bei beiden Groessen und ueber Paletten hinweg besser aus.
Bei Fehler: Falls die Verbesserung marginal ist oder eine Verschlechterung auftritt, die Aenderungen rueckgaengig machen und die Diagnose ueberdenken. Manchmal sind die Einschraenkungen der urspruenglichen Glyphe dem Konzept inhaerent, nicht der Implementierung — in diesem Fall muss moeglicherweise die Metapher selbst geaendert werden (Eskalation zu create-glyph).
Validierungscheckliste
Haeufige Fehler
- Ueberverbesserung: Ein Problem beheben und dann alles andere auch noch anpassen. Bei den diagnostizierten Problemen bleiben
- Vertragsbruch: Die Funktionssignatur aendern bricht die Rendering-Pipeline. Der 5-Parameter-Vertrag ist unveraenderlich
- Palettenspezifische Optimierung: Die Glyphe perfekt fuer Cyberpunk machen, aber schlecht fuer Viridis. Immer 3+ Paletten pruefen
- Kleingeroessen-Rendering ignorieren: Ein schoenes 160px-Icon, das bei 48px zum Klecks wird, ist eine gescheiterte Verbesserung
- Vergessen neu zu rendern: Die Funktion bearbeiten ohne den Build-Befehl auszufuehren bedeutet, dass die Aenderungen nicht sichtbar sind
- Falscher Build-Befehl: Skills verwenden
build-icons.R, Agents verwenden build-agent-icons.R, Teams verwenden build-team-icons.R
Verwandte Skills
- create-glyph — Eine neue Glyphe von Grund auf erstellen (verwenden, wenn Verbesserung nicht ausreicht)
- audit-icon-pipeline — Erkennen, welche Glyphen in der Pipeline verbessert werden muessen
- render-icon-pipeline — Die vollstaendige Rendering-Pipeline nach Verbesserungen ausfuehren
- ornament-style-mono — Visuelle Gestaltungsprinzipien, die auf Glyphen-Komposition anwendbar sind
- chrysopoeia — Wertextraktionsmethodik parallel zur Glyphen-Optimierung (Gold verstaerken, Schlacke entfernen)
1---2name: enhance-glyph-113locale: de4source_locale: en5source_commit: 33b561c96fence_basis_commit: 33b561c97translator: claude8translation_date: "2026-03-18"9description: >10 Eine bestehende R-basierte Piktogramm-Glyphe fuer die Visualisierungsschicht11 verbessern. Umfasst visuelle Ueberpruefung der aktuellen Glyphe, Diagnose12 spezifischer Probleme (Proportionen, Lesbarkeit, Glow-Balance), gezielte13 Modifikationen an der Glyphen-Funktion, erneutes Rendering und Vorher/Nachher-14 Vergleich. Funktioniert fuer Skill-, Agent- und Team-Glyphen. Verwenden, wenn15 eine Glyphe bei kleinen Groessen schlecht rendert, ihre visuelle Metapher unklar16 ist, Proportionsprobleme hat, der Neon-Glow-Effekt unausgewogen ist, oder nach17 dem Hinzufuegen neuer Paletten oder Aenderungen an der Rendering-Pipeline.18license: MIT19allowed-tools: Read Write Edit Bash Grep Glob20metadata:21 source: https://skillmd.com/skills/pjt222/enhance-glyph-1122 author: Philipp Thoss23 version: "2.0"24 domain: design25 complexity: intermediate26 language: R27 tags: design, glyph, enhancement, icon, ggplot2, visualization, refinement28---2930# Glyphe verbessern3132Eine bestehende Piktogramm-Glyphe in der `viz/`-Visualisierungsschicht verbessern — das aktuelle Rendering ueberpruefen, visuelle Probleme diagnostizieren, gezielte Modifikationen anwenden, neu rendern und Vorher/Nachher vergleichen. Funktioniert fuer Skill-, Agent- und Team-Glyphen.3334## Wann verwenden3536- Eine Glyphe rendert bei kleinen Groessen schlecht (Details gehen verloren, Formen verschmelzen)37- Die visuelle Metapher einer Glyphe ist unklar oder passt nicht zur dargestellten Entitaet38- Eine Glyphe hat Proportionsprobleme (zu gross, zu klein, dezentriert)39- Der Neon-Glow-Effekt uebertrifft oder unterdrueckt die Glyphe40- Eine Glyphe sieht in einer Palette gut aus, aber in anderen schlecht41- Batch-Verbesserung nach dem Hinzufuegen neuer Paletten oder Aenderungen an der Rendering-Pipeline4243## Eingaben4445- **Erforderlich**: Entitaetstyp — `skill`, `agent` oder `team`46- **Erforderlich**: Entitaets-ID der zu verbessernden Glyphe (z.B. `commit-changes`, `mystic`, `tending`)47- **Erforderlich**: Spezifisches Problem (Lesbarkeit, Proportionen, Glow, Paletten-Kompatibilitaet)48- **Optional**: Referenz-Glyphe, die das gewuenschte Qualitaetsniveau demonstriert49- **Optional**: Zielpalette(n) zur Optimierung (Standard: alle Paletten)5051## Verfahren5253### Schritt 1: Pruefung — Aktuellen Zustand bewerten5455Die aktuelle Glyphe untersuchen und spezifische Probleme identifizieren.56571. Die Glyphen-Funktion basierend auf dem Entitaetstyp lokalisieren:58 - **Skills**: `viz/R/primitives*.R` (19 domaenengruppierte Dateien), zugeordnet in `viz/R/glyphs.R`59 - **Agents**: `viz/R/agent_primitives.R`, zugeordnet in `viz/R/agent_glyphs.R`60 - **Teams**: `viz/R/team_primitives.R`, zugeordnet in `viz/R/team_glyphs.R`612. Die Glyphen-Funktion lesen, um ihre Struktur zu verstehen:62 - Wie viele Ebenen verwendet sie?63 - Welche Primitives ruft sie auf?64 - Welche Skalierungsfaktoren und Positionierung sind gesetzt?653. Die gerenderte Ausgabe ansehen:66 - Skills: `viz/public/icons/cyberpunk/<domain>/<skillId>.webp`67 - Agents: `viz/public/icons/cyberpunk/agents/<agentId>.webp`68 - Teams: `viz/public/icons/cyberpunk/teams/<teamId>.webp`69 - Falls verfuegbar, 2-3 weitere Paletten fuer palettenuebergreifendes Rendering pruefen70 - Bei Icon-Groesse (~48px im Graph) und Panel-Groesse (~160px im Detail-Panel) betrachten714. Die Glyphe auf den **Qualitaetsdimensionen** bewerten:7273```text74Glyph Quality Dimensions:75+----------------+------+-----------------------------------------------+76| Dimension | 1-5 | Assessment Criteria |77+----------------+------+-----------------------------------------------+78| Readability | | Recognizable at 48px? Clear at 160px? |79| Proportions | | Well-centered? Good use of the 100x100 canvas?|80| Metaphor | | Does the shape clearly represent the entity? |81| Glow balance | | Glow enhances without overwhelming? |82| Palette compat | | Looks good across cyberpunk + viridis palettes?|83| Complexity | | Appropriate layer count (not too busy/sparse)? |84+----------------+------+-----------------------------------------------+85```86875. Die 1-2 Dimensionen mit den niedrigsten Bewertungen identifizieren — das sind die Verbesserungsziele8889**Erwartet:** Eine klare Diagnose, was mit der Glyphe nicht stimmt und welche Dimensionen verbessert werden sollen. Die Pruefung sollte spezifisch sein: "Proportionen: Glyphe nutzt nur 40% der Leinwand", nicht "sieht schlecht aus".9091**Bei Fehler:** Falls die Glyphen-Funktion fehlt oder die Entitaet nicht in ihrer `*_glyphs.R`-Zuordnung ist, wurde die Glyphe moeglicherweise noch nicht erstellt — stattdessen `create-glyph` verwenden.9293### Schritt 2: Diagnostizieren — Ursachenanalyse9495Bestimmen, warum die identifizierten Probleme bestehen.96971. Bei **Lesbarkeits**-Problemen:98 - Zu viele feine Details, die bei kleinen Groessen verschmelzen?99 - Unzureichender Kontrast zwischen Glyphen-Elementen?100 - Linien zu duenn (< 1.5 `size` bei s=1.0)?101 - Elemente zu nah beieinander?1022. Bei **Proportions**-Problemen:103 - Skalierungsfaktor `s` zu klein oder zu gross?104 - Zentrum von (50, 50) verschoben?105 - Elemente dehnen sich ueber den sicheren Bereich (10-90) hinaus aus?1063. Bei **Glow**-Problemen:107 - Glyphen-Strichbreite interagiert mit `ggfx::with_outer_glow()`:108 - Duenne Linien: Glow macht sie unscharf109 - Dicke Fuellungen: Glow erzeugt uebertriebenes Leuchten110 - Mehrere ueberlappende Elemente: zusammengesetzter Glow erzeugt Hotspots1114. Bei **Palettenkompatibilitaets**-Problemen:112 - Glyphe verwendet hartcodierte Farben statt `col`/`bright`-Parameter?113 - Kontrastarme Paletten (cividis, mako) machen die Glyphe unsichtbar?114 - Die Glyphe haengt von Farbvariation ab, die manche Paletten nicht bieten?1155. Die spezifische Ursache fuer jedes Problem dokumentieren116117**Erwartet:** Ursachen, die direkt auf Code-Aenderungen hinweisen. "Die Glyphe ist zu klein" -> "Skalierungsfaktor ist 0.6, sollte aber 0.8 sein." "Glow uebertrifft" -> "Drei ueberlappende gefuellte Polygone erzeugen jeweils Glow."118119**Bei Fehler:** Falls die Ursache nicht offensichtlich aus der Code-Inspektion ist, die Glyphe isoliert mit verschiedenen Parametern rendern, um das Problem einzugrenzen. `render_glyph()` mit einer einzelnen Glyphe zum Testen verwenden.120121### Schritt 3: Modifizieren — Gezielte Korrekturen anwenden122123Die Glyphen-Funktion bearbeiten, um die diagnostizierten Probleme zu beheben.1241251. Die Datei oeffnen, die die Glyphen-Funktion enthaelt1262. Modifikationen entsprechend der Diagnose anwenden:127 - **Skalierung/Proportionen**: `s`-Multiplikator oder Element-Offsets anpassen128 - **Lesbarkeit**: Komplexe Elemente vereinfachen, Strichbreite erhoehen, Abstaende vergroessern129 - **Glow-Balance**: Ueberlappende gefuellte Bereiche reduzieren, Umrisse statt Fuellungen verwenden, wo Fuellungen Leuchten erzeugen130 - **Palettenkompatibilitaet**: Sicherstellen, dass alle Farben von `col`/`bright`-Parametern abgeleitet werden, Alpha fuer Tiefe hinzufuegen1313. Dem **Glyphen-Funktionsvertrag** folgen:132 ```r133 glyph_name <- function(cx, cy, s, col, bright) {134 # cx, cy = center (50, 50)135 # s = scale (1.0 = ~70% of canvas)136 # col = domain color, bright = brightened variant137 # Returns: list() of ggplot2 layers138 }139 ```1404. Die Funktionssignatur beibehalten — Parameter nicht aendern1415. Modifikationen minimal halten: die diagnostizierten Probleme beheben, nicht die gesamte Glyphe neu gestalten142143**Erwartet:** Eine modifizierte Glyphen-Funktion, die die in Schritten 1-2 identifizierten spezifischen Probleme behebt. Aenderungen sind gezielt und minimal — verbessern, nicht neu gestalten.144145**Bei Fehler:** Falls die Modifikationen andere Dimensionen verschlechtern (z.B. Proportionsfix bricht Lesbarkeit), Aenderungen rueckgaengig machen und einen anderen Ansatz versuchen. Falls die Glyphe eine vollstaendige Neugestaltung benoetigt, stattdessen `create-glyph` verwenden.146147### Schritt 4: Neu rendern — Aktualisierte Icons generieren148149Die modifizierte Glyphe rendern und die Korrektur verifizieren.1501511. Basierend auf dem Entitaetstyp neu rendern:152153 ```bash154 # From project root — use --no-cache to force re-render of modified glyph155 bash viz/build.sh --only <domain> --no-cache # skills156 bash viz/build.sh --type agent --only <id> --no-cache # agents157 bash viz/build.sh --type team --only <id> --no-cache # teams158 ```1591602. Ausgabedateien am erwarteten Pfad fuer jede Palette pruefen1613. Dateigroessen pruefen — Icons sollten 2-15 KB (WebP) sein:162 - Unter 2 KB: Glyphe ist moeglicherweise zu einfach oder Rendering ist fehlgeschlagen163 - Ueber 15 KB: Glyphe ist moeglicherweise zu komplex (zu viele Ebenen)164165**Erwartet:** Frische Icon-Dateien fuer alle Paletten generiert. Dateigroessen im erwarteten Bereich.166167**Bei Fehler:** Falls das Build-Skript Fehler ausgibt, die R-Konsolenausgabe auf den spezifischen Fehler pruefen. Haeufige Ursachen: fehlende schliessende Klammer in der Glyphen-Funktion, Referenzierung undefinierter Primitives oder Rueckgabe eines Nicht-Listen-Objekts. Falls das Rendering erfolgreich ist, aber die Ausgabe leer, koennten die Glyphen-Ebenen ausserhalb der Leinwandgrenzen liegen.168169### Schritt 5: Vergleichen — Vorher/Nachher-Verifikation170171Ueberpruefen, ob die Verbesserung die Zieldimensionen verbessert hat.1721731. Alte und neue Renderings vergleichen:174 - Die Cyberpunk-Palettenversion bei Icon- (48px) und Panel-Groesse (160px) betrachten175 - Mindestens 2 weitere Paletten pruefen (eine helle wie Turbo, eine dunkle wie Mako)1762. Die Qualitaetsdimensionen aus Schritt 1 erneut bewerten:177 - Zieldimensionen sollten sich um mindestens 1 Punkt verbessern178 - Nicht-Zieldimensionen sollten sich nicht verschlechtern1793. Falls die Glyphe im Force-Graph verwendet wird, dort testen:180 - HTTP-Server starten: `python3 -m http.server 8080` von `viz/` aus181 - Den Graph laden und den Entitaetsknoten finden182 - Verifizieren, dass das Icon bei Standard-Zoom und beim Hineinzoomen korrekt rendert1834. Die vorgenommenen Aenderungen und die erzielte Verbesserung dokumentieren184185**Erwartet:** Messbare Verbesserung auf den Zieldimensionen ohne Verschlechterung bei anderen. Die Glyphe sieht bei beiden Groessen und ueber Paletten hinweg besser aus.186187**Bei Fehler:** Falls die Verbesserung marginal ist oder eine Verschlechterung auftritt, die Aenderungen rueckgaengig machen und die Diagnose ueberdenken. Manchmal sind die Einschraenkungen der urspruenglichen Glyphe dem Konzept inhaerent, nicht der Implementierung — in diesem Fall muss moeglicherweise die Metapher selbst geaendert werden (Eskalation zu `create-glyph`).188189## Validierungscheckliste190191- [ ] Aktuelle Glyphe mit spezifischer Problemdiagnose geprueft192- [ ] Ursache fuer jedes Problem identifiziert193- [ ] Modifikationen auf diagnostizierte Probleme ausgerichtet (nicht ueberarbeitet)194- [ ] Glyphen-Funktionsvertrag beibehalten (Signatur unveraendert)195- [ ] Icons fuer alle Paletten neu gerendert196- [ ] Vorher/Nachher-Vergleich zeigt Verbesserung bei Zieldimensionen197- [ ] Keine Verschlechterung bei Nicht-Zieldimensionen198- [ ] Dateigroessen im erwarteten Bereich (2-15 KB WebP)199- [ ] Glyphe rendert korrekt im Force-Graph-Kontext (falls zutreffend)200201## Haeufige Fehler202203- **Ueberverbesserung**: Ein Problem beheben und dann alles andere auch noch anpassen. Bei den diagnostizierten Problemen bleiben204- **Vertragsbruch**: Die Funktionssignatur aendern bricht die Rendering-Pipeline. Der 5-Parameter-Vertrag ist unveraenderlich205- **Palettenspezifische Optimierung**: Die Glyphe perfekt fuer Cyberpunk machen, aber schlecht fuer Viridis. Immer 3+ Paletten pruefen206- **Kleingeroessen-Rendering ignorieren**: Ein schoenes 160px-Icon, das bei 48px zum Klecks wird, ist eine gescheiterte Verbesserung207- **Vergessen neu zu rendern**: Die Funktion bearbeiten ohne den Build-Befehl auszufuehren bedeutet, dass die Aenderungen nicht sichtbar sind208- **Falscher Build-Befehl**: Skills verwenden `build-icons.R`, Agents verwenden `build-agent-icons.R`, Teams verwenden `build-team-icons.R`209210## Verwandte Skills211212- [create-glyph](../create-glyph/SKILL.md) — Eine neue Glyphe von Grund auf erstellen (verwenden, wenn Verbesserung nicht ausreicht)213- [audit-icon-pipeline](../audit-icon-pipeline/SKILL.md) — Erkennen, welche Glyphen in der Pipeline verbessert werden muessen214- [render-icon-pipeline](../render-icon-pipeline/SKILL.md) — Die vollstaendige Rendering-Pipeline nach Verbesserungen ausfuehren215- [ornament-style-mono](../ornament-style-mono/SKILL.md) — Visuelle Gestaltungsprinzipien, die auf Glyphen-Komposition anwendbar sind216- [chrysopoeia](../chrysopoeia/SKILL.md) — Wertextraktionsmethodik parallel zur Glyphen-Optimierung (Gold verstaerken, Schlacke entfernen)