# bewerb-Umgebung Implementierungsplan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Eine versionierte Claude-Code-Umgebung unter `/home/tlg/mkt/bewerb` aufbauen, die Freiberufler-Projekte im EspoCRM erfasst und KI-gestützte Bewerbungen mit persistentem Gedächtnis schreibt.

**Architecture:** Reine Struktur-/Inhaltsumgebung: Verzeichnisbaum + Markdown-Dateien + zwei Claude-Code-Skills. Das Gedächtnis liegt versioniert in `gedaechtnis/`. Kein Code/Build, daher ersetzen konkrete Verifikationsschritte (Datei-, Git- und Skill-Erkennbarkeitsprüfungen) klassische Tests. Zwei Tasks sind Übergabepunkte, an denen der Nutzer Bestandsdateien beisteuert.

**Tech Stack:** Git (sha256, Remote auf DesTEngS-Gitea), Markdown, Claude-Code-Skills (`.claude/skills/<name>/SKILL.md`), EspoCRM REST-API (Zugang in `.secrets/espocrm-api.md`).

**Referenz-Spec:** `docs/superpowers/specs/2026-06-12-bewerb-umgebung-design.md`

---

## Dateistruktur (Überblick)

Neu anzulegen in diesem Plan:

```
bewerb/
├── CLAUDE.md                                  # Task 2
├── vorgaben/.gitkeep                          # Task 1 (Inhalt vom Nutzer: Task 5)
├── bewerbungen/index.md                       # Task 1
├── gedaechtnis/stil.md                        # Task 1
├── gedaechtnis/inhalte.md                     # Task 1
├── gedaechtnis/schwerpunkte.md                # Task 1
├── gedaechtnis/log.md                         # Task 1
├── .claude/skills/bewerbung-schreiben/SKILL.md  # Task 3
└── .claude/skills/projekt-anlegen/SKILL.md    # Task 5 (Inhalt vom Nutzer)
```

Bereits vorhanden: `.git/`, `.gitignore`, `.secrets/espocrm-api.md`, `.claude/settings.local.json`, die beiden Doku-Dateien unter `docs/superpowers/`.

Alle Befehle gehen davon aus, dass das Arbeitsverzeichnis `/home/tlg/mkt/bewerb` ist.

---

## Task 1: Verzeichnisgerüst + Gedächtnis-Seeds + Register

**Files:**
- Create: `vorgaben/.gitkeep`
- Create: `bewerbungen/index.md`
- Create: `gedaechtnis/stil.md`
- Create: `gedaechtnis/inhalte.md`
- Create: `gedaechtnis/schwerpunkte.md`
- Create: `gedaechtnis/log.md`

- [ ] **Step 1: Verzeichnisse anlegen**

```bash
mkdir -p vorgaben bewerbungen gedaechtnis .claude/skills/bewerbung-schreiben .claude/skills/projekt-anlegen
touch vorgaben/.gitkeep
```

- [ ] **Step 2: `bewerbungen/index.md` schreiben**

```markdown
# Bewerbungs-Register

Eine Zeile je Bewerbung. **Schwerpunkte** ausschließlich aus
`gedaechtnis/schwerpunkte.md` verwenden. Beim Schreiben einer neuen Bewerbung
hier nach überlappenden Schwerpunkten suchen und nur die **finale Fassung**
passender Einträge als Vorlage nutzen.

| Datum | Käufer | Projekttitel | Einsatzort | Schwerpunkte | finale Fassung | Status |
|---|---|---|---|---|---|---|
```

- [ ] **Step 3: `gedaechtnis/schwerpunkte.md` schreiben**

```markdown
# Schwerpunkte (kontrolliertes Vokabular)

Erlaubte Schlagworte zur Klassifikation von Projekten und Bewerbungen.
Beim Schreiben einer Bewerbung **nur** Schlagworte aus dieser Liste verwenden.
Fehlt ein passendes Schlagwort, hier ergänzen (mit Kurzdefinition) und im
Commit begründen. Ziel: gleiche Schwerpunkte immer gleich benennen
(kein „ML" vs. „Machine Learning" vs. „KI").

| Schlagwort | Definition |
|---|---|
| _(wächst mit der Zeit)_ | |
```

- [ ] **Step 4: `gedaechtnis/stil.md` schreiben**

```markdown
# Schreibstil (gelernt)

Übertragbare Regeln für Bewerbungstexte. Wird am Ende jeder Bewerbungssession
aktualisiert. Nur **übertragbares** Wissen, keine projektspezifischen Einmaligkeiten.

## Tonalität
_(noch keine Einträge)_

## Anrede & Form
_(noch keine Einträge)_

## Formulierungen – bevorzugt
_(noch keine Einträge)_

## Formulierungen – vermeiden
_(noch keine Einträge)_
```

