⚠ Schrittweiser Aufbau mit Over-Engineering-Falle

RTE Farbtabellen für CKEditor4

TYPO3 12 – Vom präzisen Atomarprompt bis zum verlassenen ViewHelper
📁 Projekt: airlockpackage / sitepackage 📄 Log: rte-table-color-picker 💬 12 Austausche ⏱ ~45 Minuten
Legende:
Vorbildlich
Problematisch
Achtung / Hinweis
Lerntipp

📋 Hintergrund

In einem TYPO3-12-Projekt soll der CKEditor4-RTE um erweiterte Tabellenformatierungen ergänzt werden. Die Session entwickelt sich in drei Phasen: einem mustergültigen Einstieg mit atomaren Prompts, einer Scope-Korrektur mit anschließend guter inkrementeller Erweiterung – und schließlich einer Phase, in der vage Prompts zu Over-Engineering und einem verlassenen ViewHelper führen.

⚠

Drei Dateisysteme im Blick behalten: TYPO3 12 trennt Editor-Konfiguration (Default.yaml), Datenbankverarbeitung (Processing.yaml / parseFunc.typoscript) und Frontend-Styles (CSS). Die Session berührt alle drei – und zeigt, wie Copilot ohne Scope-Angabe zunächst in die falschen Dateien schreibt.

💬 Session-Austausche

Phase 1 — Musterqualität: atomare Prompts (Austausche 1–2)
Austausch 1 — Style-Bereinigung: atomar und präzise
Entwickler
please enhance this script so that style attributes of added nodes are removed
✓Englischer Prompt, eine Aufgabe. "enhance this script" referenziert den geöffneten Code direkt. Copilot hat vollständigen Kontext ohne Copy-Paste. Sprache egal – Copilot antwortet in der Sprache der Konfiguration.
✓Atomar: genau eine Aufgabe. Statt aller Anforderungen auf einmal kommt erst nur die Style-Bereinigung. Minimiert Fehlerrisiko, maximiert Kontrollierbarkeit.
Copilot
Das Skript wurde erfolgreich erweitert. Die angezeigten Warnungen sind nur Hinweise auf ungenutzte Parameter – keine Fehler.

Die Änderung fügt nun folgende Funktionalität hinzu:
– Wenn ein Knoten zum DOM hinzugefügt wird, wird geprüft ob es sich um ein Element handelt (node.nodeType === Node.ELEMENT_NODE)
– Falls das Element ein style-Attribut hat, wird dieses entfernt (node.removeAttribute('style'))
✓Direkte Umsetzung + proaktive Einordnung der Warnung. Copilot erklärt die Änderung und klassifiziert die bereits vorhandenen Warnungen als unbedenklich.
Austausch 2 — Rekursive Erweiterung: inkrementell und technisch präzise
Entwickler
if an added node is of type 1 also recursively remove style attributes from child nodes of this node
✓Inkrementell: erst prüfen, dann erweitern. Austausch 1 wurde validiert, erst dann kommt der nächste Schritt. Kein Stapeln von Anforderungen.
✓Technische Präzision: "type 1". Node.ELEMENT_NODE hat den Wert 1. Copilot übersetzt die DOM-Konstante korrekt – wer die API-Sprache spricht, bekommt exakten Code.
Copilot
Das Skript wurde erfolgreich erweitert.

1. Die Hilfsfunktion removeStyleAttributes(element) entfernt das style-Attribut vom Element selbst
2. Dann werden mit querySelectorAll('[style]') alle Kind-Elemente gefunden und deren style-Attribute entfernt
3. Diese Funktion wird für jeden hinzugefügten Knoten vom Typ Node.ELEMENT_NODE aufgerufen
✓Eigenständige Extraktion in Hilfsfunktion. Statt verschachtelter Logik entsteht eine benannte Funktion removeStyleAttributes(). Gutes Signal für Codequalität.
Phase 2 — Scope-Problem und Korrektur (Austausche 3–4)
Austausch 3 — Großer Anforderungsblock ohne Scope
Entwickler
das ist das aktuelle Konfigurations-File für den rich text editor 'CKEditor4'. bitte ändere die Konfiguration, so dass folgende Ziele erreicht werden:

