diegogwork1-alt/email-secuencia-leads

E-Mail-Sequenz für Leads · nach Formularausfüllung

Wer ist wer: Der Nutzer ist die Person, die mit dir spricht und freigibt. Das Unternehmen (oder der Kunde) ist die Firma, für die die E-Mails erstellt werden: Es kann das eigene Unternehmen des Nutzers sein oder eines, für das er das Marketing betreibt. Der Lead ist die Person, die das Formular ausgefüllt hat und die E-Mails erhalten wird. In dieser Datei bist du das Modell.

Du bereitest vor; der Nutzer entscheidet und gibt frei. Es gibt drei Stopps, und an jedem hältst du an und wartest. Es gibt keinen Modus „mach einfach weiter“: Wenn der Nutzer darum bittet, sagst du ihm, dass die Skill an jeder E-Mail stoppt, und machst mit dem nächsten Stopp weiter.

Was als OK gilt: „OK“, „freigegeben“, „weiter“, „nächster“ oder „ja“ ohne Änderungswünsche. Jede Antwort mit einer Änderung, einer Frage oder einem „gut, aber…“ ist kein OK: Du wendest die Änderung an, zeigst denselben Stopp erneut und fragst noch einmal.

Sprache. Die E-Mails sind auf Spanisch. Standardmäßig Spanisch aus Spanien und „tuteo“; wenn die Landingpage des Unternehmens eine andere Variante verwendet (spanisches Lateinamerika, „voseo“) oder die „Sie“-Form, wird der Landingpage gefolgt. Dies wird in Stopp 1 bestätigt.

Wo die Skripte sind. Im Ordner dieser Skill, normalerweise ~/.claude/skills/email-secuencia-leads/. Wenn du sie woanders installiert hast (z. B. in .claude/skills/ eines Projekts), ändere diesen Pfad in den Befehlen.

Die drei Regeln

1. Erfinde keine Daten des Unternehmens. Preise, Fristen, Garantien, Fälle, Zahlen, Erfahrungsberichte, Namen und URLs stammen ausschließlich aus dem Briefing, der Landingpage, den Formularantworten und den Materialien, die der Nutzer bereitstellt. Fehlt etwas, schreibst du [FALTA: was] und fragst nach; build_email.py erstellt keine E-Mail mit [FALTA].
2. Wert vor Verkauf und ohne ungelöste Zweifel. Der Lead hat bereits darum gebeten, kontaktiert zu werden. Jede Mehrwert-E-Mail besteht den Test von secuencia.md §2 (was er danach weiß · Aktion für heute · was für den Service noch fehlt). Mindestens 80/20. Außerdem räumt jede E-Mail mindestens einen häufigen Zweifel oder Einwand zum Service aus, mit einer Antwort mit Quelle (secuencia.md §2.1). Dies ist verpflichtend.
3. Quellenhierarchie (secuencia.md §5): Daten des Unternehmens → nur dessen Materialien; Wissen über die Zielgruppe → die Recherche aus Schritt 2, mit Zitat und nur aus autoritativen Quellen für Ratschläge und Zahlen; E-Mail-Praxis → parametros.md; Gesetz und gesunder Menschenverstand (DSGVO, LSSI, Notrufnummern, branchenspezifische Vorschriften) → erlaubt, gekennzeichnet als [Allgemein] und vom Nutzer in Stopp 1 bestätigt. Wenn etwas aus der Recherche mit dem Unternehmen kollidiert, gilt das Unternehmen. Wenn sich Briefing und Landingpage widersprechen, gilt das Briefing und es wird darauf hingewiesen.

Glossar (lies es, bevor du beginnst)

• Datei: eN/ficha.json, der Inhalt einer E-Mail; das Skript wandelt sie in HTML und TXT um.
• eN/: Ordner jeder E-Mail innerhalb der Sequenz: e0/, e1/, e2/, …
• Block: Teil der Vorlage (carta, pasos, cita…), aufgelistet in parametros.md §4.
• Variable: Daten aus dem Formular im Text, [[nombre]] oder [[nombre|fallback]]; in n8n wird daraus {{ $json.nombre }}.
• Sanfter / mittlerer / starker CTA: Frage zum Beantworten oder Link zu etwas zum Lesen / Link im Text zum nächsten Schritt mit dem Unternehmen / Button. Der Button nur in der Einladung, in der Mini-Terminsequenz (außer no-show-2) und in der E0, wenn ein Online-Terminkalender vorhanden ist (vollständige Regel in parametros.md §3).
• Mini-Terminsequenz: cita-confirmacion, cita-recordatorio, no-show und no-show-2; nur wenn ein Online-Terminkalender vorhanden ist.
• Breakup: letzte E-Mail, 2–4 Sätze, endet elegant.
• Copy-Prüfung: obligatorische Überprüfung des Textes vor der Erstellung (ogilvy-email.md §3). Wird in eN/copy-auditoria.md gespeichert.
• fuentes.md: Liste aller verwendeten Daten mit Quelle und Zitat; wird in Stopp 1 erstellt und bei jeder E-Mail erweitert.
• estado.md: Welche E-Mails freigegeben sind und an welchem Stopp du dich befindest; ermöglicht die Wiederaufnahme einer unterbrochenen Sitzung.

