commit 229224a750d40f0dbbb3477396842f9c3e46fafb193f847c22a1e136e102ab22 Author: tlg Date: Fri Jun 12 09:18:58 2026 +0200 Design-Spec für mkt-Umgebung (CRM + KI-Bewerbungen) festhalten Brainstorming-Ergebnis: Verzeichnisstruktur, versioniertes Gedächtnis, zwei Skills (projekt-anlegen, bewerbung-schreiben), Bewerbungs-Register mit Schwerpunkt-Matching und Ordner-Namensschema. .secrets/ via .gitignore vom Repo ausgeschlossen. Co-Authored-By: Claude Opus 4.8 (1M context) diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..21d3a14 --- /dev/null +++ b/.gitignore @@ -0,0 +1,10 @@ +# Geheimnisse – NIEMALS versionieren (enthält CRM-API-Key) +.secrets/ + +# Lokale, nicht zu teilende Claude-Code-Einstellungen +.claude/settings.local.json + +# Betriebssystem / Editor +.DS_Store +*~ +.*.swp diff --git a/docs/superpowers/specs/2026-06-12-mkt-umgebung-design.md b/docs/superpowers/specs/2026-06-12-mkt-umgebung-design.md new file mode 100644 index 0000000..0872685 --- /dev/null +++ b/docs/superpowers/specs/2026-06-12-mkt-umgebung-design.md @@ -0,0 +1,123 @@ +# Design: Claude-Code-Umgebung „mkt" — Projekterfassung & KI-gestützte Bewerbungen + +**Datum:** 2026-06-12 +**Status:** Freigegeben (Brainstorming abgeschlossen) +**Sprache der Umgebung:** Deutsch + +## 1. Zweck + +Eine versionierte Claude-Code-Umgebung im Verzeichnis `/home/tlg/mkt`, die zwei Arbeitsabläufe unterstützt: + +1. **Freiberufler-Projekte bewerten und im CRM (EspoCRM) erfassen** — über einen bestehenden, aus Claude Cowork übernommenen Skill, der hier erweitert und optimiert wird. +2. **Bewerbungen mit KI-Unterstützung schreiben** — mit einem **persistenten Gedächtnis**, das den Schreibstil und bewährte Inhalte über Sessions hinweg lernt, statt dieses Wissen nach jeder Session zu verlieren. + +### Erfolgskriterien +- Skills sind als echte Claude-Code-Skills aufrufbar und mit dem Repo versioniert. +- Das Gedächtnis wächst nachvollziehbar (Git-Historie): Nach einer Bewerbungssession sind die Stil-/Inhaltsentscheidungen samt Begründung festgehalten. +- Frühere Bewerbungen werden nur dann als Vorlage genutzt, wenn ihre Schwerpunkte zum neuen Projekt passen. +- `.secrets/` (CRM-API-Key) bleibt unversioniert und unsynchronisiert. + +## 2. Verzeichnisstruktur + +``` +mkt/ +├── CLAUDE.md # Projekt-Anleitung: Workflows + Gedächtnis-Regeln (lädt automatisch je Session) +├── .gitignore # ignoriert .secrets/ und lokale Artefakte +├── .secrets/ # (existiert) CRM-API-Key — NICHT versioniert, NICHT synchronisiert +│ └── espocrm-api.md +├── .claude/ +│ └── skills/ # echte, versionierte Claude-Code-Skills +│ ├── projekt-anlegen/ +│ │ └── SKILL.md # CRM: Projekt bewerten + im EspoCRM anlegen +│ └── bewerbung-schreiben/ +│ └── SKILL.md # Bewerbungs-Workflow inkl. Gedächtnis-Update +├── vorgaben/ # feste inhaltliche Quellen (read-mostly) +│ ├── lebenslauf.md +│ └── marketing.md +├── bewerbungen/ # entstehende Bewerbungen +│ ├── index.md # zentrale Registertabelle (eine Zeile je Bewerbung) +│ └── YYYY-MM-DD___/ +│ # je Bewerbung ein Ordner: Entwürfe + finale Fassung +├── gedaechtnis/ # versioniertes Gedächtnis +│ ├── stil.md # gelernte Schreibstil-Regeln +│ ├── inhalte.md # bewährte/korrekte inhaltliche Bausteine & Fakten +│ ├── schwerpunkte.md # kontrolliertes Vokabular der Schwerpunkt-Schlagworte +│ └── log.md # Chronik: was wann warum geändert wurde +└── docs/superpowers/specs/ # Design-Dokumente (dieses hier) +``` + +**Begründung Skill-Ort:** Claude Code lädt projektlokale Skills nur aus `.claude/skills//SKILL.md`. Ein beliebiger Ordner wie `skills/` würde nicht erkannt. `.claude/` wird mit ins Repo versioniert; lediglich `.claude/settings.local.json` bleibt lokal (in `.gitignore`). + +## 3. Gedächtnis + +Ein **einziges, im Repo versioniertes Gedächtnis** unter `gedaechtnis/` ist die „Source of Truth". Das eingebaute, nur-lokale Claude-Memory wird **nicht** als Hauptspeicher genutzt, da es nicht synchronisiert würde. + +- **stil.md** — übertragbare Schreibstil-Regeln (Tonalität, Anrede, Satzbau, Floskeln-Vermeidung, Formulierungspräferenzen). +- **inhalte.md** — bewährte, faktisch korrekte inhaltliche Bausteine (z. B. wie bestimmte Erfahrungen formuliert werden, was inhaltlich stimmt/nicht stimmt). +- **schwerpunkte.md** — kontrolliertes Vokabular: Liste erlaubter Schwerpunkt-Schlagworte mit Kurzdefinition, wächst mit der Zeit. Verhindert Tag-Wildwuchs (z. B. „ML" vs. „Machine Learning" vs. „KI"). +- **log.md** — datierte Chronik: was wurde geändert und **warum**. + +### Lebenszyklus je Bewerbungssession +- **Session-Beginn:** `CLAUDE.md` weist an, vor der Arbeit an einer Bewerbung `gedaechtnis/stil.md`, `gedaechtnis/inhalte.md`, `gedaechtnis/schwerpunkte.md` sowie die `vorgaben/` zu lesen. +- **Während der Session:** Iterative Textkorrekturen mit dem Nutzer bis zur Versandreife. +- **Session-Ende (versandreif):** Die übertragbaren Erkenntnisse (was geändert, warum) werden in `stil.md`/`inhalte.md` destilliert, neue Schlagworte ggf. in `schwerpunkte.md` ergänzt, ein datierter Eintrag in `log.md` geschrieben — und committet. + +## 4. Skills + +### 4.1 `projekt-anlegen` (CRM) +Der bestehende Cowork-Skill, hierher übernommen und schrittweise erweitert/optimiert. Bewertet Freiberufler-Projekte (Must-/Nice-to-have-Match) und legt sie als Opportunity im EspoCRM an. Nutzt die Zugangsdaten aus `.secrets/espocrm-api.md` (Base-URL `https://crm.creature-go.com/api/v1`, Header `X-Api-Key`). Relevante Entitäten/Felder sind dort dokumentiert (`Opportunity`, `Contact`, `Account`, `CTag`, Custom-Felder `cLeadQuelle`, `cVerguetungsmodell`, `cVerlustgrund`, `cAccount1*`, `cProjektlink`). + +> Hinweis: Inhalt/Format des bestehenden Skills wird beim Übernehmen geprüft und in den Implementierungsplan eingearbeitet. + +### 4.2 `bewerbung-schreiben` (neu) +Kapselt den wiederholbaren Bewerbungs-Workflow: +1. Gedächtnis + Vorgaben laden. +2. Schwerpunkte des aktuellen Projekts bestimmen (Schlagworte aus `schwerpunkte.md`, ggf. neue ergänzen). +3. In `bewerbungen/index.md` frühere Bewerbungen mit **überlappenden** Schwerpunkten suchen; nur deren **finale Fassung** als Vorlage laden. Kein Treffer → ohne Vorlage schreiben (nur Vorgaben + Gedächtnis). +4. Bewerbungsordner nach Namensschema anlegen, Entwurf erstellen. +5. Mit dem Nutzer iterieren bis versandreif. +6. Finale Fassung ablegen, `index.md` aktualisieren, Gedächtnis aktualisieren (siehe §3), committen. + +## 5. Bewerbungen — Register & Namensschema + +### 5.1 Register `bewerbungen/index.md` +Eine zentrale Tabelle (schnell und vollständig prüfbar), je Bewerbung eine Zeile: + +| Datum | Käufer | Projekttitel | Einsatzort | Schwerpunkte | finale Fassung | Status | +|---|---|---|---|---|---|---| +| 2026-06-10 | Aristo Recruitment | AI Engineer Medical Imaging | Remote | `medical-imaging`, `deep-learning`, `python` | `…/bewerbung.md` | versandt | + +- **Käufer:** Agentur (verkauft die Leistung an den Endkunden weiter) oder bei Direktbeauftragung der Endkunde. +- **Schwerpunkte:** ausschließlich Schlagworte aus `gedaechtnis/schwerpunkte.md`. +- **finale Fassung:** Pfad zur versandreifen Datei im Bewerbungsordner. +- **Status:** z. B. `Entwurf`, `versandreif`, `versandt`. + +### 5.2 Ordnername +Schema: `YYYY-MM-DD___` + +- **Käufer:** Agentur oder Endkunde (s. o.). +- **Projekttitel:** der in der Projektbeschreibung verwendete Titel. +- **Einsatzort:** `Remote`, `Hybrid-` oder ``. + +**Normalisierungsregel** (für dateisystemsichere Namen): Leerzeichen → Bindestrich; Slashes, Klammern und Zusätze wie `(m/w/d)` entfernen; sonstiger Wortlaut bleibt erhalten. + +Beispiel: +``` +2026-06-10_Aristo-Recruitment_AI-Engineer-Medical-Imaging_Remote +``` + +## 6. Git & Synchronisierung + +- Lokales Repo initialisiert (Branch `main`), `.gitignore` schützt `.secrets/`. +- Sobald die Remote-URL des (vom Nutzer angelegten) Repos vorliegt, wird sie als Remote `origin` hinzugefügt und gepusht. +- Jede inhaltliche Änderung (Bewerbung, Gedächtnis-Update, Skill-Änderung) ist ein Commit → nachvollziehbare Historie, auf jedem Rechner verfügbar. + +## 7. Bewusst NICHT enthalten (YAGNI) +- Kein eigenes Datei-pro-Bewerbung-Metaformat zusätzlich zum zentralen Register. +- Keine Nutzung des nur-lokalen Claude-Memory als Hauptgedächtnis. +- Keine Automatisierung des Versands; Bewerbungen werden manuell verschickt. + +## 8. Offene Punkte (vor/in der Implementierung zu klären) +- Bereitstellung der Bestandsdateien: Nutzer legt nach Aufbau der Struktur den Cowork-Skill, `lebenslauf.md` und `marketing.md` an den genannten Orten ab. +- Remote-URL des Git-Servers (Nutzer legt Repo gerade an). +- Format/Inhalt des bestehenden Cowork-Skills wird beim Übernehmen geprüft.