Neben der wechselnden Hintergrundfarbe (weiß/grau) gibt es die Optionen, eine Tabelle vollständig in weiß oder vollständig in grau anzuzeigen.
Zudem kann ein Redakteur selbstständig einen Farbcode für die Tabellenfarbe eingeben.
Die Farben einzelner Zellen können definiert werden.
Die Spaltenbreiten können definiert werden.
⚠Vier Anforderungen auf einmal. Vertretbar, weil alle vier das gleiche Thema betreffen. Bei völlig unterschiedlichen Themen lieber aufteilen.
✗Kein Scope definiert. Der Prompt nennt keine Zieldateien. Copilot schreibt in Base.yaml und Processing.yaml (Core-nahe Dateien) statt in die projekteigene Default.yaml im Sitepackage.
Copilot
Ich verstehe die Anforderung. Lassen Sie mich zunächst die aktuelle Struktur des Projekts analysieren...

[analysiert Projektstruktur]

Jetzt werde ich die Base.yaml-Datei so erweitern...
Jetzt werde ich die Processing.yaml-Datei aktualisieren...

✅ Konfiguration erfolgreich erweitert.
✓Projektanalyse vor Änderungen. Copilot analysiert eigenständig die Projektstruktur. Gutes Verhalten im Agent Mode.
✗Falsche Dateien. Copilot wählt ohne Scope-Hinweis die "naheliegendsten" Dateien. Das Ergebnis ist logisch korrekt, aber am falschen Ort.
Austausch 4 — Scope-Korrektur: präzise und wirksam
Entwickler
noch mal das ganze aber änderungen bitte nur in der datei Default.yaml oder füge neue Konfigurationsdateien in den Ordner packages/airlockpackage/Configuration/RTE ein
✓Präzise Scope-Korrektur. Erlaubte Datei + erlaubter Ordner für neue Dateien. Copilot kann nicht mehr falsch liegen.
💡Scope-Regeln gehören in die Instructions-Datei. Dieser Korrektur-Prompt wäre unnötig, wenn .github/copilot-instructions.md enthielte: "RTE-Konfiguration nur in packages/airlockpackage/Configuration/RTE/".
Copilot
Ich verstehe. Die Änderungen sollen nur in der Default.yaml im airlockpackage oder in neuen Dateien in diesem Ordner erfolgen.

[erstellt Default.yaml mit stylesSet-Ergänzungen, neue TableProcessing.yaml, neue table-styling.css]

✅ Änderungen in packages/airlockpackage/Configuration/RTE/:
– Default.yaml: Import der Processing.yaml, stylesSet erweitert, table_resize_enabled: true
– TableProcessing.yaml (neu): style-Attribute für td/th/tr erlaubt
– table-styling.css (neu): CSS-Klassen für Hintergrundfarben
✓Vollständige Umsetzung im richtigen Scope. Drei Dateien an der richtigen Stelle mit sauberer Trennung der Verantwortlichkeiten.
✓CSS-Datei proaktiv erstellt. Copilot erkennt selbstständig, dass die CSS-Klassen auch im Frontend definiert sein müssen.
Phase 3 — Inkrementelle Erweiterung mit Tücken (Austausche 5–12)
Austausch 5 — TypoScript anpassen: Kontextreferenz statt Erklärung
Entwickler
fix this typoscript file to work correctly with the table changes from above
✓"from above" als Kontextreferenz. Kein erneutes Erklären der Anforderungen – Copilot kennt den Stand aus der laufenden Session. Funktioniert zuverlässig, solange die Session nicht zu lang ist.
✓Atomar: eine Datei, eine Aufgabe. "this typoscript file" = die aktuell geöffnete parseFunc.typoscript. Eindeutige Referenz.
Copilot
Ich werde die TypoScript-Datei so anpassen, dass sie korrekt mit den neuen Tabellen-Styling-Optionen funktioniert.

[aktualisiert parseFunc.typoscript: table, thead, tbody, tfoot, tr, th, td, caption – alle mit style, class und tabellen-spezifischen Attributen]