Schritt 0 · Was benötigt wird

Normalerweise erhältst du in einer Nachricht das Briefing und die Landingpage. Überprüfe, was du hast:

• Briefing: PDF, Word, in der Nachricht eingefügter Text oder Pfad zu einer Datei. Ein kurzes Briefing in der Nachricht selbst ist ausreichend (was wird verkauft, an wen, Preis oder wovon er abhängt, Prozess, Garantien, wer betreut). Wenn es eine brief.md im Ordner gibt, lies sie.
• Landingpage: Veröffentlichte URL oder HTML-Datei. Wenn du einen Ordner erhältst, suche darin nach index.html oder dist/index.html.
• Optional: wer unterschreibt (Name, Position, E-Mail, Foto), Online-Terminkalender, zusätzliche Materialien (Styleguide, FAQ, Gesprächsprotokolle, Bewertungen), was hervorgehoben oder vermieden werden soll.

Wenn das Briefing oder die Landingpage fehlt, ist deine erste Antwort nur die Bitte um das Fehlende, in einer Zeile:

Um die Sequenz vorzubereiten, fehlt mir [das Briefing des Unternehmens / die Landingpage mit dem Formular]. Sende es mir und ich lege los.

Bitte nicht um Dinge, die du bereits hast. Wenn dir mehrere Materialien übergeben werden, lies sie alle und zitiere sie mit ihrem Namen in der Angebotsdatei.

Schritt 1 · Lesen (ohne Stopp)

Arbeitsordner: emails/secuencia-<AAAA-MM-TT von heute>/ innerhalb des Projektordners (das Datum mit date +%F). Wenn bereits eine Sequenz des Unternehmens mit estado.md existiert, lies sie und nimm dort wieder auf, wo du aufgehört hast, anstatt von vorne zu beginnen.

• Briefing → brief.txt. PDF: Lesen mit pages, oder python3 -c "import fitz,sys;print('\n'.join(p.get_text() for p in fitz.open(sys.argv[1])))" archivo.pdf. Word: textutil -convert txt -stdout archivo.docx auf Mac, oder python3 -c "import docx,sys;print('\n'.join(p.text for p in docx.Document(sys.argv[1]).paragraphs))" archivo.docx. Text aus der Nachricht: wird so gespeichert und die Quelle als „Briefing (Nachricht)“ zitiert.
• Landingpage → python3 ~/.claude/skills/email-secuencia-leads/scripts/leer_landing.py "<URL oder Datei>" --salida <Ordner>/landing und öffne landing/landing.md. Lies native Formulare und solche von Tally (eingebettet oder in Popup-Fenstern). Wenn das Formular von einem anderen Anbieter stammt, bitte den Nutzer um die Fragen und die Kontrollkästchen. Wenn die URL einen Fehler ergibt, bitte um das HTML. Speichere immer eine Kopie des gelesenen HTMLs.
• Öffne parametros.md, secuencia.md, legal-y-envio.md §1 und diseno.md §1–§3 (die KI-Designsignale befinden sich in §1.1).

Schritt 2 · Zielgruppe recherchieren (ohne Stopp)

Befolge references/investigacion-publico.md genau. Kurz zusammengefasst:

1. Definiere die Avatare (Buyer Persona und Prototyp-Lead) anhand des Briefings und der Landingpage.
2. Sammle Quellen: mit der Websuche (WebSearch und WebFetch) oder, wenn NotebookLM verbunden ist, in einem Notizbuch mit den Materialien des Unternehmens.
3. Suche nach der Stimme der Zielgruppe und autoritativem Wissen.
4. Klassifiziere die Quellen.
5. Beantworte die 11 festen Fragen: Gefühle, Interessen, was er/sie über den Service wissen muss, Zweifel, Einwände, Antworten auf jeden, Momente, Aktionen für heute, Mythen, wie man wählt und Grenzen.
6. Schreibe investigacion/publico.md mit den Avataren (A1…), den Erkenntnissen (H1…) und der Tabelle der Zweifel und Einwände (D1…).

Dies dauert etwa 10 Minuten. Während es läuft, teile dem Nutzer in einer Zeile mit, was du tust. Wenn du kein Suchwerkzeug hast, sage es dem Nutzer und bitte um Material vom Experten des Unternehmens (FAQ aus seinen Gesprächen, Bewertungen, Transkripte); ersetze es nicht durch eigenes Wissen.

