Transmutieren
Ein bestimmtes Stueck Code oder Daten von einer Form in eine andere transformieren — Sprachuebersetzung, Paradigmenwechsel, Formatkonvertierung oder API-Migration — und dabei das wesentliche Verhalten und die Semantik beibehalten.
Wann verwenden
- Konvertieren einer Funktion von einer Sprache in eine andere (Python nach R, JavaScript nach TypeScript)
- Verschieben eines Moduls von einem Paradigma (klassenbasiert zu funktional, Callbacks zu async/await)
- Migrieren eines API-Konsumenten von v1 zu v2 eines externen Dienstes
- Konvertieren von Daten zwischen Formaten (CSV nach Parquet, REST nach GraphQL-Schema)
- Ersetzen einer Abhaengigkeit durch eine gleichwertige (moment.js durch date-fns, jQuery durch natives JS)
- Wenn der Transformationsumfang eine einzelne Funktion, Klasse oder ein Modul ist (nicht ein ganzes System)
Eingaben
- Erforderlich: Quellmaterial (Dateipfad, Funktionsname oder Datenbeispiel)
- Erforderlich: Zielform (Sprache, Paradigma, Format oder API-Version)
- Optional: Verhaltensvertrag (Tests, Typsignaturen oder erwartete Ein-/Ausgabepaare)
- Optional: Einschraenkungen (muss Rueckwaertskompatibilitaet wahren, Performancebudget)
Vorgehensweise
Schritt 1: Das Quellmaterial analysieren
Genau verstehen was die Quelle tut bevor eine Transformation versucht wird.
- Die Quelle vollstaendig lesen — jeden Zweig, Grenzfall und Fehlerpfad
- Den Verhaltensvertrag identifizieren:
- Welche Eingaben akzeptiert sie? (Typen, Bereiche, Grenzfaelle)
- Welche Ausgaben erzeugt sie? (Rueckgabewerte, Seiteneffekte, Fehlersignale)
- Welche Invarianten haelt sie aufrecht? (Reihenfolge, Eindeutigkeit, referenzielle Integritaet)
- Abhaengigkeiten katalogisieren: was importiert, ruft auf oder setzt die Quelle voraus?
- Falls Tests existieren, sie lesen um das erwartete Verhalten zu verstehen
- Falls keine Tests existieren, vor dem Transmutieren Verhaltenscharakterisierungstests schreiben
Erwartet: Ein vollstaendiges Verstaendnis dessen was die Quelle tut (nicht wie sie es tut). Der Verhaltensvertrag ist explizit und testbar.
Bei Fehler: Wenn die Quelle zu komplex fuer eine einzelne Transmutation ist, erwaegen sie in kleinere Teile zu zerlegen oder zum vollstaendigen athanor-Verfahren zu eskalieren. Bei mehrdeutigem Verhalten um Klaerung bitten statt zu raten.
Schritt 2: Quelle auf Zielform abbilden
Die Transformationsabbildung entwerfen.
- Fuer jedes Element in der Quelle das Ziel-Aequivalent identifizieren:
- Sprachkonstrukte: Schleifen -> map/filter, Klassen -> Closures usw.
- API-Aufrufe: alter Endpunkt -> neuer Endpunkt, Aenderungen der Request-/Response-Struktur
- Datentypen: DataFrame-Spalten -> Schema-Felder, verschachteltes JSON -> flache Tabellen
- Elemente ohne direktes Aequivalent identifizieren:
- Quellfunktionalitaet die im Ziel fehlt (z.B. Pattern Matching in einer Sprache ohne diese Funktion)
- Zielidiome die in der Quelle nicht existieren (z.B. R-Vektorisierung vs. Python-Schleifen)
- Fuer jede Luecke eine Anpassungsstrategie waehlen:
- Emulieren: das Verhalten mit zielseitigen Konstrukten nachbilden
- Vereinfachen: wenn das Quellkonstrukt ein Workaround war, die native Loesung des Ziels nutzen
- Dokumentieren: wenn sich das Verhalten leicht aendert, den Unterschied explizit festhalten
- Die Transformationsabbildung schreiben: Quellelement -> Zielelement, fuer jedes Stueck
Erwartet: Eine vollstaendige Abbildung in der jedes Quellelement ein Ziel hat. Luecken sind identifiziert und Anpassungsstrategien gewaehlt.
Bei Fehler: Wenn zu viele Elemente kein direktes Aequivalent haben, ist die Transformation moeglicherweise ungeeignet (z.B. Transmutieren eines stark objektorientierten Designs in eine Sprache ohne Klassen). Die Zielform ueberdenken oder zu athanor eskalieren.
Schritt 3: Die Transformation ausfuehren
Die Zielform gemaess der Abbildung schreiben.
- Die Zieldatei(en) mit passender Struktur und Boilerplate erstellen
- Jedes Element gemaess der Abbildung aus Schritt 2 transmutieren:
- Den Verhaltensvertrag beibehalten — gleiche Eingaben erzeugen gleiche Ausgaben
- Zielseitige Idiome verwenden statt woertlicher Uebersetzungen
- Fehlerbehandlung beibehalten oder verbessern
- Abhaengigkeiten behandeln:
- Quellabhaengigkeiten durch Ziel-Aequivalente ersetzen
- Wenn eine Abhaengigkeit kein Aequivalent hat, einen minimalen Adapter implementieren
- Inline-Kommentare nur dort hinzufuegen wo die Transformation nicht offensichtlich war
Erwartet: Eine vollstaendige Zielimplementierung die der Transformationsabbildung folgt. Der Code liest sich als waere er nativ in der Zielform geschrieben, nicht mechanisch uebersetzt.
Bei Fehler: Wenn ein bestimmtes Element sich der Transformation widersetzt, es isolieren. Alles andere zuerst transformieren, dann das widerspenstige Element mit fokussierter Aufmerksamkeit angehen. Wenn es wirklich nicht transmutiert werden kann, dokumentieren warum und einen Workaround bereitstellen.
Schritt 4: Verhaltensaequivalenz verifizieren
Bestaetigen dass die transmutierte Form das Verhalten des Originals bewahrt.
- Die Verhaltensvertragstests gegen die Zielimplementierung ausfuehren
- Fuer jeden Testfall verifizieren:
- Gleiche Eingaben -> gleiche Ausgaben (innerhalb akzeptabler Toleranz fuer numerische Konvertierungen)
- Gleiche Fehlerbedingungen -> aequivalente Fehlersignale
- Seiteneffekte (falls vorhanden) sind bewahrt oder als geaendert dokumentiert
- Grenzfaelle explizit pruefen:
- Null/NA/undefined-Behandlung
- Leere Sammlungen
- Grenzwerte (maximaler Integer, leerer String, Arrays der Laenge Null)
- Wenn die Zielform Faehigkeiten hinzufuegt (z.B. Typsicherheit), diese ebenfalls verifizieren
Erwartet: Alle Verhaltensvertragstests bestehen. Grenzfaelle werden aequivalent behandelt. Alle Verhaltensunterschiede sind dokumentiert und beabsichtigt.
Bei Fehler: Wenn Tests fehlschlagen, die Differenz zwischen Quell- und Zielverhalten finden. Das Ziel an den Quellvertrag anpassen. Wenn die Abweichung beabsichtigt ist (z.B. Beheben eines Fehlers im Original), sie explizit dokumentieren.
Validierung
Haeufige Stolperfallen
- Woertliche Uebersetzung: Python-in-R oder Java-in-JavaScript schreiben statt Zielidiome zu verwenden. Das Ergebnis sollte nativ aussehen
- Verhaltenstests ueberspringen: Transmutieren ohne Tests bedeutet man kann die Aequivalenz nicht verifizieren. Zuerst Charakterisierungstests schreiben
- Grenzfaelle ignorieren: Der Standardpfad transmutiert leicht; in den Grenzfaellen verstecken sich die Fehler
- Adapter ueberdesignen: Wenn eine Abhaengigkeit einen 200-Zeilen-Adapter braucht, ist der Transmutationsumfang zu gross
- Kommentare woertlich uebernehmen: Kommentare sollten den Zielcode erklaeren, nicht die Quelle widerspiegeln. Sie neu schreiben
Verwandte Skills
athanor — Vollstaendige vierstufige Transformation fuer Systeme die zu gross fuer eine einzelne Transmutation sind
chrysopoeia — Optimierung transmutierten Codes fuer maximale Wertgewinnung
review-software-architecture — Architekturpruefung nach der Transmutation fuer groessere Konvertierungen
serialize-data-formats — Spezialisierte Datenformat-Konvertierungsverfahren
1---2name: transmute-113locale: de4source_locale: en5source_commit: ecece0b76fence_basis_commit: ecece0b77translator: claude8translation_date: "2026-03-17"9description: >10 Eine einzelne Funktion, ein Modul oder eine Datenstruktur von einer Form in11 eine andere transformieren und dabei das wesentliche Verhalten beibehalten.12 Leichtgewichtiger als der volle Athanor-Zyklus, geeignet fuer gezielte13 Konvertierungen bei denen die Ein- und Ausgabeformen gut verstanden sind.14 Anwenden beim Konvertieren einer Funktion zwischen Sprachen, Verschieben15 eines Moduls zwischen Paradigmen, Migrieren eines API-Konsumenten auf eine16 neue Version, Konvertieren von Datenformaten oder Ersetzen einer Abhaengigkeit17 — wenn der Transformationsumfang eine einzelne Funktion, Klasse oder ein18 Modul ist statt eines ganzen Systems.19license: MIT20allowed-tools: Read Write Edit Bash Grep Glob21metadata:22 source: https://skillmd.com/skills/pjt222/transmute-1123 author: Philipp Thoss24 version: "1.0"25 domain: alchemy26 complexity: intermediate27 language: multi28 tags: alchemy, transmutation, conversion, refactoring, transformation, targeted29---3031# Transmutieren3233Ein bestimmtes Stueck Code oder Daten von einer Form in eine andere transformieren — Sprachuebersetzung, Paradigmenwechsel, Formatkonvertierung oder API-Migration — und dabei das wesentliche Verhalten und die Semantik beibehalten.3435## Wann verwenden3637- Konvertieren einer Funktion von einer Sprache in eine andere (Python nach R, JavaScript nach TypeScript)38- Verschieben eines Moduls von einem Paradigma (klassenbasiert zu funktional, Callbacks zu async/await)39- Migrieren eines API-Konsumenten von v1 zu v2 eines externen Dienstes40- Konvertieren von Daten zwischen Formaten (CSV nach Parquet, REST nach GraphQL-Schema)41- Ersetzen einer Abhaengigkeit durch eine gleichwertige (moment.js durch date-fns, jQuery durch natives JS)42- Wenn der Transformationsumfang eine einzelne Funktion, Klasse oder ein Modul ist (nicht ein ganzes System)4344## Eingaben4546- **Erforderlich**: Quellmaterial (Dateipfad, Funktionsname oder Datenbeispiel)47- **Erforderlich**: Zielform (Sprache, Paradigma, Format oder API-Version)48- **Optional**: Verhaltensvertrag (Tests, Typsignaturen oder erwartete Ein-/Ausgabepaare)49- **Optional**: Einschraenkungen (muss Rueckwaertskompatibilitaet wahren, Performancebudget)5051## Vorgehensweise5253### Schritt 1: Das Quellmaterial analysieren5455Genau verstehen was die Quelle tut bevor eine Transformation versucht wird.56571. Die Quelle vollstaendig lesen — jeden Zweig, Grenzfall und Fehlerpfad582. Den **Verhaltensvertrag** identifizieren:59 - Welche Eingaben akzeptiert sie? (Typen, Bereiche, Grenzfaelle)60 - Welche Ausgaben erzeugt sie? (Rueckgabewerte, Seiteneffekte, Fehlersignale)61 - Welche Invarianten haelt sie aufrecht? (Reihenfolge, Eindeutigkeit, referenzielle Integritaet)623. Abhaengigkeiten katalogisieren: was importiert, ruft auf oder setzt die Quelle voraus?634. Falls Tests existieren, sie lesen um das erwartete Verhalten zu verstehen645. Falls keine Tests existieren, vor dem Transmutieren Verhaltenscharakterisierungstests schreiben6566**Erwartet:** Ein vollstaendiges Verstaendnis dessen was die Quelle tut (nicht wie sie es tut). Der Verhaltensvertrag ist explizit und testbar.6768**Bei Fehler:** Wenn die Quelle zu komplex fuer eine einzelne Transmutation ist, erwaegen sie in kleinere Teile zu zerlegen oder zum vollstaendigen `athanor`-Verfahren zu eskalieren. Bei mehrdeutigem Verhalten um Klaerung bitten statt zu raten.6970### Schritt 2: Quelle auf Zielform abbilden7172Die Transformationsabbildung entwerfen.73741. Fuer jedes Element in der Quelle das Ziel-Aequivalent identifizieren:75 - Sprachkonstrukte: Schleifen -> map/filter, Klassen -> Closures usw.76 - API-Aufrufe: alter Endpunkt -> neuer Endpunkt, Aenderungen der Request-/Response-Struktur77 - Datentypen: DataFrame-Spalten -> Schema-Felder, verschachteltes JSON -> flache Tabellen782. Elemente **ohne direktes Aequivalent** identifizieren:79 - Quellfunktionalitaet die im Ziel fehlt (z.B. Pattern Matching in einer Sprache ohne diese Funktion)80 - Zielidiome die in der Quelle nicht existieren (z.B. R-Vektorisierung vs. Python-Schleifen)813. Fuer jede Luecke eine Anpassungsstrategie waehlen:82 - Emulieren: das Verhalten mit zielseitigen Konstrukten nachbilden83 - Vereinfachen: wenn das Quellkonstrukt ein Workaround war, die native Loesung des Ziels nutzen84 - Dokumentieren: wenn sich das Verhalten leicht aendert, den Unterschied explizit festhalten854. Die **Transformationsabbildung** schreiben: Quellelement -> Zielelement, fuer jedes Stueck8687**Erwartet:** Eine vollstaendige Abbildung in der jedes Quellelement ein Ziel hat. Luecken sind identifiziert und Anpassungsstrategien gewaehlt.8889**Bei Fehler:** Wenn zu viele Elemente kein direktes Aequivalent haben, ist die Transformation moeglicherweise ungeeignet (z.B. Transmutieren eines stark objektorientierten Designs in eine Sprache ohne Klassen). Die Zielform ueberdenken oder zu `athanor` eskalieren.9091### Schritt 3: Die Transformation ausfuehren9293Die Zielform gemaess der Abbildung schreiben.94951. Die Zieldatei(en) mit passender Struktur und Boilerplate erstellen962. Jedes Element gemaess der Abbildung aus Schritt 2 transmutieren:97 - Den Verhaltensvertrag beibehalten — gleiche Eingaben erzeugen gleiche Ausgaben98 - Zielseitige Idiome verwenden statt woertlicher Uebersetzungen99 - Fehlerbehandlung beibehalten oder verbessern1003. Abhaengigkeiten behandeln:101 - Quellabhaengigkeiten durch Ziel-Aequivalente ersetzen102 - Wenn eine Abhaengigkeit kein Aequivalent hat, einen minimalen Adapter implementieren1034. Inline-Kommentare nur dort hinzufuegen wo die Transformation nicht offensichtlich war104105**Erwartet:** Eine vollstaendige Zielimplementierung die der Transformationsabbildung folgt. Der Code liest sich als waere er nativ in der Zielform geschrieben, nicht mechanisch uebersetzt.106107**Bei Fehler:** Wenn ein bestimmtes Element sich der Transformation widersetzt, es isolieren. Alles andere zuerst transformieren, dann das widerspenstige Element mit fokussierter Aufmerksamkeit angehen. Wenn es wirklich nicht transmutiert werden kann, dokumentieren warum und einen Workaround bereitstellen.108109### Schritt 4: Verhaltensaequivalenz verifizieren110111Bestaetigen dass die transmutierte Form das Verhalten des Originals bewahrt.1121131. Die Verhaltensvertragstests gegen die Zielimplementierung ausfuehren1142. Fuer jeden Testfall verifizieren:115 - Gleiche Eingaben -> gleiche Ausgaben (innerhalb akzeptabler Toleranz fuer numerische Konvertierungen)116 - Gleiche Fehlerbedingungen -> aequivalente Fehlersignale117 - Seiteneffekte (falls vorhanden) sind bewahrt oder als geaendert dokumentiert1183. Grenzfaelle explizit pruefen:119 - Null/NA/undefined-Behandlung120 - Leere Sammlungen121 - Grenzwerte (maximaler Integer, leerer String, Arrays der Laenge Null)1224. Wenn die Zielform Faehigkeiten hinzufuegt (z.B. Typsicherheit), diese ebenfalls verifizieren123124**Erwartet:** Alle Verhaltensvertragstests bestehen. Grenzfaelle werden aequivalent behandelt. Alle Verhaltensunterschiede sind dokumentiert und beabsichtigt.125126**Bei Fehler:** Wenn Tests fehlschlagen, die Differenz zwischen Quell- und Zielverhalten finden. Das Ziel an den Quellvertrag anpassen. Wenn die Abweichung beabsichtigt ist (z.B. Beheben eines Fehlers im Original), sie explizit dokumentieren.127128## Validierung129130- [ ] Quellmaterial vollstaendig analysiert mit explizitem Verhaltensvertrag131- [ ] Transformationsabbildung deckt jedes Quellelement ab132- [ ] Luecken identifiziert mit dokumentierten Anpassungsstrategien133- [ ] Zielimplementierung verwendet native Idiome (keine woertliche Uebersetzung)134- [ ] Alle Verhaltensvertragstests bestehen gegen das Ziel135- [ ] Grenzfaelle verifiziert (null, leer, Grenzwerte)136- [ ] Abhaengigkeiten mit Ziel-Aequivalenten aufgeloest137- [ ] Alle Verhaltensunterschiede dokumentiert und beabsichtigt138139## Haeufige Stolperfallen140141- **Woertliche Uebersetzung**: Python-in-R oder Java-in-JavaScript schreiben statt Zielidiome zu verwenden. Das Ergebnis sollte nativ aussehen142- **Verhaltenstests ueberspringen**: Transmutieren ohne Tests bedeutet man kann die Aequivalenz nicht verifizieren. Zuerst Charakterisierungstests schreiben143- **Grenzfaelle ignorieren**: Der Standardpfad transmutiert leicht; in den Grenzfaellen verstecken sich die Fehler144- **Adapter ueberdesignen**: Wenn eine Abhaengigkeit einen 200-Zeilen-Adapter braucht, ist der Transmutationsumfang zu gross145- **Kommentare woertlich uebernehmen**: Kommentare sollten den Zielcode erklaeren, nicht die Quelle widerspiegeln. Sie neu schreiben146147## Verwandte Skills148149- `athanor` — Vollstaendige vierstufige Transformation fuer Systeme die zu gross fuer eine einzelne Transmutation sind150- `chrysopoeia` — Optimierung transmutierten Codes fuer maximale Wertgewinnung151- `review-software-architecture` — Architekturpruefung nach der Transmutation fuer groessere Konvertierungen152- `serialize-data-formats` — Spezialisierte Datenformat-Konvertierungsverfahren