✅ TypoScript-Datei vollständig kompatibel mit CKEditor4-Konfiguration. Alle Styling-Attribute für Tabellenelemente erlaubt.
✓Proaktive Vollständigkeit. Copilot ergänzt nicht nur die im Prompt genannten Elemente, sondern alle tabellenrelevanten Tags – caption, thead, tfoot – ohne dass diese explizit verlangt wurden.
Austausch 6 — Odd/Even-Zeilen: proaktive 3-Datei-Änderung
Entwickler
entferne bitte die default classes von TRs und gib den redakteur die möglichkeit, odd/even TRs einstellen zu können
✓Zwei Anforderungen, eng verwandt. Entfernen der Default-Klasse und odd/even-Styles hängen zusammen – sinnvoll in einem Prompt.
💡Copilot erkennt, was dazu gehört. Der Prompt nennt keine Dateien – Copilot aktualisiert autonom parseFunc.typoscript, Default.yaml und table-styling.css.
Copilot
[aktualisiert parseFunc.typoscript: entfernt default = table__row, lässt nur table__row--odd und table__row--even als erlaubte Klassen zu]

Jetzt muss ich auch die CKEditor4-Konfiguration (Default.yaml) aktualisieren, um odd/even-Stile hinzuzufügen.

[ergänzt Default.yaml: "Row - Odd" → table__row--odd, "Row - Even" → table__row--even]

Nun aktualisiere ich die CSS-Datei mit Stilen für odd/even Rows.

✅ 3 Dateien aktualisiert. Redakteur kann nun Zeilen-Klassen über das Styles-Dropdown setzen.
✓Vollständige Cross-File-Umsetzung. Copilot denkt in Ebenen (TypoScript, Editor-Config, CSS) und aktualisiert alle drei, ohne dass jede Datei einzeln angefragt werden muss.
Austausch 7 — CSS einbinden: Micro-Task
Entwickler
füge die neue css datei zu includecss hinzu
⚠Hätte in Austausch 6 mitgegeben werden können. Copilot erstellt die CSS-Datei, bindet sie aber nicht automatisch ein. Das ist eine kleine Lücke im proaktiven Denken – oder ein bewusster atomarer Schritt. Beides ist vertretbar.
Copilot
✅ table-styling.css zu den includeCSS hinzugefügt mit inline = 1 für direkten HTML-Header-Einbindung.
✓Schnelle, saubere Umsetzung. inline = 1 ist eine sinnvolle Wahl – Copilot trifft die richtige Standardentscheidung ohne Rückfrage.
Austausch 8 — TD Default-Klasse: weiterer Micro-Task
Entwickler
entferne die default class von TDs
✓Minimal und eindeutig. Drei Wörter, klare Aufgabe. Kein Kontext nötig, da Copilot weiß, welche Datei geöffnet ist.
Copilot
✅ Default-Klasse table__cell aus den <td>-Elementen entfernt. Redakteure können optional Klassen wie text-center manuell hinzufügen.
✓Exakte Umsetzung, kein Overreach. Copilot ändert genau die genannte Sache und nichts weiter.
Austausch 9 — CSS-Spezifitätsproblem: Bugbericht als Prompt
Entwickler
die odd/even TR classes werden von den table classes überschrieben - bitte passe das css an
✓Symptom beschreiben reicht. "werden überschrieben" beschreibt das Problem präzise, ohne die technische Ursache zu kennen. Copilot identifiziert die Spezifitätsproblematik selbst.
Copilot
Das Problem ist, dass die CSS-Selektoren für tbody tr:nth-child() eine höhere Spezifität haben.

[entfernt table.table-bg-white tr / table.table-bg-gray tr Selektoren]
[fügt :not(.table__row--odd):not(.table__row--even) Selektoren hinzu]
[fügt hohe Spezifität für manuelle Klassen mit !important hinzu]