Stopp 1 · Diagnose und Plan → OK

Erstelle marca.json (Format assets/ejemplo-marca.json, Regeln diseno.md §2), fuentes.md und plan.md. Zeige im Chat in dieser Reihenfolge an:

1. Rechtliches, ganz oben: 🟢 Unabhängiges Kommunikations-Kontrollkästchen, oder 🔴 Abwesend/kombiniert/nicht überprüfbar, mit dem wörtlichen Text der Kontrollkästchen. Wenn 🔴, der genaue Hinweis aus legal-y-envio.md §1: Es wird nur die E0 (und der Termin, falls vorhanden) geliefert; der vollständige Plan wird vorgeschlagen, damit der Nutzer weiß, was kommt, aber die Mehrwert-E-Mails werden nicht verfasst, bis das Kontrollkästchen bestätigt ist. Wenn das Formular sensible Daten erfasst (Art. 9 DSGVO), wird dies hier als [Allgemein] angegeben. Wenn das Unternehmen nicht in Spanien oder der EU ansässig ist, wird mitgeteilt, dass diese Regeln für Spanien und die EU gelten, und dass es die Regeln seines Landes bestätigen muss.
2. Diskretion: Wenn der Avatar das Problem vor seinem Umfeld verbirgt (copy-email.md §5), schlage es vor: Betreff und Preheader ohne das sensible Wort, aber dennoch mitteilen, worum es in der E-Mail geht, und nicht seine Formularantworten wiederholen. Der Körper benennt das Thema. Der Nutzer bestätigt.
3. Angebotsdatenblatt (Tabelle, jedes Datum mit seiner Quelle: „Briefing S. 3“, „Landingpage“, „FAQ Z. 120“, „Briefing (Nachricht)“): Dienstleistung und Versprechen · Avatare (A1…, definiert in Schritt 2) · Unterscheidungsmerkmale · verfügbarer Test (nur der, der existiert und überprüfbar ist) · Prozess · Preis oder wovon er abhängt · nächster tatsächlicher Schritt und seine URL · wer unterschreibt.
4. Formular → Variablen und Versandplattform: Jede Frage mit ihrem Feld ([[campo]]), ihren Optionen und in welcher E-Mail sie verwendet wird (oder „in keiner, aus Diskretion“). Und frage, womit versendet wird: n8n, ActiveCampaign, Brevo, Mailchimp… Dies ist kein Detail für das Ende: Es ändert die gelieferte Datei, die Variablen der Begrüßung und das utm_source von marca.json (legal-y-envio.md §3.1). Wenn das Unternehmen bereits für eine Plattform zahlt, wird von dort aus versendet. Dies mitten in der Sequenz zu erfahren, würde eine Überarbeitung der Links aller E-Mails erzwingen.
5. Art des Angebots (A/B/C/D aus parametros.md §1) und warum, in einem Satz.
6. Was wir über die Zielgruppe gelernt haben (aus investigacion/publico.md):
   • die Avatare (A1…), jeder in einer Zeile;
   • die 5–8 nützlichsten Erkenntnisse (Interessen und was er/sie wissen muss inbegriffen), mit ID, kurzem Zitat und Quellengruppe (AUTORITÄT, ZIELGRUPPE oder KUNDE);
   • die häufigsten Zweifel und Einwände (D1…), mit den Worten des Leads, der Antwort (Hn) oder [FALTA: Antwort des Kunden], und in welcher E-Mail jeder ausgeräumt wird.

Diejenigen, die mit dem Unternehmen kollidieren oder validiert werden müssen, sind markiert. 7. Sequenzplan (Tabelle): E-Mail · Tag · Typ · Situation des Leads (Hn) · Zweifel oder Einwand, den sie ausräumt (Dn → Hn) · Was er/sie danach weiß (Hn) · Aktion für heute (Hn) · Was für den Service noch fehlt · Vorläufiger Betreff · CTA (sanft/mittel/stark und Ziel) · Blöcke. Welche Spalten für jeden E-Mail-Typ obligatorisch sind: secuencia.md §2 und §2.1. Wenn eine obligatorische Spalte leer bleibt, wird diese E-Mail aus einem anderen Blickwinkel angegangen oder entfernt. Die 5 häufigsten Zweifel oder Einwände müssen vor der Einladung abgedeckt sein (bei Typ D werden die, die nicht passen, von der Einladung beantwortet). Die Mini-Terminsequenz wird nur hinzugefügt, wenn ein Online-Terminkalender vorhanden ist. 8. Visuelle Identität: Logo (URL PNG/JPG oder „PNG fehlt“), Akzent, Button, Schriftart für Überschriften, Briefpapier, und ob Überschriften in Großbuchstaben oder Zitate ohne Kursivschrift gemäß dem Styleguide sind. 9. Sprache und Anrede: spanische Variante und „tú“, „vos“ oder „usted“, gemäß der Landingpage. 10. Fehlende Daten, kurze und nummerierte Liste. Hier kommen auch die [Allgemein]-Entscheidungen und die als „mit dem Kunden validieren“ markierten Erkenntnisse, die der Nutzer bestätigen muss.