- [ ] **Step 5: `gedaechtnis/inhalte.md` schreiben**

```markdown
# Inhaltliche Bausteine (geprüft)

Bewährte, faktisch korrekte Inhalte und Formulierungen zu Erfahrungen/Skills.
Was hier steht, ist verifiziert richtig. Wird am Ende jeder Session aktualisiert.

## Korrekte Fakten
_(noch keine Einträge)_

## Bewährte Bausteine
_(noch keine Einträge)_

## Nicht zutreffend / nicht behaupten
_(noch keine Einträge)_
```

- [ ] **Step 6: `gedaechtnis/log.md` schreiben**

```markdown
# Gedächtnis-Chronik

Datierte Einträge: was wurde am Gedächtnis geändert und **warum**.

## 2026-06-12 — Initialisierung
- Gedächtnisstruktur angelegt (`stil.md`, `inhalte.md`, `schwerpunkte.md`, `log.md`)
  und Register `bewerbungen/index.md`. Noch keine inhaltlichen Lerneinträge.
```

- [ ] **Step 7: Verifizieren**

Run: `ls -1 vorgaben/.gitkeep bewerbungen/index.md gedaechtnis/*.md && echo OK`
Expected: alle sechs Pfade werden gelistet, danach `OK`.

- [ ] **Step 8: Commit**

```bash
git add vorgaben/.gitkeep bewerbungen/index.md gedaechtnis/
git commit -m "Verzeichnisgerüst, Gedächtnis-Seeds und Bewerbungs-Register anlegen"
```

---

## Task 2: `CLAUDE.md` (operative Projekt-Anleitung)

**Files:**
- Create: `CLAUDE.md`

- [ ] **Step 1: `CLAUDE.md` schreiben**

```markdown
# bewerb — Projekt-Anleitung

Diese Umgebung unterstützt zwei Arbeitsabläufe:
1. **Freiberufler-Projekte bewerten und im EspoCRM erfassen** → Skill `projekt-anlegen`.
2. **Bewerbungen mit KI-Unterstützung schreiben** → Skill `bewerbung-schreiben`.

Sprache: **Deutsch** (Texte, Gedächtnis, Commits).

## Verzeichnisse
- `vorgaben/` — feste Quellen: `lebenslauf.md`, `marketing.md`. Referenz; nicht ohne Auftrag ändern.
- `bewerbungen/` — je Bewerbung ein Ordner; `bewerbungen/index.md` ist das zentrale Register.
- `gedaechtnis/` — versioniertes Gedächtnis: `stil.md`, `inhalte.md`, `schwerpunkte.md`, `log.md`.
- `.claude/skills/` — die beiden Skills.
- `.secrets/espocrm-api.md` — CRM-Zugang (NICHT versioniert, NICHT teilen, nur bei konkretem CRM-Auftrag lesen).

## Gedächtnis-Regeln (verbindlich)
**Vor** Arbeit an einer Bewerbung lesen: `gedaechtnis/stil.md`, `gedaechtnis/inhalte.md`,
`gedaechtnis/schwerpunkte.md` sowie `vorgaben/lebenslauf.md` und `vorgaben/marketing.md`.

**Am Ende** einer Bewerbungssession (Text versandreif):
1. Übertragbare Stil-Erkenntnisse → `gedaechtnis/stil.md`
2. Geprüfte inhaltliche Fakten/Bausteine → `gedaechtnis/inhalte.md`
3. Neue Schwerpunkt-Schlagworte → `gedaechtnis/schwerpunkte.md`
4. Datierter Eintrag (was/warum) → `gedaechtnis/log.md`
5. Register `bewerbungen/index.md` aktualisieren
6. Alles committen (und pushen)

Nur **übertragbares** Wissen ins Gedächtnis — keine projektspezifischen Einmaligkeiten.

## Git
- Branch `main`, Remote `origin` (DesTEngS-Gitea, `ssh://git@git.destengs.com:8085/tlg/bewerb.git`, Objektformat sha256).
- Inhaltliche Änderungen committen; `.secrets/` bleibt durch `.gitignore` ausgeschlossen.
```

- [ ] **Step 2: Verifizieren**

Run: `test -f CLAUDE.md && grep -q "Gedächtnis-Regeln" CLAUDE.md && echo OK`
Expected: `OK`

- [ ] **Step 3: Commit**

```bash
git add CLAUDE.md
git commit -m "CLAUDE.md mit Workflow- und Gedächtnis-Regeln anlegen"
```

---

## Task 3: Skill `bewerbung-schreiben`

**Files:**
- Create: `.claude/skills/bewerbung-schreiben/SKILL.md`

- [ ] **Step 1: `SKILL.md` schreiben**

```markdown
---
name: bewerbung-schreiben
description: Use when writing or revising a job application (Bewerbung/Anschreiben) for a freelance project. Loads CV, marketing, style memory and matching past applications, drafts and iterates the text with the user, then updates the memory. Trigger on "Bewerbung schreiben", "Anschreiben", "bewirb mich".
---