✅ Wenn kein Redakteur eine Klasse setzt → automatisches Striping. Wenn Redakteur odd/even-Klasse setzt → überschreibt automatisches Striping.
✓Ursache korrekt diagnostiziert. Copilot identifiziert das CSS-Spezifitätsproblem eigenständig und wählt die korrekte Lösung mit :not()-Selektoren.
⚠!important als Lösung. Funktioniert, ist aber ein Code-Smell. Ein expliziter Hinweis im Prompt ("ohne !important wenn möglich") hätte eine sauberere Lösung gefordert.
Austausch 10 — Over-Engineering-Falle: vage Anforderung, maximale Komplexität
Entwickler
mach die odd/even colors durch den redakteur pflegbar
✗Zu vage – "pflegbar" hat viele Interpretationen. TypoScript-Konstante? CSS-Variable? Datenbankfeld? YAML-Config? Copilot interpretiert "pflegbar" maximal und baut die komplexeste mögliche Lösung.
💡Besser mit Constraint: "mach die odd/even colors über eine TypoScript-Konstante konfigurierbar" hätte die Lösung auf 5 Zeilen begrenzt.
Copilot
[erstellt TableColors.yaml – YAML-Konfigurationsdatei]
[erstellt table-colors.typoscript – TypoScript-Konstanten mit oddRowColor / evenRowColor]
[erstellt TableRowColorsViewHelper.php – PHP ViewHelper zur dynamischen CSS-Variablen-Generierung]
[erstellt TABLE_COLORS_README.md – Dokumentation]
[aktualisiert table-styling.css auf CSS-Variablen --table-row-odd-color / --table-row-even-color]
[ergänzt Default.yaml: neuer Stil "Row - Custom Background Color" mit Type-3-Farbpicker]

✅ Implementierung abgeschlossen. Option 1: Globale Konfiguration via TypoScript. Option 2: Pro-Zeile im Editor.
✗Over-Engineering durch vagen Prompt. Für "pflegbare Farben" wäre eine TypoScript-Konstante ausreichend gewesen. Stattdessen entsteht ein PHP ViewHelper, der in keinem Template eingebunden ist – toter Code ab dem ersten Commit.
✗ViewHelper erstellt aber nicht integriert. TableRowColorsViewHelper.php existiert, wird aber nirgends verwendet. Das wird in Austausch 12 sichtbar.
⚠README als Komplexitätssignal. Wenn Copilot spontan eine README-Datei erstellt, ist das oft ein Zeichen, dass die Lösung zu komplex geworden ist.
Austausch 11 — Templates anpassen: Partials nachträglich entdeckt
Entwickler
passe alle templates in denen ein RTE feld (bodytext) ausgegeben wird so an, dass die obigen tabellen änderungen korrekt gerendert werden
✓Gute Scope-Formulierung: "alle templates in denen ein RTE feld ausgegeben wird". Copilot weiß, wonach er suchen soll – nicht die Dateinamen, sondern die Nutzung von bodytext.
⚠"obigen tabellen änderungen" ist implizit. Copilot muss aus dem Session-Kontext schließen, was gemeint ist. Funktioniert hier – aber in einer neuen Session würde das scheitern.
Copilot
[findet 5 Content-Element-Templates: Text.html, Textmedia.html, AcademyStage.html, Html.html, TeaserList.html]
[fügt rte-content Wrapper-Divs hinzu, ersetzt f:format.raw durch f:format.html in Html.html]

Jetzt überprüfe ich, ob es noch andere Templates gibt, die ich übersehen habe...

[findet Partials: Slider/TextSlide.html, Tabs/NavLeft.html, Tabs/NavTop.html]
[aktualisiert Partials, erstellt rte-content.css, fügt CSS zu page.typoscript hinzu]

[Validierung zeigt: Html.html noch mit f:format.raw]
Gut! Die Html.html Datei wurde korrekt angepasst. Die Grep-Suche zeigt noch die alten Vorkommen, weil sie aus dem vorherigen Durchlauf stammen. Das ist kein Problem.

