# Werkvertrag — creation notes

**Last Updated:** 2026-03-20

## Summary

- **URL:** `/insights/lexikon/werkvertrag/`
- **Angle:** BGB **Werkvertrag** (§§ 631 ff.) — Erfolg, Abnahme, Werklohn, Mängelrecht (Überblick); vollständige **Werk vs. Dienst vs. Kauf**-Gegenüberstellung (kein separates Lexikon **Dienstvertrag**).
- **Clusters:** primary `compliance`, secondary `lohnabrechnung`, `personalverwaltung`.
- **Word count:** ~2.880 / Outline-Ziel 3.600 (80 %-Gate für `validate-new-post --strict`).
- **FAQs:** 10 (40–80 Wörter); `validate-faq-quality` EXCELLENT.

## Links & bidirectional

- **`freelancer`:** bereits mehrfach `/insights/lexikon/werkvertrag/`; **werkvertrag** verlinkt **Freelancer** im Fließtext und in der Tabelle.
- **`zeitarbeit`** / **`arbeitnehmerueberlassung`:** ein Absatz je in der **Einleitung** zur Abgrenzung **Werkvertrag (BGB)** vs. **AÜ** (mit Link zu **werkvertrag**).
- **related_posts:** freelancer, arbeitnehmerueberlassung, zeitarbeit, lohnabrechnung, compliance, betriebsvereinbarung, taetigkeitsnachweis, personalwesen.
- **Carousels:** `add-new-post-to-related-carousels.php --write` auf die 8 Ziel-Slugs.

## SEO & assets

- **seo-meta:** `v2/data/blog/seo-meta.json` → `lexikon/werkvertrag`; Mirror `data/seo-meta.json` im Post-Ordner.
- **Featured image:** `IMAGE_PROMPT.md` (Projekt-Übergabe/Handover, nicht generisches Unterschreiben); `werkvertrag-{640,1024,1280}w.webp`.
- **Lead capture:** `generate-lead-capture-copy.php --write`; `_slugToBenefit` **werkvertrag** in `generate-lead-capture-copy.php`.

## Validierung / Fallstricke

- **validate-content-flow:** Regex **Häufig…Fragen** — im Satz „begegnet dir der Werkvertrag **häufig** bei …“ und später **Einordnungsfragen** entstand ein False Positive; Fix: **„oft bei“** statt „häufig bei“.
- **validate-serp-outline-ready:** Word Count Target nur Ziffern (**3600**), kein `3.600`.

## Inventory

- **merged.json:** `ordio_covered: true`, `ordio_slug: werkvertrag`.
- **LEXIKON_CONTENT_GAPS.md:** Tier-2-Zeile `werkvertrag` entfernt.

## LLM

- `php v2/scripts/llms/sync-blog-posts-to-llms.php --add`

## Follow-up (Product / Tool / Industry WARNs)

- **Intro:** `Handwerk` → `/branchen/handwerk-industrie`; Ordio-Bündel um **`/abwesenheiten`**, **`/schichtplan`** (Schichtplanung) ergänzt.
- **Werklohn:** `/tools/brutto-netto-rechner` nach dem Lohnabrechnung-Satz.
- **HR-Praxis:** `Employer Branding` → **Recruiting- und Markenauftritte** (vermeidet `blog-tool-mapping` „branding“ ohne sinnvollen Tool-Bezug); **`/events`** auf „Messestände“.
- **Liste „Zeit & Einsatz“:** zusätzlicher Link **`/schichtplan`** neben Zeiterfassung.
- **`validate-new-post.php --strict`:** danach **OK: All checks passed.**

**Rules / CI:** Vollständiges `make rules` (inkl. langsamer Glob-Validierung) lokal ausführen, falls CI das verlangt; `generate-rule-metadata.py` meldete Index unverändert nach der `blog-new-post-creation.mdc`-Änderung.