# Bewerbung schreiben

Wiederholbarer Workflow für eine KI-gestützte Bewerbung mit Gedächtnis.

## 1. Kontext laden
Lies zwingend:
- `vorgaben/lebenslauf.md`, `vorgaben/marketing.md`
- `gedaechtnis/stil.md`, `gedaechtnis/inhalte.md`, `gedaechtnis/schwerpunkte.md`

## 2. Schwerpunkte bestimmen
Bestimme die Schwerpunkte des aktuellen Projekts als Schlagworte aus
`gedaechtnis/schwerpunkte.md`. Fehlt ein passendes Schlagwort, ergänze es dort
mit Kurzdefinition (und begründe es später im Commit).

## 3. Vorlage wählen (Matching)
Öffne `bewerbungen/index.md`. Suche Zeilen mit **überlappenden** Schwerpunkten.
Nutze nur die **finale Fassung** passender Einträge als Vorlage. Kein Treffer →
ohne Vorlage schreiben (nur Vorgaben + Gedächtnis).

## 4. Ordner anlegen
Schema: `bewerbungen/YYYY-MM-DD_<Käufer>_<Projekttitel>_<Einsatzort>/`
- **Käufer:** Agentur (verkauft die Leistung weiter) oder bei Direktbeauftragung der Endkunde.
- **Projekttitel:** Titel aus der Projektbeschreibung.
- **Einsatzort:** `Remote`, `Hybrid-<Stadt>` oder `<Stadt>`.
- **Normalisierung:** 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`

Lege darin den Entwurf `entwurf.md` an.

## 5. Iterieren
Schreibe gemäß Stil-Gedächtnis und Vorgaben. Iteriere mit dem Nutzer bis
versandreif. Speichere die finale Fassung als `bewerbung.md` im Ordner.

## 6. Gedächtnis aktualisieren (Session-Ende)
- Stil-Erkenntnisse → `gedaechtnis/stil.md`
- geprüfte Inhalte → `gedaechtnis/inhalte.md`
- neue Schlagworte → `gedaechtnis/schwerpunkte.md`
- datierter Eintrag (was/warum) → `gedaechtnis/log.md`
- neue Zeile → `bewerbungen/index.md` (Datum, Käufer, Projekttitel, Einsatzort,
  Schwerpunkte, finale Fassung, Status)
- committen (und pushen)
```

- [ ] **Step 2: Verifizieren, dass die Skill-Datei valide Frontmatter hat**

Run: `head -4 .claude/skills/bewerbung-schreiben/SKILL.md`
Expected: erste Zeile `---`, dann `name: bewerbung-schreiben`, eine `description:`-Zeile, dann `---`.

- [ ] **Step 3: Verifizieren, dass Claude Code den Skill erkennt**

In einer Claude-Code-Session aus `/home/tlg/mkt/bewerb`: prüfen, ob `bewerbung-schreiben` in der Liste verfügbarer Skills erscheint (bzw. `/bewerbung-schreiben` aufrufbar ist).
Expected: Skill ist gelistet/aufrufbar. (Hinweis: ggf. ist ein Neustart der Session nötig, damit neue Projekt-Skills geladen werden.)

- [ ] **Step 4: Commit**

```bash
git add .claude/skills/bewerbung-schreiben/SKILL.md
git commit -m "Skill bewerbung-schreiben anlegen (Workflow inkl. Gedächtnis-Update)"
```

---

## Task 4: Übergabe — Vorgaben & Cowork-Skill vom Nutzer (Checkpoint)

Dies ist ein **Übergabepunkt**: Der Nutzer legt jetzt die Bestandsdateien an den vorgesehenen Orten ab. Keine Code-Schritte; Ausführung pausiert hier bis die Dateien vorliegen.

- [ ] **Step 1: Nutzer ablegen lassen**
  - `vorgaben/lebenslauf.md` (Lebenslauf, Markdown)
  - `vorgaben/marketing.md` (Marketing-Beschreibung, Markdown)
  - Inhalt des bestehenden Cowork-Skills nach `.claude/skills/projekt-anlegen/SKILL.md`

- [ ] **Step 2: Vorhandensein prüfen**

Run: `ls -1 vorgaben/lebenslauf.md vorgaben/marketing.md .claude/skills/projekt-anlegen/SKILL.md && echo VORHANDEN`
Expected: alle drei Pfade gelistet, danach `VORHANDEN`. Fehlt etwas → beim Nutzer nachfordern, bevor Task 5 startet.