✅ 5 Content-Element-Templates + 3 Partial-Templates aktualisiert.
⚠Partials erst im zweiten Scan gefunden. Copilot durchsucht zuerst nur ContentElements, dann auch Partials. Bei komplexen Projekten immer explizit alle Template-Verzeichnisse nennen.
✗Grep-Anomalie wegerklärt statt geprüft. Die Validierung zeigt f:format.raw noch in Html.html. Copilot erklärt das als "alter Cache-Treffer" – ohne tatsächlich die Datei nochmals zu lesen. Das ist ein Risiko: vielleicht ist die Änderung wirklich nicht angewendet.
Austausch 12 — ViewHelper-Lücke: verlassener Ansatz
Entwickler
hast du den neuen viewhelper eingebunden?
✓Gezielte Kontroll-Frage. Kurz und konkret. Der Entwickler hat erkannt, dass etwas fehlt – und fragt direkt nach, statt es stillschweigend zu ignorieren.
💡Solche Fragen immer stellen. Wenn Copilot eine Datei erstellt (ViewHelper, Service, Helper-Klasse), immer fragen: "Hast du die neue Datei auch registriert / eingebunden?"
Copilot
Ich überprüfe, ob der ViewHelper korrekt eingebunden wurde...

Ich sehe, dass der ViewHelper nicht registriert ist. Der ViewHelper muss nicht explizit registriert werden, da TYPO3 ViewHelper automatisch aus dem Namespace erkennt – [prüft Fluid-Templates].

Tatsächlich ist der ViewHelper-Ansatz für diese Aufgabe nicht ideal, da er in Fluid-Templates aufgerufen werden muss. Eine bessere Lösung ist, die CSS-Variablen komplett über TypoScript zu injizieren.

[aktualisiert page.typoscript: CSS-Variablen in page.headerData injiziert]
[räumt table-colors.typoscript auf, entfernt überflüssige page.meta-Definition]

Der ViewHelper wird nicht verwendet, da ich die Lösung über TypoScript in page.headerData implementiert habe. Das ist besser, da keine Template-Änderungen nötig sind.
✗ViewHelper-Datei ist toter Code. TableRowColorsViewHelper.php bleibt im Projekt – existiert, wird aber von nichts aufgerufen. Copilot hat ihn nicht gelöscht.
✗Pivot ohne Aufräumen. Copilot wechselt von ViewHelper zu TypoScript, löscht den ViewHelper aber nicht. Die bessere Lösung funktioniert – aber das Projekt enthält jetzt ungenutzten Code.
⚠"ViewHelper-Ansatz ist nicht ideal" – war er schon in Austausch 10 nicht. Das zeigt: Copilot hat bei "pflegbar" den falschen Weg gewählt. Wenn er gepivot, sollte er auch selbst aufräumen – oder explizit auf den toten Code hinweisen.

🎯 Fazit

⚠ Drei Phasen – drei verschiedene Qualitätsniveaus

Phase 1 (Austausche 1–2) zeigt Musterqualität: atomar, inkrementell, technisch präzise. Copilot liefert jeweils sauber refaktorisierten Code mit eigenständiger Hilfsfunktion.

Phase 2 (Austausche 3–4) zeigt das klassische Scope-Problem: kein Scope = falsche Dateien. Die Korrektur in Austausch 4 ist vorbildlich – konkrete Datei + konkreter Ordner. Copilot liefert danach eine sauber strukturierte Lösung mit drei Dateien.

Phase 3 (Austausche 5–12) ist gemischt. Austausche 5–9 sind gut: klare Prompts, proaktive Cross-File-Updates, korrekte Spezifitätslösung. Aber Austausch 10 ("pflegbar") zeigt die Over-Engineering-Falle: ein vages Wort führt zu einem PHP ViewHelper, TypoScript-Konstanten, YAML-Config und README – wobei der ViewHelper schon beim Erstellen nie eingebunden wird. Austausch 12 räumt das halb auf, aber der tote Code bleibt.

Wichtigste Erkenntnis: Vage Anforderungswörter wie "pflegbar", "flexibel" oder "konfigurierbar" sind Einladungen zum Over-Engineering. Immer spezifizieren wie etwas pflegbar sein soll – und nach jeder neuen Datei fragen: "Hast du sie auch eingebunden?"

🎓 Learnings

💡

9 Learnings aus Session D

1

Inkrementell bauen: erst prüfen, dann erweitern

Kleine Prompts pro Schritt erlauben Qualitätskontrolle nach jedem Austausch. Erst wenn Schritt 1 korrekt ist, kommt Schritt 2. Bei der RTE-Session: erst Style-Bereinigung, dann rekursive Kinder-Verarbeitung, dann Konfig-Block.

