adrian-altner.com/tasks/lessons.md

Lessons

• Vor dem Abschluss immer den aktuellen Workspace-Stand erneut verifizieren, wenn der Nutzer parallel selbst Änderungen gemacht haben könnte; Zwischenstände nicht als finalen Restzustand formulieren.
• Absichtliche Schutzmechanismen wie Kontakt-Obfuskation nicht entfernen, nur weil eine formell sauberere Lösung möglich erscheint; erst die Nutzerintention prüfen und den Tradeoff zwischen Rechtssicherheit und Spam-Schutz explizit machen.
• Bei englischer Website-Copy keine abstrakten Übergangsformulierungen wie "bringing together" oder zu konzeptionelle Bildsprache verwenden, wenn der Nutzer natürliche, muttersprachliche Formulierungen will; lieber direkte, idiomatische Sätze mit klaren Substantiven und Verben schreiben.
• Wenn der Nutzer für Website-Copy einen konservativen Ton verlangt, Superlative, Selbstinszenierung und stilisierte Attribute weiter reduzieren; kurze, sachliche Selbstbeschreibung bevorzugen.
• Bei englischer Selbstbeschreibung im konservativen Ton self-taught gegenüber formelleren Wörtern wie autodidact bevorzugen, wenn Natürlichkeit wichtiger ist als begriffliche Präzision.
• Bei Selbstbeschreibungen keine Hobbys als primäre Rollen labeln, wenn der Nutzer sie nur freizeitlich betreibt; Hobbys explizit als interests, hobbies oder spare-time activities formulieren.
• Bei kurzer Hero-Copy immer auch den visuellen Umbruch prüfen: zu viele hervorgehobene Wörter, zu enge max-width oder unruhige Parallelkonstruktionen verschlechtern den Lesefluss selbst dann, wenn die Grammatik korrekt ist.
• Bei schlecht formatierten Markdown-Tabellen zuerst die fehlenden prose-Styles im Renderer prüfen und dort beheben; Content nicht mit <br>-Workarounds verbiegen, wenn das eigentliche Problem fehlendes Tabellen-CSS ist.
• Bei Mastodon-Automation keine unnötigen API-Calls mit zusätzlichen Scopes (z. B. verify_credentials) erzwingen; den minimalen Scope-Pfad für den eigentlichen Task bevorzugen, um Token-Fehler zu vermeiden.
• Bei Social-Webmentions nicht nur Quell-URL-Erreichbarkeit prüfen: Interaktions-URLs mit Hash-Signaturen (favorited-by, liked_by) brauchen eine API-basierte Validierung der konkreten Like/Repost-Relation, sonst bleiben gelöschte Reaktionen sichtbar.
• Bei Umbenennung-Tasks (z. B. articles→blog) immer ALLE Vorkommen prüfen: Code, Pfade, Kommentare und Label-Strings in Scripts — nicht nur die offensichtlichen getCollection/URL-Stellen. Danach grep-Verifikation ausführen.
• CLAUDE.md-Konventionen einhalten: Plan in tasks/todo.md schreiben (nicht nur TodoWrite-Tool), nach Nutzerkorrekturen tasks/lessons.md aktualisieren, TodoWrite-Tool nur ergänzend nutzen.