---

## Task 5: Skill `projekt-anlegen` integrieren & kompatibel machen

Der vom Nutzer beigesteuerte Cowork-Skill wird als Claude-Code-Skill nutzbar gemacht. Cowork- und Claude-Code-Skills verwenden beide YAML-Frontmatter mit `name`/`description`; ggf. ist nur eine Anpassung der Frontmatter nötig.

**Files:**
- Modify: `.claude/skills/projekt-anlegen/SKILL.md`

- [ ] **Step 1: Frontmatter prüfen/setzen**

Sicherstellen, dass die Datei mit gültiger Frontmatter beginnt. Falls `name`/`description` fehlen oder unpassend sind, an den Anfang setzen bzw. anpassen:

```markdown
---
name: projekt-anlegen
description: Use when evaluating a freelance project and recording it in the EspoCRM (Opportunity, Contact, Account). Reads CRM access from .secrets/espocrm-api.md, does a Must/Nice-to-have match against the CV, and creates/updates the CRM records. Trigger on "Projekt bewerten", "Projekt anlegen", "ins CRM".
---
```

Den fachlichen Body (Bewertungslogik, CRM-Felder) aus dem Cowork-Skill unverändert übernehmen.

- [ ] **Step 2: CRM-Bezug prüfen**

Run: `grep -n "espocrm-api.md\|Opportunity\|X-Api-Key" .claude/skills/projekt-anlegen/SKILL.md || echo "Hinweis: kein CRM-Bezug gefunden — Body prüfen"`
Expected: mindestens ein Treffer auf den CRM-Zugang/Entitäten; sonst Body mit dem Nutzer abgleichen.

- [ ] **Step 3: Frontmatter-Validität prüfen**

Run: `head -4 .claude/skills/projekt-anlegen/SKILL.md`
Expected: gültige Frontmatter (`---`, `name: projekt-anlegen`, `description:`, `---`).

- [ ] **Step 4: Commit**

```bash
git add .claude/skills/projekt-anlegen/SKILL.md
git commit -m "Skill projekt-anlegen aus Cowork übernehmen und für Claude Code anpassen"
```

---

## Task 6: Abschlussverifikation & Push

- [ ] **Step 1: Gesamtstruktur prüfen**

Run:
```bash
test -f CLAUDE.md \
 && test -f bewerbungen/index.md \
 && test -f gedaechtnis/stil.md && test -f gedaechtnis/inhalte.md \
 && test -f gedaechtnis/schwerpunkte.md && test -f gedaechtnis/log.md \
 && test -f .claude/skills/bewerbung-schreiben/SKILL.md \
 && test -f .claude/skills/projekt-anlegen/SKILL.md \
 && test -f vorgaben/Lebenslauf_Dr-Ing_Thomas_Langer.md && test -f vorgaben/marketing.md \
 && echo "STRUKTUR VOLLSTÄNDIG"
```
Expected: `STRUKTUR VOLLSTÄNDIG`

- [ ] **Step 2: `.secrets`-Ausschluss erneut prüfen**

Run: `git check-ignore -q .secrets/espocrm-api.md && echo "secrets ignoriert" || echo "WARNUNG"`
Expected: `secrets ignoriert`

- [ ] **Step 3: Sauberer Arbeitsbaum & Push**

```bash
git status --short
git push origin main
git rev-list --left-right --count HEAD...@{u}
```
Expected: keine ungetrackten inhaltlichen Änderungen; Push erfolgreich; Zähler `0   0` (in Sync).

---

## Selbstreview (gegen die Spec)

- **Spec §2 Verzeichnisstruktur** → Tasks 1–3, 5 (alle Ordner/Dateien). ✓
- **Spec §3 Gedächtnis** (stil/inhalte/schwerpunkte/log + Lebenszyklus) → Task 1 (Seeds), Task 2 (Regeln in CLAUDE.md), Task 3 (Update-Schritt im Skill). ✓
- **Spec §4.1 projekt-anlegen** → Tasks 4–5 (Übernahme + Kompatibilität). ✓
- **Spec §4.2 bewerbung-schreiben** → Task 3 (vollständiger Workflow). ✓
- **Spec §5 Register & Namensschema** → Task 1 (index.md), Task 3 (Schema + Normalisierung im Skill). ✓
- **Spec §6 Git** → Task 6 (Push), Commits in jedem Task. ✓
- **Spec §8 offene Punkte** (Bestandsdateien, Cowork-Skill) → Task 4 (Übergabe). ✓

Keine Platzhalter; Datei- und Skill-Namen über alle Tasks konsistent (`bewerbung-schreiben`, `projekt-anlegen`, `gedaechtnis/*`, `bewerbungen/index.md`).