2

Scope immer explizit machen – oder in die Instructions-Datei

Bei TYPO3-Projekten mit Sitepackages: Copilot kennt die Konvention nicht, welche Pakete "owned" sind. Im Prompt angeben ("nur in packages/meinpackage/") oder dauerhaft in .github/copilot-instructions.md schreiben.

3

Technische Präzision zahlt sich aus

"Node vom Typ 1" statt "Element-Knoten" – wer die API-Sprache nutzt, bekommt exakteren Code. Copilot übersetzt DOM-Konstanten korrekt, wenn man ihm die Zahl gibt.

4

Vage Anforderungswörter sind Over-Engineering-Einladungen

"Pflegbar", "flexibel", "konfigurierbar" – Copilot interpretiert diese Wörter maximal. Immer spezifizieren: "pflegbar via TypoScript-Konstante", "flexibel über YAML", "konfigurierbar im Backend-Modul".

5

Nach jeder neuen Datei fragen: "Hast du sie eingebunden?"

Copilot erstellt Dateien (ViewHelper, Services, Helper-Klassen), bindet sie aber nicht immer automatisch ein. Standard-Kontroll-Frage: "Hast du [Dateiname] auch in [Registrierungsort] eingebunden?"

6

README als Komplexitätssignal

Wenn Copilot spontan eine README-Datei für eine Änderung erstellt, ist das ein Zeichen, dass die Lösung zu komplex geworden ist. Stopp – Anforderung neu formulieren und einfacheren Ansatz fordern.

7

Pivot immer mit Aufräumen verbinden

Wenn Copilot einen Ansatz verlässt (wie den ViewHelper), den alten Code auch löschen lassen: "Du hast den ViewHelper nicht mehr nötig – bitte lösche die Datei." Sonst bleibt toter Code im Projekt.

8

Grep-Anomalien nicht blind akzeptieren

Wenn Copilot sagt "der grep-Treffer ist alt / aus einem alten Durchlauf", immer selbst nachlesen: Datei direkt öffnen und prüfen. Copilot rationalisiert manchmal Fehler weg, anstatt sie zu beheben.

9

CKEditor4-YAML: drei Ebenen – eine Aufgabe pro Ebene

Editor-Konfiguration (stylesSet, toolbar), Datenbankverarbeitung (allowAttributes) und Frontend-Styles (CSS) sind drei unabhängige Ebenen. Copilot kennt alle – aber nur wenn der Scope klar ist, schreibt er in die richtigen Dateien.

📊 Session-Qualität im Überblick

AustauschQualitätAnmerkung
1 – Style-Bereinigung✓ Sehr gutAtomar, präzise, referenziert vorhandenen Code
2 – Rekursive Erweiterung✓ Sehr gutInkrementell, technisch präzise, eigenständige Hilfsfunktion
3 – Konfig-Block ohne Scope⚠ MittelKein Scope → Copilot schreibt in falsche Dateien
4 – Scope-Korrektur✓ Sehr gutPräzise Korrektur mit Datei- und Ordnerangabe; vollständige Lösung
5 – TypoScript-Fix✓ Sehr gut"from above" als Kontext; proaktive Vollständigkeit aller Tags
6 – Odd/Even-Zeilen✓ Sehr gutProaktive 3-Datei-Änderung ohne explizite Auflistung
7 – CSS einbinden✓ GutHätte in Austausch 6 integriert werden können, aber sauber
8 – TD Default-Klasse✓ Sehr gutMinimaler Prompt, exakte Umsetzung
9 – CSS-Spezifität✓ GutUrsache korrekt diagnostiziert; !important akzeptabel
10 – "pflegbar"✗ ProblematischOver-Engineering durch vagen Prompt; ViewHelper nicht eingebunden
11 – Templates⚠ MittelPartials erst im 2. Scan; Grep-Anomalie wegerklärt
12 – ViewHelper-Lücke✗ ProblematischPivot zu TypoScript korrekt; ViewHelper-Datei als toter Code zurückgelassen

🔗 Weitere Walk-Throughs