Glyphe erstellen
R-basierte Piktogramm-Glyphen fuer Skill-, Agent- oder Team-Icons in der viz/-Visualisierungsschicht erstellen. Jede Glyphe ist eine reine ggplot2-Funktion, die eine erkennbare Form auf einer 100x100-Leinwand zeichnet und mit einem Neon-Glow-Effekt als transparentes WebP gerendert wird.
Wann verwenden
- Ein neuer Skill, Agent oder Team wurde hinzugefuegt und benoetigt ein visuelles Icon
- Eine bestehende Glyphe soll ersetzt oder neu gestaltet werden
- Batch-Erstellung von Glyphen fuer eine neue Skill-Domaene
- Visuelle Metaphern fuer Entitaetskonzepte prototypisieren
Eingaben
- Erforderlich: Entitaetstyp —
skill, agent oder team
- Erforderlich: Entitaets-ID (z.B.
create-glyph, mystic, r-package-review) und Domaene (fuer Skills)
- Erforderlich: Visuelles Konzept — was die Glyphe darstellen soll
- Optional: Referenz-Glyphe zum Studium des Komplexitaetsniveaus
- Optional: Benutzerdefinierter
--glow-sigma-Wert (Standard: 4)
Verfahren
Schritt 1: Konzept — Visuelle Metapher entwerfen
Die zu ikonifizierende Entitaet identifizieren und eine visuelle Metapher waehlen.
- Die Quelldatei der Entitaet lesen, um das Kernkonzept zu verstehen:
- Skills:
skills/<id>/SKILL.md
- Agents:
agents/<id>.md
- Teams:
teams/<id>.md
- Einen Metaphertyp waehlen:
- Konkretes Objekt: ein Kolben fuer Experimente, ein Schild fuer Sicherheit
- Abstraktes Symbol: Pfeile fuer Zusammenfuehrung, Spiralen fuer Iteration
- Zusammengesetzt: 2-3 einfache Formen kombinieren (z.B. Dokument + Stift)
- Bestehende Glyphen als Komplexitaetsreferenz heranziehen:
Complexity Tiers:
+----------+--------+-------------------------------------------+
| Tier | Layers | Examples |
+----------+--------+-------------------------------------------+
| Simple | 2 | glyph_flame, glyph_heartbeat |
| Moderate | 3-5 | glyph_document, glyph_experiment_flask |
| Complex | 6+ | glyph_ship_wheel, glyph_bridge_cpp |
+----------+--------+-------------------------------------------+
- Einen Funktionsnamen festlegen:
glyph_<beschreibender_name> (snake_case, eindeutig)
Erwartet: Eine klare gedankliche Skizze der Form mit 2-6 geplanten Ebenen.
Bei Fehler: Falls das Konzept zu abstrakt ist, auf ein verwandtes konkretes Objekt zurueckgreifen. Bestehende Glyphen in derselben Domaene zur Inspiration durchsehen.
Schritt 2: Zusammensetzen — Glyphen-Funktion schreiben
Die R-Funktion schreiben, die ggplot2-Ebenen erzeugt.
Funktionssignatur (unveraenderlicher Vertrag):
glyph_<name> <- function(cx, cy, s, col, bright) {
# cx, cy = center coordinates (50, 50 on 100x100 canvas)
# s = scale factor (1.0 = fill ~70% of canvas)
# col = domain color hex (e.g., "#ff88dd" for design)
# bright = brightened variant of col (auto-computed by renderer)
# Returns: list() of ggplot2 layers
}
Skalierungsfaktor * s auf ALLE Dimensionen anwenden fuer konsistente Skalierung:
r <- 20 * s # radius
hw <- 15 * s # half-width
lw <- .lw(s) # line width (default base 2.5)
lw_thin <- .lw(s, 1.2) # thinner line width
Geometrie mit verfuegbaren Primitives erstellen:
| Geometrie |
Verwendung |
ggplot2::geom_polygon(data, .aes(x, y), ...) |
Gefuellte Formen |
ggplot2::geom_path(data, .aes(x, y), ...) |
Offene Linien/Kurven |
ggplot2::geom_segment(data, .aes(x, xend, y, yend), ...) |
Liniensegmente, Pfeile |
ggplot2::geom_rect(data, .aes(xmin, xmax, ymin, ymax), ...) |
Rechtecke |
ggforce::geom_circle(data, .aes(x0, y0, r), ...) |
Kreise |
Die Farbstrategie anwenden:
Alpha Guide:
+----------------------+------------+--------------------------+
| Purpose | Alpha | Example |
+----------------------+------------+--------------------------+
| Large fill (body) | 0.08-0.15 | hex_with_alpha(col, 0.1) |
| Medium fill (accent) | 0.15-0.25 | hex_with_alpha(col, 0.2) |
| Small fill (detail) | 0.25-0.35 | hex_with_alpha(bright, 0.3) |
| Outline stroke | 1.0 | color = bright |
| Secondary stroke | 1.0 | color = col |
| No fill | --- | fill = NA |
+----------------------+------------+--------------------------+
Eine flache list() von Ebenen zurueckgeben (der Renderer iteriert und umgibt jede mit Glow)
Die Funktion in der passenden Primitives-Datei basierend auf dem Entitaetstyp platzieren:
- Skills: Domaenengruppiert ueber 19 Primitives-Dateien:
primitives.R — bushcraft, compliance, containerization, data-serialization, defensive
primitives_2.R — devops, general, git, mcp-integration
primitives_3.R — mlops, observability, PM, r-packages, reporting, review, web-dev, esoteric, design
- Weitere
primitives_4.R bis primitives_19.R fuer neuere Domaenen
- Agents:
viz/R/agent_primitives.R
- Teams:
viz/R/team_primitives.R
Erwartet: Eine funktionierende R-Funktion, die eine Liste von 2-6 ggplot2-Ebenen zurueckgibt.
Bei Fehler: Falls ggforce::geom_circle Fehler verursacht, sicherstellen, dass ggforce installiert ist. Falls Koordinaten nicht stimmen, bedenken, dass die Leinwand 100x100 mit (0,0) unten links ist. Die Funktion interaktiv testen:
source("viz/R/utils.R"); source("viz/R/primitives.R") # etc.
layers <- glyph_<name>(50, 50, 1.0, "#ff88dd", "#ffa8f0")
p <- ggplot2::ggplot() + ggplot2::coord_fixed(xlim=c(0,100), ylim=c(0,100)) +
ggplot2::theme_void()
for (l in layers) p <- p + l
print(p)
Schritt 3: Registrieren — Entitaet der Glyphe zuordnen
Die Entitaet-zu-Glyphe-Zuordnung in der passenden Glyph-Zuordnungsdatei hinzufuegen.
Fuer Skills:
viz/R/glyphs.R oeffnen
- Den Kommentarbereich fuer die Zieldomaene finden (z.B.
# -- design (3))
- Den Eintrag in alphabetischer Reihenfolge innerhalb des Domaenenblocks hinzufuegen:
"skill-id" = "glyph_function_name",
- Die Domaenenanzahl im Kommentar bei Bedarf aktualisieren
Fuer Agents:
viz/R/agent_glyphs.R oeffnen
- Die alphabetische Position in
AGENT_GLYPHS finden
- Den Eintrag hinzufuegen:
"agent-id" = "glyph_function_name",
Fuer Teams:
viz/R/team_glyphs.R oeffnen
Die alphabetische Position in TEAM_GLYPHS finden
Den Eintrag hinzufuegen:
"team-id" = "glyph_function_name",
Sicherstellen, dass keine doppelte ID in der Zielliste existiert
Erwartet: Die entsprechende *_GLYPHS-Liste enthaelt die neue Zuordnung.
Bei Fehler: Falls der Build spaeter "No glyph mapped" meldet, nochmals pruefen, dass die Entitaets-ID exakt mit der im Manifest und in der Registry uebereinstimmt.
Schritt 4: Manifest — Icon-Eintrag hinzufuegen
Das Icon im passenden Manifest registrieren.
Fuer Skills: viz/data/icon-manifest.json
{
"skillId": "skill-id",
"domain": "domain-name",
"prompt": "<domain basePrompt>, <descriptors>, dark background, vector art",
"seed": <next_seed>,
"path": "public/icons/cyberpunk/<domain>/<skill-id>.webp",
"status": "pending"
}
Fuer Agents: viz/data/agent-icon-manifest.json
{
"agentId": "agent-id",
"prompt": "<agent-specific descriptors>, dark background, vector art",
"seed": <next_seed>,
"path": "public/icons/cyberpunk/agents/<agent-id>.webp",
"status": "pending"
}
Fuer Teams: viz/data/team-icon-manifest.json
{
"teamId": "team-id",
"prompt": "<team-specific descriptors>, dark background, vector art",
"seed": <next_seed>,
"path": "public/icons/cyberpunk/teams/<team-id>.webp",
"status": "pending"
}
Erwartet: Gueltiges JSON mit dem neuen Eintrag bei den zugehoerigen Typ-Geschwistern.
Bei Fehler: JSON-Syntax validieren. Haeufige Fehler: nachgestelltes Komma nach dem letzten Array-Element, fehlende Anfuehrungszeichen.
Schritt 5: Rendern — Icon generieren
Die Icon-Pipeline ausfuehren, um die neue Glyphe zu rendern. Immer build.sh als Einstiegspunkt verwenden — es uebernimmt die Plattformerkennung und die Auswahl der R-Binary. Siehe render-icon-pipeline fuer die vollstaendige Flag-Referenz und die Pipeline-Architektur.
# From project root — renders all palettes, standard + HD, skips existing icons
bash viz/build.sh --only <domain> --skip-existing # skills
bash viz/build.sh --type agent --only <id> --skip-existing # agents
bash viz/build.sh --type team --only <id> --skip-existing # teams
# Dry run first:
bash viz/build.sh --only <domain> --dry-run
build.sh fuehrt die vollstaendige Pipeline aus (Palette → Daten → Manifest → Rendering → Terminal-Glyphen). Die Schritte ausserhalb des Renderings kosten etwa 10 Sekunden, stellen aber sicher, dass alle Daten aktuell sind.
Ausgabeorte:
- Skills:
viz/public/icons/<palette>/<domain>/<skill-id>.webp
- Agents:
viz/public/icons/<palette>/agents/<agent-id>.webp
- Teams:
viz/public/icons/<palette>/teams/<team-id>.webp
Erwartet: Das Log zeigt OK: <entity> (seed=XXXXX, XX.XKB) und die WebP-Datei existiert.
Bei Fehler:
"No glyph mapped" — Zuordnung aus Schritt 3 fehlt oder hat einen Tippfehler
"Unknown domain" — Domaene nicht in get_palette_colors() in palettes.R
- R-Paketfehler — Zuerst
install.packages(c("ggplot2", "ggforce", "ggfx", "ragg", "magick")) ausfuehren
- Falls das Rendering abstuerzt, die Glyphen-Funktion interaktiv testen (siehe Schritt 2 Fallback)
Schritt 6: Verifizieren — Visuelle Inspektion
Die gerenderte Ausgabe auf Qualitaetsstandards pruefen.
Datei-Existenz und angemessene Groesse pruefen:
ls -la viz/public/icons/cyberpunk/<type-path>/<entity-id>.webp
# Expected: 15-80 KB typical range
Das WebP in einem Bildbetrachter oeffnen und pruefen:
- Form ist bei voller Groesse (1024x1024) klar erkennbar
- Neon-Glow ist vorhanden, aber nicht uebertrieben
- Hintergrund ist transparent (kein schwarzes/weisses Rechteck)
- Kein Beschnitt an den Leinwandraendern
Bei kleinen Groessen pruefen (das Icon wird mit ~40-160px im Force-Graph gerendert):
- Form bleibt erkennbar
- Details werden nicht zu Rauschen
- Glow uebertrifft nicht die Form
Erwartet: Ein klares, erkennbares Piktogramm mit gleichmaessigem Neon-Glow auf transparentem Hintergrund.
Bei Fehler:
- Glow zu stark: mit
--glow-sigma 2 neu rendern (Standard ist 4)
- Glow zu schwach: mit
--glow-sigma 8 neu rendern
- Form bei kleinen Groessen unlesbar: Glyphe vereinfachen (weniger Ebenen, kraeftigere Striche,
.lw(s, base) Basiswert erhoehen)
- Beschnitt an Raendern: Formdimensionen reduzieren oder Zentrum verschieben
Schritt 7: Iterieren — Bei Bedarf verfeinern
Anpassungen vornehmen und erneut rendern.
Haeufige Anpassungen:
- Kraeftigere Striche:
.lw(s, base) erhoehen — base = 3.0 oder 3.5 versuchen
- Sichtbarere Fuellung: Alpha von 0.10 auf 0.15-0.20 erhoehen
- Formproportionen: Multiplikatoren auf
s anpassen (z.B. 20 * s -> 24 * s)
- Detail-Ebenen hinzufuegen/entfernen: Gesamtzahl der Ebenen zwischen 2-6 halten fuer beste Ergebnisse
Zum erneuten Rendern nach Aenderungen:
# Delete the existing icon first, then re-render
rm viz/public/icons/cyberpunk/<type-path>/<entity-id>.webp
# Use the appropriate build command from Step 5
Wenn zufriedenstellend, pruefen, ob der Manifest-Status "done" zeigt (das Build-Skript aktualisiert ihn automatisch bei Erfolg)
Erwartet: Das fertige Icon besteht alle Pruefungen aus Schritt 6.
Bei Fehler: Falls die Glyphe nach 3+ Iterationen immer noch nicht gut lesbar ist, eine voellig andere visuelle Metapher in Betracht ziehen (zurueck zu Schritt 1).
Referenz
Domaenen- und Entitaetsfarbpaletten
Alle Domaenenfarben (fuer Skills) sind in viz/R/palettes.R definiert (die einzige Quelle der Wahrheit). Agent- und Team-Farben werden ebenfalls in palettes.R verwaltet. Die Cyberpunk-Palette (handabgestimmte Neonfarben) ist in get_cyberpunk_colors(). Viridis-Familienpaletten werden automatisch ueber viridisLite generiert.
Zum Nachschlagen einer Farbe:
source("viz/R/palettes.R")
get_palette_colors("cyberpunk")$domains[["design"]] # skill domain
get_palette_colors("cyberpunk")$agents[["mystic"]] # agent
get_palette_colors("cyberpunk")$teams[["tending"]] # team
Beim Hinzufuegen einer neuen Domaene an drei Stellen in palettes.R eintragen:
PALETTE_DOMAIN_ORDER (alphabetisch)
get_cyberpunk_colors() Domaenenliste
bash viz/build.sh ausfuehren, um Paletten, Daten und Manifeste zu regenerieren
Glyphen-Funktionskatalog
Den vollstaendigen Katalog verfuegbarer Glyphen-Funktionen in den Primitives-Quelldateien einsehen:
- Skills:
viz/R/primitives.R bis viz/R/primitives_19.R (domaenengruppiert)
- Agents:
viz/R/agent_primitives.R
- Teams:
viz/R/team_primitives.R
Hilfsfunktionen
| Funktion |
Signatur |
Zweck |
.lw(s, base) |
(scale, base=2.5) |
Skalierungsbewusste Linienbreite |
.aes(...) |
alias fuer ggplot2::aes |
Kurzform-Aesthetic-Mapping |
hex_with_alpha(hex, alpha) |
(string, 0-1) |
Alpha zu Hex-Farbe hinzufuegen |
brighten_hex(hex, factor) |
(string, factor=1.3) |
Hex-Farbe aufhellen |
dim_hex(hex, factor) |
(string, factor=0.4) |
Hex-Farbe abdunkeln |
Validierungscheckliste
Haeufige Fehler
* s vergessen: Hartcodierte Pixelwerte brechen, wenn sich die Skalierung aendert. Immer mit s multiplizieren.
- Leinwand-Ursprungsverwirrung: (0,0) ist unten links, nicht oben links. Hoehere
y-Werte bewegen sich NACH OBEN.
- Doppelter Glow: Der Renderer wendet bereits
ggfx::with_outer_glow() auf jede Ebene an. Keinen Glow INNERHALB der Glyphen-Funktion hinzufuegen.
- Zu viele Ebenen: Jede Ebene bekommt individuelles Glow-Wrapping. Mehr als 8 Ebenen macht das Rendering langsam und visuell unruhig.
- Nicht uebereinstimmende IDs: Die Entitaets-ID in der Glyphen-Zuordnung, im Manifest und in der Registry muessen alle exakt uebereinstimmen.
- JSON-Nachkommas: Das Manifest ist striktes JSON. Kein nachgestelltes Komma nach dem letzten Array-Element.
- Fehlende Domaenenfarbe: Falls die Domaene nicht in
get_cyberpunk_colors() in palettes.R ist, wird das Rendering einen Fehler werfen. Zuerst die Farbe hinzufuegen, dann regenerieren.
- Falsche Primitives-Datei: Skills gehoeren in domaenengruppierte
primitives*.R, Agents in agent_primitives.R, Teams in team_primitives.R.
Verwandte Skills
- enhance-glyph — Visuelle Qualitaet einer bestehenden Glyphe verbessern, Rendering-Probleme beheben oder Detail-Ebenen hinzufuegen
- audit-icon-pipeline — Fehlende Glyphen und Icons erkennen, um zu wissen, was erstellt werden muss
- render-icon-pipeline — Die vollstaendige Rendering-Pipeline von Anfang bis Ende ausfuehren
- ornament-style-mono — Komplementaere KI-basierte Bilderzeugung (Z-Image vs R-codierte Glyphen)
- ornament-style-color — Farbtheorie anwendbar auf Glyphen-Akzentfuellungsentscheidungen
- create-skill — Der uebergeordnete Workflow, der Glyphen-Erstellung ausloest beim Hinzufuegen neuer Skills
1---2name: create-glyph-113locale: de4source_locale: en5source_commit: 33b561c96fence_basis_commit: 33b561c97translator: claude8translation_date: "2026-03-18"9description: >10 R-basierte Piktogramm-Glyphen fuer Skill-, Agent- oder Team-Icons in der11 Visualisierungsschicht erstellen. Umfasst Konzeptskizze, ggplot2-Ebenenzusammenstellung12 mit der Primitives-Bibliothek, Farbstrategie, Registrierung in der passenden13 Glyph-Zuordnungsdatei und im Manifest, Rendering ueber die Build-Pipeline sowie14 visuelle Ueberpruefung der Neon-Glow-Ausgabe. Verwenden, wenn eine neue Entitaet15 hinzugefuegt wurde und ein visuelles Icon fuer die Force-Graph-Visualisierung braucht,16 eine bestehende Glyphe ersetzt werden soll, oder beim Batch-Erstellen von Glyphen17 fuer eine neue Domaene.18license: MIT19allowed-tools: Read Write Edit Bash Grep Glob20metadata:21 source: https://skillmd.com/skills/pjt222/create-glyph-1122 author: Philipp Thoss23 version: "2.0"24 domain: design25 complexity: intermediate26 language: R27 tags: design, glyph, pictogram, icon, ggplot2, visualization, neon28---2930# Glyphe erstellen3132R-basierte Piktogramm-Glyphen fuer Skill-, Agent- oder Team-Icons in der `viz/`-Visualisierungsschicht erstellen. Jede Glyphe ist eine reine ggplot2-Funktion, die eine erkennbare Form auf einer 100x100-Leinwand zeichnet und mit einem Neon-Glow-Effekt als transparentes WebP gerendert wird.3334## Wann verwenden3536- Ein neuer Skill, Agent oder Team wurde hinzugefuegt und benoetigt ein visuelles Icon37- Eine bestehende Glyphe soll ersetzt oder neu gestaltet werden38- Batch-Erstellung von Glyphen fuer eine neue Skill-Domaene39- Visuelle Metaphern fuer Entitaetskonzepte prototypisieren4041## Eingaben4243- **Erforderlich**: Entitaetstyp — `skill`, `agent` oder `team`44- **Erforderlich**: Entitaets-ID (z.B. `create-glyph`, `mystic`, `r-package-review`) und Domaene (fuer Skills)45- **Erforderlich**: Visuelles Konzept — was die Glyphe darstellen soll46- **Optional**: Referenz-Glyphe zum Studium des Komplexitaetsniveaus47- **Optional**: Benutzerdefinierter `--glow-sigma`-Wert (Standard: 4)4849## Verfahren5051### Schritt 1: Konzept — Visuelle Metapher entwerfen5253Die zu ikonifizierende Entitaet identifizieren und eine visuelle Metapher waehlen.54551. Die Quelldatei der Entitaet lesen, um das Kernkonzept zu verstehen:56 - Skills: `skills/<id>/SKILL.md`57 - Agents: `agents/<id>.md`58 - Teams: `teams/<id>.md`592. Einen Metaphertyp waehlen:60 - **Konkretes Objekt**: ein Kolben fuer Experimente, ein Schild fuer Sicherheit61 - **Abstraktes Symbol**: Pfeile fuer Zusammenfuehrung, Spiralen fuer Iteration62 - **Zusammengesetzt**: 2-3 einfache Formen kombinieren (z.B. Dokument + Stift)633. Bestehende Glyphen als Komplexitaetsreferenz heranziehen:6465```text66Complexity Tiers:67+----------+--------+-------------------------------------------+68| Tier | Layers | Examples |69+----------+--------+-------------------------------------------+70| Simple | 2 | glyph_flame, glyph_heartbeat |71| Moderate | 3-5 | glyph_document, glyph_experiment_flask |72| Complex | 6+ | glyph_ship_wheel, glyph_bridge_cpp |73+----------+--------+-------------------------------------------+74```75764. Einen Funktionsnamen festlegen: `glyph_<beschreibender_name>` (snake_case, eindeutig)7778**Erwartet:** Eine klare gedankliche Skizze der Form mit 2-6 geplanten Ebenen.7980**Bei Fehler:** Falls das Konzept zu abstrakt ist, auf ein verwandtes konkretes Objekt zurueckgreifen. Bestehende Glyphen in derselben Domaene zur Inspiration durchsehen.8182### Schritt 2: Zusammensetzen — Glyphen-Funktion schreiben8384Die R-Funktion schreiben, die ggplot2-Ebenen erzeugt.85861. Funktionssignatur (unveraenderlicher Vertrag):87 ```r88 glyph_<name> <- function(cx, cy, s, col, bright) {89 # cx, cy = center coordinates (50, 50 on 100x100 canvas)90 # s = scale factor (1.0 = fill ~70% of canvas)91 # col = domain color hex (e.g., "#ff88dd" for design)92 # bright = brightened variant of col (auto-computed by renderer)93 # Returns: list() of ggplot2 layers94 }95 ```96972. Skalierungsfaktor `* s` auf ALLE Dimensionen anwenden fuer konsistente Skalierung:98 ```r99 r <- 20 * s # radius100 hw <- 15 * s # half-width101 lw <- .lw(s) # line width (default base 2.5)102 lw_thin <- .lw(s, 1.2) # thinner line width103 ```1041053. Geometrie mit verfuegbaren Primitives erstellen:106107 | Geometrie | Verwendung |108 |---|---|109 | `ggplot2::geom_polygon(data, .aes(x, y), ...)` | Gefuellte Formen |110 | `ggplot2::geom_path(data, .aes(x, y), ...)` | Offene Linien/Kurven |111 | `ggplot2::geom_segment(data, .aes(x, xend, y, yend), ...)` | Liniensegmente, Pfeile |112 | `ggplot2::geom_rect(data, .aes(xmin, xmax, ymin, ymax), ...)` | Rechtecke |113 | `ggforce::geom_circle(data, .aes(x0, y0, r), ...)` | Kreise |1141154. Die Farbstrategie anwenden:116117 ```text118 Alpha Guide:119 +----------------------+------------+--------------------------+120 | Purpose | Alpha | Example |121 +----------------------+------------+--------------------------+122 | Large fill (body) | 0.08-0.15 | hex_with_alpha(col, 0.1) |123 | Medium fill (accent) | 0.15-0.25 | hex_with_alpha(col, 0.2) |124 | Small fill (detail) | 0.25-0.35 | hex_with_alpha(bright, 0.3) |125 | Outline stroke | 1.0 | color = bright |126 | Secondary stroke | 1.0 | color = col |127 | No fill | --- | fill = NA |128 +----------------------+------------+--------------------------+129 ```1301315. Eine flache `list()` von Ebenen zurueckgeben (der Renderer iteriert und umgibt jede mit Glow)1321336. Die Funktion in der passenden Primitives-Datei basierend auf dem Entitaetstyp platzieren:134 - **Skills**: Domaenengruppiert ueber 19 Primitives-Dateien:135 - `primitives.R` — bushcraft, compliance, containerization, data-serialization, defensive136 - `primitives_2.R` — devops, general, git, mcp-integration137 - `primitives_3.R` — mlops, observability, PM, r-packages, reporting, review, web-dev, esoteric, design138 - Weitere `primitives_4.R` bis `primitives_19.R` fuer neuere Domaenen139 - **Agents**: `viz/R/agent_primitives.R`140 - **Teams**: `viz/R/team_primitives.R`141142**Erwartet:** Eine funktionierende R-Funktion, die eine Liste von 2-6 ggplot2-Ebenen zurueckgibt.143144**Bei Fehler:** Falls `ggforce::geom_circle` Fehler verursacht, sicherstellen, dass ggforce installiert ist. Falls Koordinaten nicht stimmen, bedenken, dass die Leinwand 100x100 mit (0,0) unten links ist. Die Funktion interaktiv testen:145```r146source("viz/R/utils.R"); source("viz/R/primitives.R") # etc.147layers <- glyph_<name>(50, 50, 1.0, "#ff88dd", "#ffa8f0")148p <- ggplot2::ggplot() + ggplot2::coord_fixed(xlim=c(0,100), ylim=c(0,100)) +149 ggplot2::theme_void()150for (l in layers) p <- p + l151print(p)152```153154### Schritt 3: Registrieren — Entitaet der Glyphe zuordnen155156Die Entitaet-zu-Glyphe-Zuordnung in der passenden Glyph-Zuordnungsdatei hinzufuegen.157158**Fuer Skills:**1591. `viz/R/glyphs.R` oeffnen1602. Den Kommentarbereich fuer die Zieldomaene finden (z.B. `# -- design (3)`)1613. Den Eintrag in alphabetischer Reihenfolge innerhalb des Domaenenblocks hinzufuegen:162 ```r163 "skill-id" = "glyph_function_name",164 ```1654. Die Domaenenanzahl im Kommentar bei Bedarf aktualisieren166167**Fuer Agents:**1681. `viz/R/agent_glyphs.R` oeffnen1692. Die alphabetische Position in `AGENT_GLYPHS` finden1703. Den Eintrag hinzufuegen:171 ```r172 "agent-id" = "glyph_function_name",173 ```174175**Fuer Teams:**1761. `viz/R/team_glyphs.R` oeffnen1772. Die alphabetische Position in `TEAM_GLYPHS` finden1783. Den Eintrag hinzufuegen:179 ```r180 "team-id" = "glyph_function_name",181 ```1821835. Sicherstellen, dass keine doppelte ID in der Zielliste existiert184185**Erwartet:** Die entsprechende `*_GLYPHS`-Liste enthaelt die neue Zuordnung.186187**Bei Fehler:** Falls der Build spaeter "No glyph mapped" meldet, nochmals pruefen, dass die Entitaets-ID exakt mit der im Manifest und in der Registry uebereinstimmt.188189### Schritt 4: Manifest — Icon-Eintrag hinzufuegen190191Das Icon im passenden Manifest registrieren.192193**Fuer Skills:** `viz/data/icon-manifest.json`194```json195{196 "skillId": "skill-id",197 "domain": "domain-name",198 "prompt": "<domain basePrompt>, <descriptors>, dark background, vector art",199 "seed": <next_seed>,200 "path": "public/icons/cyberpunk/<domain>/<skill-id>.webp",201 "status": "pending"202}203```204205**Fuer Agents:** `viz/data/agent-icon-manifest.json`206```json207{208 "agentId": "agent-id",209 "prompt": "<agent-specific descriptors>, dark background, vector art",210 "seed": <next_seed>,211 "path": "public/icons/cyberpunk/agents/<agent-id>.webp",212 "status": "pending"213}214```215216**Fuer Teams:** `viz/data/team-icon-manifest.json`217```json218{219 "teamId": "team-id",220 "prompt": "<team-specific descriptors>, dark background, vector art",221 "seed": <next_seed>,222 "path": "public/icons/cyberpunk/teams/<team-id>.webp",223 "status": "pending"224}225```226227**Erwartet:** Gueltiges JSON mit dem neuen Eintrag bei den zugehoerigen Typ-Geschwistern.228229**Bei Fehler:** JSON-Syntax validieren. Haeufige Fehler: nachgestelltes Komma nach dem letzten Array-Element, fehlende Anfuehrungszeichen.230231### Schritt 5: Rendern — Icon generieren232233Die Icon-Pipeline ausfuehren, um die neue Glyphe zu rendern. Immer `build.sh` als Einstiegspunkt verwenden — es uebernimmt die Plattformerkennung und die Auswahl der R-Binary. Siehe [render-icon-pipeline](../render-icon-pipeline/SKILL.md) fuer die vollstaendige Flag-Referenz und die Pipeline-Architektur.234235```bash236# From project root — renders all palettes, standard + HD, skips existing icons237bash viz/build.sh --only <domain> --skip-existing # skills238bash viz/build.sh --type agent --only <id> --skip-existing # agents239bash viz/build.sh --type team --only <id> --skip-existing # teams240241# Dry run first:242bash viz/build.sh --only <domain> --dry-run243```244245`build.sh` fuehrt die vollstaendige Pipeline aus (Palette → Daten → Manifest → Rendering → Terminal-Glyphen). Die Schritte ausserhalb des Renderings kosten etwa 10 Sekunden, stellen aber sicher, dass alle Daten aktuell sind.246247Ausgabeorte:248 - Skills: `viz/public/icons/<palette>/<domain>/<skill-id>.webp`249 - Agents: `viz/public/icons/<palette>/agents/<agent-id>.webp`250 - Teams: `viz/public/icons/<palette>/teams/<team-id>.webp`251252**Erwartet:** Das Log zeigt `OK: <entity> (seed=XXXXX, XX.XKB)` und die WebP-Datei existiert.253254**Bei Fehler:**255- `"No glyph mapped"` — Zuordnung aus Schritt 3 fehlt oder hat einen Tippfehler256- `"Unknown domain"` — Domaene nicht in `get_palette_colors()` in `palettes.R`257- R-Paketfehler — Zuerst `install.packages(c("ggplot2", "ggforce", "ggfx", "ragg", "magick"))` ausfuehren258- Falls das Rendering abstuerzt, die Glyphen-Funktion interaktiv testen (siehe Schritt 2 Fallback)259260### Schritt 6: Verifizieren — Visuelle Inspektion261262Die gerenderte Ausgabe auf Qualitaetsstandards pruefen.2632641. Datei-Existenz und angemessene Groesse pruefen:265 ```bash266 ls -la viz/public/icons/cyberpunk/<type-path>/<entity-id>.webp267 # Expected: 15-80 KB typical range268 ```2692702. Das WebP in einem Bildbetrachter oeffnen und pruefen:271 - Form ist bei voller Groesse (1024x1024) klar erkennbar272 - Neon-Glow ist vorhanden, aber nicht uebertrieben273 - Hintergrund ist transparent (kein schwarzes/weisses Rechteck)274 - Kein Beschnitt an den Leinwandraendern2752763. Bei kleinen Groessen pruefen (das Icon wird mit ~40-160px im Force-Graph gerendert):277 - Form bleibt erkennbar278 - Details werden nicht zu Rauschen279 - Glow uebertrifft nicht die Form280281**Erwartet:** Ein klares, erkennbares Piktogramm mit gleichmaessigem Neon-Glow auf transparentem Hintergrund.282283**Bei Fehler:**284- Glow zu stark: mit `--glow-sigma 2` neu rendern (Standard ist 4)285- Glow zu schwach: mit `--glow-sigma 8` neu rendern286- Form bei kleinen Groessen unlesbar: Glyphe vereinfachen (weniger Ebenen, kraeftigere Striche, `.lw(s, base)` Basiswert erhoehen)287- Beschnitt an Raendern: Formdimensionen reduzieren oder Zentrum verschieben288289### Schritt 7: Iterieren — Bei Bedarf verfeinern290291Anpassungen vornehmen und erneut rendern.2922931. Haeufige Anpassungen:294 - **Kraeftigere Striche**: `.lw(s, base)` erhoehen — `base = 3.0` oder `3.5` versuchen295 - **Sichtbarere Fuellung**: Alpha von 0.10 auf 0.15-0.20 erhoehen296 - **Formproportionen**: Multiplikatoren auf `s` anpassen (z.B. `20 * s` -> `24 * s`)297 - **Detail-Ebenen hinzufuegen/entfernen**: Gesamtzahl der Ebenen zwischen 2-6 halten fuer beste Ergebnisse2982992. Zum erneuten Rendern nach Aenderungen:300 ```bash301 # Delete the existing icon first, then re-render302 rm viz/public/icons/cyberpunk/<type-path>/<entity-id>.webp303 # Use the appropriate build command from Step 5304 ```3053063. Wenn zufriedenstellend, pruefen, ob der Manifest-Status `"done"` zeigt (das Build-Skript aktualisiert ihn automatisch bei Erfolg)307308**Erwartet:** Das fertige Icon besteht alle Pruefungen aus Schritt 6.309310**Bei Fehler:** Falls die Glyphe nach 3+ Iterationen immer noch nicht gut lesbar ist, eine voellig andere visuelle Metapher in Betracht ziehen (zurueck zu Schritt 1).311312## Referenz313314### Domaenen- und Entitaetsfarbpaletten315316Alle Domaenenfarben (fuer Skills) sind in `viz/R/palettes.R` definiert (die einzige Quelle der Wahrheit). Agent- und Team-Farben werden ebenfalls in `palettes.R` verwaltet. Die Cyberpunk-Palette (handabgestimmte Neonfarben) ist in `get_cyberpunk_colors()`. Viridis-Familienpaletten werden automatisch ueber `viridisLite` generiert.317318Zum Nachschlagen einer Farbe:319```r320source("viz/R/palettes.R")321get_palette_colors("cyberpunk")$domains[["design"]] # skill domain322get_palette_colors("cyberpunk")$agents[["mystic"]] # agent323get_palette_colors("cyberpunk")$teams[["tending"]] # team324```325326Beim Hinzufuegen einer neuen Domaene an drei Stellen in `palettes.R` eintragen:3271. `PALETTE_DOMAIN_ORDER` (alphabetisch)3282. `get_cyberpunk_colors()` Domaenenliste3293. `bash viz/build.sh` ausfuehren, um Paletten, Daten und Manifeste zu regenerieren330331### Glyphen-Funktionskatalog332333Den vollstaendigen Katalog verfuegbarer Glyphen-Funktionen in den Primitives-Quelldateien einsehen:334- **Skills**: `viz/R/primitives.R` bis `viz/R/primitives_19.R` (domaenengruppiert)335- **Agents**: `viz/R/agent_primitives.R`336- **Teams**: `viz/R/team_primitives.R`337338### Hilfsfunktionen339340| Funktion | Signatur | Zweck |341|---|---|---|342| `.lw(s, base)` | `(scale, base=2.5)` | Skalierungsbewusste Linienbreite |343| `.aes(...)` | alias fuer `ggplot2::aes` | Kurzform-Aesthetic-Mapping |344| `hex_with_alpha(hex, alpha)` | `(string, 0-1)` | Alpha zu Hex-Farbe hinzufuegen |345| `brighten_hex(hex, factor)` | `(string, factor=1.3)` | Hex-Farbe aufhellen |346| `dim_hex(hex, factor)` | `(string, factor=0.4)` | Hex-Farbe abdunkeln |347348## Validierungscheckliste349350- [ ] Glyphen-Funktion folgt der `glyph_<name>(cx, cy, s, col, bright) -> list()` Signatur351- [ ] Alle Dimensionen verwenden den `* s` Skalierungsfaktor352- [ ] Farbstrategie nutzt `col` fuer Fuellungen, `bright` fuer Umrisse, `hex_with_alpha()` fuer Transparenz353- [ ] Funktion in der korrekten Primitives-Datei fuer Entitaetstyp und Domaene platziert354- [ ] Glyphen-Zuordnungseintrag in der passenden `*_glyphs.R`-Datei hinzugefuegt355- [ ] Manifest-Eintrag mit korrekter Entitaets-ID, Pfad und `"status": "pending"` hinzugefuegt356- [ ] Build-Befehl laeuft ohne Fehler (zuerst Probelauf)357- [ ] Gerendertes WebP existiert am erwarteten Pfad358- [ ] Dateigroesse im erwarteten Bereich (15-80 KB)359- [ ] Icon ist bei 1024px und ~40px Anzeiggroessen klar erkennbar360- [ ] Transparenter Hintergrund (kein massives Rechteck hinter der Glyphe)361- [ ] Manifest-Status nach erfolgreichem Rendern auf `"done"` aktualisiert362363## Haeufige Fehler364365- **`* s` vergessen**: Hartcodierte Pixelwerte brechen, wenn sich die Skalierung aendert. Immer mit `s` multiplizieren.366- **Leinwand-Ursprungsverwirrung**: (0,0) ist unten links, nicht oben links. Hoehere `y`-Werte bewegen sich NACH OBEN.367- **Doppelter Glow**: Der Renderer wendet bereits `ggfx::with_outer_glow()` auf jede Ebene an. Keinen Glow INNERHALB der Glyphen-Funktion hinzufuegen.368- **Zu viele Ebenen**: Jede Ebene bekommt individuelles Glow-Wrapping. Mehr als 8 Ebenen macht das Rendering langsam und visuell unruhig.369- **Nicht uebereinstimmende IDs**: Die Entitaets-ID in der Glyphen-Zuordnung, im Manifest und in der Registry muessen alle exakt uebereinstimmen.370- **JSON-Nachkommas**: Das Manifest ist striktes JSON. Kein nachgestelltes Komma nach dem letzten Array-Element.371- **Fehlende Domaenenfarbe**: Falls die Domaene nicht in `get_cyberpunk_colors()` in `palettes.R` ist, wird das Rendering einen Fehler werfen. Zuerst die Farbe hinzufuegen, dann regenerieren.372- **Falsche Primitives-Datei**: Skills gehoeren in domaenengruppierte `primitives*.R`, Agents in `agent_primitives.R`, Teams in `team_primitives.R`.373374## Verwandte Skills375376- [enhance-glyph](../enhance-glyph/SKILL.md) — Visuelle Qualitaet einer bestehenden Glyphe verbessern, Rendering-Probleme beheben oder Detail-Ebenen hinzufuegen377- [audit-icon-pipeline](../audit-icon-pipeline/SKILL.md) — Fehlende Glyphen und Icons erkennen, um zu wissen, was erstellt werden muss378- [render-icon-pipeline](../render-icon-pipeline/SKILL.md) — Die vollstaendige Rendering-Pipeline von Anfang bis Ende ausfuehren379- [ornament-style-mono](../ornament-style-mono/SKILL.md) — Komplementaere KI-basierte Bilderzeugung (Z-Image vs R-codierte Glyphen)380- [ornament-style-color](../ornament-style-color/SKILL.md) — Farbtheorie anwendbar auf Glyphen-Akzentfuellungsentscheidungen381- [create-skill](../create-skill/SKILL.md) — Der uebergeordnete Workflow, der Glyphen-Erstellung ausloest beim Hinzufuegen neuer Skills