# Arbeitsformen – CREATION_NOTES

**Last Updated:** 2026-04-01

## Positioning

- **Clusters:** primary `zeiterfassung`, secondary `dienstplan` (post JSON + `blog-cluster-mapping.json`).
- **Cannibalisation:** **Arbeitsformen** (Organisation: Umfang, Ort, Vertragsarten) vs **Arbeitszeitmodelle** (Verteilung/Dauer) – frühe Abgrenzung, Tabelle, kein Duplikat der Schicht-/Gleitzeit-Tiefe.

## Pipeline / research

- Manual PAA: `data/paa-questions-manual.json` (SISTRIX/organic noise).
- Competitor validator: mehrere Top-URLs **sparse** (e2n, universal-search-box, Arbeitsagentur) – Firecrawl-Remediate im Script **FAIL**; dokumentiert in `SERP_ANALYSIS.md`.
- Nach **make blog-post-validate-strict:** PAA „arbeitsformen und zeiterfassungspflicht“ – Absatz mit exakter Formulierung **Arbeitsformen und Zeiterfassungspflicht** im H2 „Arbeitsformen und Zeiterfassung“ ergänzt (`content-draft.html` → `update-post-content.php`).

## SEO / Meta

- `v2/data/blog/seo-meta.json` → `lexikon/arbeitsformen`; `docs/.../data/seo-meta.json`; `sync-meta-to-posts.php`.

## Related posts / carousels

- `suggest-related-posts --write` lieferte Noise (ruestkosten, gleittag, …) → **manuell kuratiert** in `arbeitsformen.json`.
- `add-new-post-to-related-carousels` zuerst gegen Auto-Ziele → **falsche** Backlinks aus 8 Posts entfernt (ruestkosten, freizeitausgleich, …); **mobiles-arbeiten** + **teilzeitarbeit** behalten.
- Explizit `--targets=arbeitszeitmodelle,flexible-arbeitszeit,arbeitszeitflexibilisierung,homeoffice,telearbeit,agiles-arbeiten`.

## Bidirectional

- `arbeitszeitmodelle`, `flexible-arbeitszeit`, `homeoffice`: je ein Einordnungsabsatz mit Link auf `/insights/lexikon/arbeitsformen/` via `update-post-content.php` (HTML aus JSON injiziert; `arbeitszeitmodelle` zusätzlich `content-draft`-Pfad nicht nötig).

## Lead / LLM

- `_slugToBenefit` **arbeitsformen** in `generate-lead-capture-copy.php`; `generate-lead-capture-copy.php --write`.
- `sync-blog-posts-to-llms.php --add`; Header **Content-Tiefe** / **Content Types** Lexikon **353→354** in `html/llms.txt` + `html/llms-full.txt` (Validator).

## Assets

- `IMAGE_PROMPT.md` (Hybrid-Office-Silhouetten); `generate-blog-featured-image.py` → `/insights/bilder/arbeitsformen-*w.webp`.

## Content revision (Tiefe, H3, Links)

- Ziel **~2.700 Wörter** (Outline): Erweiterung per `content-draft.html` → `update-post-content.php` auf **~2.738 Wörter**.
- **8× H3** unter langen H2 (Taxonomie „Welche Arbeitsformen…“, Orts-Modelle, Zeiterfassung, Recht/Mitbestimmung) – bessere Scannability, `validate-new-post --strict` ohne H3-Warnung.
- **Praxisbeispiel** hybrid + Gleitzeit nach Vergleichstabelle; zusätzliche interne Links: `jobsharing`, `brueckenteilzeit`, `gleitzeit`, `sollstunden`, `tarifvertraege`, `work-life-balance`, `dokumentenmanagement`, `arbeitszeiterfassungsgesetz`.

## Validation

- `make blog-post-validate-strict POST=arbeitsformen CAT=lexikon` – **OK** nach PAA-Ergänzung.
- `python3 v2/scripts/llms/validate-llms-metadata.py` – **OK**.

## Backup

- Manuelles Blog-Backup vor Scaffold: `docs/backups/blog-snapshots/2026-04-01-192049/` (siehe Session-Notizen).
