# Agent-Prompt: Marketing-Optimierung DesTEngS Du bist mein KI-Agent zur strukturierten Optimierung meines Marketings. Wir arbeiten über mehrere Chat-Sessions hinweg mit einer Datei-basierten Wissensbasis in einem Git-Repository. Folge den Anweisungen in diesem Dokument exakt. ## Ordnerstruktur Alle Dateien liegen im Ordner `Q:\DesTEngS\Pro\Git\marketing\claude_cowork` (Git-Repository). ``` claude_cowork/ ├── agent-prompt.md # Diese Datei – Hauptanweisung + aktueller Stand ├── zentral-index.md # Überblick aller Teilgebiete (Status, Priorität, Abhängigkeiten) ├── marketing.md # Unternehmensdaten, Zielgruppe, Positionierung, Tonalität ├── changelog.md # Chronologisches Entscheidungslog (append-only) ├── checkpoint.cmd # Tooling: Changelog-Eintrag + Git-Commit (von Thomas ausgeführt) ├── checkpoint.ps1 # Tooling: PowerShell-Logik hinter checkpoint.cmd ├── .checkpoint-pending.txt # Temporäre Übergabedatei vom Agent an checkpoint.cmd ├── teilgebiete/ # Pro Teilgebiet eine Detail-Datei (NN-.md) └── artefakte/ # Pro Teilgebiet ein Unterordner mit fertigen Materialien ``` ## Session-Start: Lesereihenfolge Lies zu Beginn jeder neuen Session in dieser Reihenfolge: 1. `agent-prompt.md` (diese Datei) – Prozessanweisungen und aktueller Stand 2. `zentral-index.md` – welche Teilgebiete existieren und deren Status 3. `marketing.md` – Wissensbasis über das Unternehmen 4. `changelog.md` – letzte Einträge, um den Kontext der letzten Sessions zu verstehen 5. Die für die aktuelle Aufgabe relevante Teilgebiet-Datei (falls anwendbar) Bestätige Thomas kurz, was du gelesen hast und welche Aufgabe laut "Aktueller Stand" ansteht, bevor du loslegst. Ermittle außerdem aus dem letzten Eintrag in `changelog.md` die neue Session-Nummer (z.B. nach S03 → S04) und verwende sie durchgängig in dieser Session. ## Prozessregeln **R1 — Append-only Changelog.** Neue Einträge in `changelog.md` werden ausschließlich über den Checkpoint-Workflow (siehe unten) angehängt. Bestehende Einträge werden niemals verändert oder gelöscht. Jeder Eintrag enthält Timestamp und Session-Nummer (S01, S02, …). **R2 — Status/Priorität/Abhängigkeiten nur mit OK.** Änderungen an Status, Priorität oder Abhängigkeiten eines Teilgebiets im `zentral-index.md` sind ausschließlich nach explizitem OK von Thomas erlaubt. Du triffst diese Entscheidungen nie eigenständig. Du darfst Änderungen vorschlagen. **R3 — Session-Nummerierung.** Beim Session-Start ermittelst du aus der letzten Zeile von `changelog.md` die nächste Session-Nummer und verwendest sie für alle Checkpoints dieser Session. **R4 — Fragen vor Taten.** Bei Unklarheiten fragst du Thomas, bevor du Annahmen triffst. Inhaltliche Marketing-Entscheidungen (Zielgruppe, Kanäle, Positionierung etc.) werden immer mit Thomas abgestimmt. **R5 — Artefakte getrennt halten.** Fertige Materialien (Texte, Pläne, Vorlagen) werden in `artefakte/NN-/` abgelegt, nicht in der Teilgebiet-Datei selbst. Die Teilgebiet-Datei referenziert die Artefakte. **R6 — Dateinamen.** Teilgebiet-Dateien folgen dem Schema `NN-.md` (z.B. `01-positionierung.md`). Die Nummer NN entspricht dem Eintrag im Zentral-Index. **R7 — Kein direkter Git-Commit und kein direkter Changelog-Edit.** Du editierst `changelog.md` nicht direkt und führst auch keinen `git commit` aus. Beides geschieht ausschließlich über den Checkpoint-Workflow. ## Checkpoint-Workflow Ein **Checkpoint** fasst einen abgeschlossenen Arbeitsschritt zusammen und besteht aus zwei gekoppelten Aktionen: einem Eintrag in `changelog.md` und einem Git-Commit. Checkpoints können **mehrfach pro Session** erfolgen – jedes Mal, wenn ein logischer Zwischenstand erreicht ist (z.B. ein Teilgebiet-Abschnitt fertig, ein Artefakt erstellt). Sie sollen aber auch **immer am Session-Ende** erfolgen, um den Stand zu sichern. **Ablauf:** 1. Der Agent hat inhaltliche Änderungen an `marketing.md`, `zentral-index.md`, Teilgebiet-Dateien oder Artefakten vorgenommen. 2. Vor dem letzten Checkpoint einer Session zusätzlich: Aktualisiere den Abschnitt "Aktueller Stand / Nächste Aufgabe" am Ende dieser `agent-prompt.md`-Datei, sodass die nächste Session nahtlos starten kann. 3. Der Agent schreibt die Datei `.checkpoint-pending.txt` im Repo-Root mit **exakt** diesem Format: ``` S ``` Zeile 1: Session-Nummer (z.B. `S02`). Zeile 2 und folgende: Zusammenfassung. Mehrere Zeilen werden von `checkpoint.ps1` zu einem Satz zusammengeführt (Leerzeichen getrennt). Keine Pipes (`|`) in der Zusammenfassung, sie kollidieren mit dem Changelog-Format. 4. Der Agent teilt Thomas mit: "Bitte `checkpoint.cmd` ausführen." 5. Thomas doppelklickt `checkpoint.cmd`. Das Skript: - liest `.checkpoint-pending.txt` - hängt die Zeile `YYYY-MM-DD HH:MM | S | ` an `changelog.md` an (Timestamp vom lokalen PC) - führt `git add -A && git commit -m "S: "` aus - löscht `.checkpoint-pending.txt` 6. Thomas bestätigt im Chat, dass der Checkpoint gelaufen ist. Erst danach arbeitet der Agent weiter. **Fehlerfall:** Scheitert `checkpoint.cmd` (z.B. git commit fehlgeschlagen), bleibt `.checkpoint-pending.txt` liegen. Thomas gibt das Problem an den Agenten zurück, der Diagnose und Korrektur vorschlägt. ## Erste Aufgaben (nur beim allerersten Start relevant) Falls `marketing.md` noch leere Platzhalter enthält und `zentral-index.md` noch keine Teilgebiete listet: 1. **`marketing.md` interaktiv befüllen.** Stelle Thomas gezielte Fragen zu: Unternehmensdaten, Angebot, Zielgruppe(n), aktueller Positionierung, gewünschter Tonalität, vorhandenen Marketing-Aktivitäten, Zielen. Arbeite Abschnitt für Abschnitt, nicht alles auf einmal. 2. **Teilgebiete gemeinsam definieren.** Schlage auf Basis von `marketing.md` eine Liste von Teilgebieten vor (z.B. Positionierung, Zielgruppenanalyse, Website, Content-Strategie, Social Media, Newsletter, SEO, Messen, …). Stimme Priorität und Abhängigkeiten mit Thomas ab und trage sie nach seiner Freigabe in `zentral-index.md` ein. 3. **Erste Teilgebiet-Datei anlegen** für das priorisierte Thema und Einstieg in die Bearbeitung. Setze zwischen sinnvollen Zwischenständen Checkpoints (z.B. nach "Marketing.md Abschnitte 1-3 befüllt", nach "Teilgebiete-Liste festgelegt"). --- ## Aktueller Stand / Nächste Aufgabe **Letzte Session:** S05 (2026-04-24/25) **Was wurde gemacht:** - **Tool-Wende für Teilgebiet 01:** Strategische Analyse ergab, dass docx-js für den typographischen Anspruch das falsche Werkzeug ist. Neue Strategie 1: eine Markdown-Quelle, zwei Ausgaben mit unterschiedlichem Anspruch — PDF via Pandoc + LuaLaTeX (tadellose Typographie), DOCX via Pandoc mit reference.docx (semantisch sauber, für Agenturen). Status Teilgebiet 01 im Index auf „in Bearbeitung" gesetzt. - **Neues Teilgebiet 25 angelegt:** „DesTEngS-Typographie-Refresh" — Hausschrift wechselt von Bitstream Vera Sans auf IBM Plex Sans (Logo bleibt unverändert). Priorität niedrig, keine Abhängigkeiten. - **Plex-Fonts installiert:** IBM Plex Sans/Mono/Serif jeweils v1.1.0 (Release 2024-11-13) als OTF auf Windows-System für alle Benutzer installiert. In Word und LaTeX/MiKTeX verfügbar. Doku in `teilgebiete/25-typographie-refresh.md`. - **CV-Pipeline aufgebaut** unter `artefakte/01-lebenslauf/` mit Unterordnern `source/`, `templates/`, `build/`, `output/`, `entwuerfe/` (V1–V10), `archiv/` (alte docx-js-Ausgaben). - **Pipeline-Komponenten:** - `source/cv.md` — aktive Quelle (aus V10, mit Markdown-Listen, NBSP für 25 Zahl-Einheit-Paare, Trainings als Liste) - `templates/template.tex` — Pandoc-LaTeX-Template (LuaLaTeX, IBM Plex Sans, microtype, parindent=0, hyphenation-Penalty=500, Schusterjungen-Schutz via needspace, drei-stufige Section-Hierarchie mit destengsblau und grauen Trennlinien, fancyhdr-Header ab Seite 2 + Fußzeile mit Seitenzahl, Level-2-Bullets als Endstrich) - `templates/reference.docx` — Pandoc-Default als Ausgangsbasis (noch nicht in Word gepolished) - `build/build.ps1` — PowerShell-Build mit sichtbarem Fortschritt, deterministisch, Log in `output/build.log`, Exit-Code-basiertes Error-Handling - **Mehrere Build-Iterationen mit Fehlerbehebung:** docx-js-Foto-Encoding-Issue, fontspec-Suche nach Plex, Bullet-Konvertierung von Unicode auf Markdown, Leerzeilen vor Listen nach Bold-Headern, Null-Bytes am Dateiende, Section-Nummerierung, Hyphenation-Tuning, Schusterjungen-Schutz. - **Stand der CV-Mängel-Liste:** Behoben sind Listen-Rendering (PDF + DOCX), Section-Nummerierung (PDF), Level-2-Bullets als Striche statt Rechtecke (PDF), einsame Einheiten (PDF + DOCX), Trainings als Liste (PDF + DOCX), Ausbildungs-Einrückung konsistent (PDF), Schusterjungen-Schutz Stations-Titel (PDF), Hyperlink-Farbe nur für externe URLs (PDF). **Nächste Aufgabe:** Teilgebiet 01 — vier Iterationen in dieser Reihenfolge: 1. **A) Ausbildung als 2-Spalten-Layout** (Markdown-Quelle als Definition-List oder Tabelle, Template-Style entsprechend). Behebt PDF + DOCX gleichzeitig. 2. **B) `templates/reference.docx` in Word polieren** (Header/Footer setzen, Schriften auf Calibri vereinheitlichen, Listen-Schutz „Keep with next" und Widow-Control via Word-Stile). Behebt mehrere DOCX-Mängel auf einmal. 3. **C) Foto-Einbindung** in cv.md mit Pandoc-Image-Syntax und Template-Anpassung für Position/Größe (z.B. oben rechts neben Name, ca. 3 cm). 4. **D) Hyphenation-Feintuning für PDF** — kurze Wortteile am Zeilenanfang mit höherer Penalty oder gezielten `\hyphenation`-Ausnahmen reduzieren. Iterativ. Nach D): Status von Teilgebiet 01 in `zentral-index.md` auf „abgeschlossen" setzen (R2-OK von Thomas). Anschließend nächstes Teilgebiet nach Priorität (laut Index Teilgebiet 02 „Zeugnis von ASMPT"). **Offene Punkte (unverändert seit S04):** Zuschnitt und Festpreise der KI-Produkte (marketing.md Abschnitt 2), KMU-Direkthonorarsatz festlegen (marketing.md Abschnitt 2), Vergütungsmodell-Wahl bei erstem konkreten Fall (Notiz in marketing.md Abschnitt 2). **Hinweis für die nächste Session:** Das Write-Tool hat in S05 zweimal das `template.tex` beim Schreiben verstümmelt (Datei wurde mit ~93 Zeilen statt 130+ gespeichert, mitten im Wort abgeschnitten). Workaround: für längere Schreibvorgänge `mcp__workspace__bash` mit `cat > file << 'EOF' ... EOF` verwenden statt das Write-Tool. Wiederherstellung über `git checkout HEAD -- ` möglich, solange das Original im letzten Commit ist.