Ende mit: „Gibst du den Sequenzplan frei? Ich erstelle nichts ohne dein OK.“ Speichere estado.md: „Plan ausstehend auf OK“.

Jede E-Mail, der Reihe nach (E0 → E1 → …)

Stopp 2 · Copy → OK

Bevor du schreibst, lies copy-email.md (insbesondere §0, Klarheit vor Genialität), brodie-email.md und die Überschriften-Checks von ogilvy-email.md §0 (O1-O5). Verfasse mit secuencia.md §3, innerhalb von parametros.md §3–§4. Die wichtigste Regel: Der Betreff und die ersten beiden Sätze machen klar, worum es in der E-Mail geht, und alles wird in einfachen Worten gesagt, ohne Geheimnisse oder Ratespiele. Jedes neue Datum geht in fuentes.md. Führe die Prüfung von ogilvy-email.md §3 durch und speichere sie in eN/copy-auditoria.md.

Zeige an:

• empfohlener Betreff und 2 Alternativen;
• Preheader und Absender;
• der Text jedes Blocks in seiner Reihenfolge, mit den Variablen als [[campo]];
• welcher Zweifel oder Einwand ausgeräumt wird (Dn) und der Satz, der dies tut;
• CTA und Ziel;
• das Layout: die Blöcke in der Reihenfolge (parametros.md §4) und worin es sich von der vorherigen E-Mail unterscheidet;
• die Zusammenfassung der Prüfung.

Frage: „Gibst du den Copy der E-Mail N frei?“

• Wenn die Prüfung nach ihren Versuchen nicht besteht, zeigst du den als _PEND markierten Copy mit dem Grund. Es wird nur mit explizitem OK des Nutzers oder nach Anwendung seiner Änderungen erstellt.
• Wenn die Antwort des Unternehmens auf den Hauptzweifel der E-Mail fehlt ([FALTA: respuesta del cliente]), verfasst du sie nicht. Du teilst es dem Nutzer mit und markierst sie mit seinem OK als „ausstehend auf Antwort“ in estado.md und gehst zur nächsten E-Mail über. Du nimmst sie wieder auf, wenn die Antwort kommt, vor dem Abschluss der Sequenz.

Erstellung und Qualitätskontrolle (ohne Stopp, bis zu 0 Fehlern)

1. eN/ficha.json im Format von assets/ejemplo-ficha.json und mit dem freigegebenen Copy genau so.
2. python3 ~/.claude/skills/email-secuencia-leads/scripts/build_email.py eN/ficha.json eN/email.html. Generiert email.html (für n8n), email.txt und email-muestra.html.
   • Wenn ein HINWEIS erscheint, der eine Änderung des freigegebenen Textes erzwingt (Länge, CTA, Betreff), ändere es nicht eigenmächtig: kehre zu Stopp 2 mit dem vorgeschlagenen Korrektur zurück und bitte erneut um OK. Rein technische Hinweise (Farben, Gewicht) werden in marca.json korrigiert.
3. python3 ~/.claude/skills/email-secuencia-leads/scripts/qa_email.py eN/email.html bis zu 0 Fehlern.
4. python3 ~/.claude/skills/email-secuencia-leads/scripts/render_preview.py eN/email.html (benötigt Google Chrome oder Chromium und Pillow: pip install pillow). Überprüfe mit Read preview-hoja.png, preview-oscuro.png und alle Abschnitte von previews-detalle/. Kriterium: Sieht aus wie ein Brief einer gepflegten Marke, atmet, das Logo ist im Dunkeln lesbar, der Akzent ist dezent, nichts ist auf dem Handy verschoben. Und es sieht nicht aus wie eine KI-Vorlage: Überprüfe die Signale aus diseno.md §1.1 (Vorspann, Serifen-Katalogschrift, erfundene Cremes und Terrakotta, lange Striche, dekorative Nummerierung). Wenn Chrome nicht vorhanden ist, sage es und bitte den Nutzer, email-muestra.html im Browser zu öffnen.

Stopp 3 · E-Mail fertig → OK

Zeige preview-hoja.png an (mit SendUserFile, wenn das Tool existiert; wenn nicht, gib den Pfad an). Gib den Betreff und den Preheader so an, wie sie in der Versandplattform erscheinen (mit Ausdrücken) und die Pfade von email.html und email.txt. Auf dem Mac lege das HTML in die Zwischenablage.