Seam Engineering
Effort: free — pure Reparatur-Disziplin: ein Klassen-Fix am geteilten Primitiv statt N Punkt-Pflastern. Beseitigt: denselben Bug, an jeder Geschwister-Stelle noch einmal repariert, und den vertagten Medium-Befund, der zu dem Rätsel-Bug wird, den in sechs Monaten niemand mehr findet.
Eine Naht (im Code: die Stelle, an der alles zusammenläuft) ist korrekt und
vollständig geschlossen — oder sie ist nicht geschlossen. Der schnelle Patch
von heute ist der Bug, den in sechs Monaten niemand findet. Dieser Skill macht
aus einem Bug-Report eine geschlossene Klasse von Bugs.
Wann einsetzen
Jede Reparatur: ein gemeldeter Bug, ein fehlgeschlagener Test, eine Fundliste
aus Audit oder Bug-Jagd. Besonders dann, wenn du den Drang spürst, „das hier
einfach kurz zu flicken".
Schritte
- Grundursache mit Beweis. Fix die Ursache, nicht das Symptom. Bevor du
den Fix schreibst, zeig den Beleg: eine fehlschlagende Repro, eine
Log-Zeile, ein Trace, der auf die echte Naht zeigt. Ein Fix ohne Beweis ist
eine Vermutung.
- Benenn die Fehler-KLASSE. Frag: welche Familie von Fehler ist das, und
wo könnte derselbe Fehler noch wohnen? Schreib die Klasse in einem Satz auf.
- Fix vertikal — einmal, am geteilten Primitiv. Das geteilte Primitiv ist
die eine Funktion oder das eine Modul, durch das jedes Vorkommen fließt.
Fix es dort. Nie N Punkt-Pflaster. Nie den-schlechten-Fall-markieren-und-
kompensieren.
- Feg horizontal. Such jedes Geschwister-Vorkommen der Klasse und fix sie
in derselben Änderung, nicht „später“.
- Lande eine strukturelle Wache. Ein Test oder automatischer Check, der
bei der NÄCHSTEN Instanz der Klasse fehlschlägt. Die Klasse bleibt zu, weil
etwas sie bewacht — nicht, weil alle dran denken.
- Schließ die ganze Naht. List jeden Fund, den die Jagd hochgebracht hat.
Vor dem Landen ist jeder entweder gefixt und grün, oder er trägt ein
explizites, festgehaltenes „kein Bug“-Urteil mit Beweis. Nie ein stilles
Vertagen. Nie „in einem Doc geparkt“.
Harte Regeln
- Eine Reparatur, die eine neue Fehlerbedingung einbaut, ist selbst ein
Bug. Ein Rollback-Helfer, der crashen kann, ein Aufräumer, der Zustand
strandet, ein Test, umgebogen, um den Defekt zu segnen, den er fangen
sollte — alles Bugs. Entwirf die Änderung neu, als eine atomare Einheit oder
als explizite crash-sichere State-Machine. Nie drüber tapezieren.
- „Die Schweren gefixt; der Rest sind Follow-ups“ reißt den Skill. Genau
diese Gewohnheit soll dieser Skill töten. Ein vertagter mittlerer Bug ist
der Rätsel-Bug von morgen. Jeder Fund auf der Naht zählt gleich.
- „Gut genug zum Landen“ ist kein Status. Ist die Naht nicht richtig,
iterier weiter — Blocker weg, auf ein stärkeres Modell oder einen stärkeren
Reviewer eskalieren, neu versuchen — bis sie es ist.
- Ein Punkt-Pflaster neben einem existierenden geteilten Primitiv reißt den
Skill. Besitzt ein Primitiv die Naht schon, reitet der Fix darauf; ein
Vorbei-Fix erschafft die Klasse neu.
- Ein entschiedenes „kein Bug“ braucht Beweis, keine Abstimmung. Halt
fest, was geprüft wurde und warum der Fund nicht hält.
Passt gut zu
- root-cause-first — die
Untersuchungs-Disziplin hinter Schritt 1.
- red-first — der fehlschlagende Test, der den Fix
beweist, und das Wachen-Muster für Schritt 5.
- sniper-testing — gescopte Tests beim
Iterieren; ein voller Durchlauf beim Landen.
- repair-loop — die End-zu-End-Schleife, in der
diese Disziplin läuft.
- incident-closure — „fix es“ heißt voller
Abschluss, nie ein Optionsmenü.
1---2name: seam-engineering-23description: Beim Reparieren eines Bugs oder beim Abschließen eines Audits oder einer Bug-Jagd. Fixt die Fehler-Klasse einmal an ihrem geteilten Primitiv, fegt jeden Geschwister-Fall mit, landet eine Wache, die die nächste Instanz fängt, und schließt jeden hochgekommenen Fund — kein stilles Vertagen. Trigger words: seam, class fix, whole-seam closure, point patch, structural guard, do it right the first time, Naht, Klassen-Fix, ganze Naht schließen, Punkt-Pflaster, strukturelle Wache, gleich beim ersten Mal richtig.4license: MIT5---67# Seam Engineering8**Effort:** free — pure Reparatur-Disziplin: ein Klassen-Fix am geteilten Primitiv statt N Punkt-Pflastern. Beseitigt: denselben Bug, an jeder Geschwister-Stelle noch einmal repariert, und den vertagten Medium-Befund, der zu dem Rätsel-Bug wird, den in sechs Monaten niemand mehr findet.910Eine Naht (im Code: die Stelle, an der alles zusammenläuft) ist korrekt und11vollständig geschlossen — oder sie ist nicht geschlossen. Der schnelle Patch12von heute ist der Bug, den in sechs Monaten niemand findet. Dieser Skill macht13aus einem Bug-Report eine geschlossene Klasse von Bugs.1415## Wann einsetzen1617Jede Reparatur: ein gemeldeter Bug, ein fehlgeschlagener Test, eine Fundliste18aus Audit oder Bug-Jagd. Besonders dann, wenn du den Drang spürst, „das hier19einfach kurz zu flicken".2021## Schritte22231. **Grundursache mit Beweis.** Fix die Ursache, nicht das Symptom. Bevor du24 den Fix schreibst, zeig den Beleg: eine fehlschlagende Repro, eine25 Log-Zeile, ein Trace, der auf die echte Naht zeigt. Ein Fix ohne Beweis ist26 eine Vermutung.272. **Benenn die Fehler-KLASSE.** Frag: welche Familie von Fehler ist das, und28 wo könnte derselbe Fehler noch wohnen? Schreib die Klasse in einem Satz auf.293. **Fix vertikal — einmal, am geteilten Primitiv.** Das geteilte Primitiv ist30 die eine Funktion oder das eine Modul, durch das jedes Vorkommen fließt.31 Fix es dort. Nie N Punkt-Pflaster. Nie den-schlechten-Fall-markieren-und-32 kompensieren.334. **Feg horizontal.** Such jedes Geschwister-Vorkommen der Klasse und fix sie34 in derselben Änderung, nicht „später“.355. **Lande eine strukturelle Wache.** Ein Test oder automatischer Check, der36 bei der NÄCHSTEN Instanz der Klasse fehlschlägt. Die Klasse bleibt zu, weil37 etwas sie bewacht — nicht, weil alle dran denken.386. **Schließ die ganze Naht.** List jeden Fund, den die Jagd hochgebracht hat.39 Vor dem Landen ist jeder entweder gefixt und grün, oder er trägt ein40 explizites, festgehaltenes „kein Bug“-Urteil mit Beweis. Nie ein stilles41 Vertagen. Nie „in einem Doc geparkt“.4243## Harte Regeln4445- **Eine Reparatur, die eine neue Fehlerbedingung einbaut, ist selbst ein46 Bug.** Ein Rollback-Helfer, der crashen kann, ein Aufräumer, der Zustand47 strandet, ein Test, umgebogen, um den Defekt zu segnen, den er fangen48 sollte — alles Bugs. Entwirf die Änderung neu, als eine atomare Einheit oder49 als explizite crash-sichere State-Machine. Nie drüber tapezieren.50- **„Die Schweren gefixt; der Rest sind Follow-ups“ reißt den Skill.** Genau51 diese Gewohnheit soll dieser Skill töten. Ein vertagter mittlerer Bug ist52 der Rätsel-Bug von morgen. Jeder Fund auf der Naht zählt gleich.53- **„Gut genug zum Landen“ ist kein Status.** Ist die Naht nicht richtig,54 iterier weiter — Blocker weg, auf ein stärkeres Modell oder einen stärkeren55 Reviewer eskalieren, neu versuchen — bis sie es ist.56- **Ein Punkt-Pflaster neben einem existierenden geteilten Primitiv reißt den57 Skill.** Besitzt ein Primitiv die Naht schon, reitet der Fix darauf; ein58 Vorbei-Fix erschafft die Klasse neu.59- **Ein entschiedenes „kein Bug“ braucht Beweis,** keine Abstimmung. Halt60 fest, was geprüft wurde und warum der Fund nicht hält.6162## Passt gut zu6364- [root-cause-first](../root-cause-first/SKILL.md) — die65 Untersuchungs-Disziplin hinter Schritt 1.66- [red-first](../red-first/SKILL.md) — der fehlschlagende Test, der den Fix67 beweist, und das Wachen-Muster für Schritt 5.68- [sniper-testing](../sniper-testing/SKILL.md) — gescopte Tests beim69 Iterieren; ein voller Durchlauf beim Landen.70- [repair-loop](../repair-loop/SKILL.md) — die End-zu-End-Schleife, in der71 diese Disziplin läuft.72- [incident-closure](../incident-closure/SKILL.md) — „fix es“ heißt voller73 Abschluss, nie ein Optionsmenü.