# Honorarbasis — Creation Notes

**Last Updated:** 2026-03-21

## Summary

Lexikon post on **Honorarbasis** (Vergütungslogik: Honorar vs. Gehalt, Honorarvertrag vs. AN, Honorarkraft, Steuern/SV Überblick, Scheinselbstständigkeit, Betrieb/Dokumentation). Competitive-depth target **4,700** words (capped from portal outlier); outline **4,300** words; body **~4,171** words (meets `validate-new-post --strict` vs. 4,300 outline).

## Pipeline

- Backup: `scripts/blog/backup-blog-content.py --manual` → `docs/backups/blog-snapshots/2026-03-21-150512/`
- Scaffold: `create-new-blog-post.php --topic="Honorarbasis" --category=lexikon`
- Keywords: `KEYWORD_DECISION.md`, `target-keywords.json` (primary **Honorarbasis** + secondaries)
- `run-new-post-pipeline.php --post=honorarbasis --category=lexikon`
- SERP: `SERP_ANALYSIS.md` (manual; Indeed competitor URL sparse — noted)
- Outline: `CONTENT_OUTLINE.md` (10 H2s, tables); `generate-section-briefs.php`
- Gates: `validate-improvement-readiness --new-post`, `validate-serp-outline-ready`, `validate-content-outline-quality`, `check-outline-h2-overlap`
- Body: `content.html` → `update-post-content.php` (no direct JSON edits)
- PAA completeness: added VHS/Arzt-Verdienst-Fragen (ohne Euro-Pauschalen), **Dienstleistungsvertrag vs. Honorarvertrag**; fixed inline `(1)(2)` → `<ol>` lists for depth guidelines
- FAQs: `generate-faq-questions.php` + 2 manual questions → `generate-faq-answers-optimized.php --use-ai` → `add-faqs-to-post.php --replace` (11 FAQs)
- SEO: `v2/data/blog/seo-meta.json` → `sync-meta-to-posts.php`
- Image: `IMAGE_PROMPT.md` (desk/belege, not freelancer handshake); `generate-blog-featured-image.py` → WebP `/insights/bilder/honorarbasis-*w.webp`
- Related: curated `related_posts` (freelancer, werkvertrag, projektzeiterfassung, minijob, entgeltabrechnung, arbeitnehmerueberlassung); `add-new-post-to-related-carousels.php --targets=freelancer,projektzeiterfassung,werkvertrag --write`
- Bidirectional body: `update-post-content.php` with patches for `freelancer`, `projektzeiterfassung`, `werkvertrag` → link to `/insights/lexikon/honorarbasis/`
- Lead: `_slugToBenefit` entry for `honorarbasis` in `generate-lead-capture-copy.php` → `--write` → `lead_capture_copy.php`
- LLM: `v2/scripts/llms/sync-blog-posts-to-llms.php --add`
- Contextual links (post-publish): `suggest-contextual-links.php` + `suggest-ordio-feature.php` — integrated tools (Minijob‑, Urlaubsanspruch‑, Brutto‑Netto‑, Einkommensteuer‑Rechner), Branchen (Gesundheitswesen, Handwerk, Freizeit/Kultur), Produkte (`/abwesenheiten`, `/events`, `/checklisten`), Lexikon‑Nachbarn (Compliance, Employer Branding → Arbeitgebermarke, Kleinunternehmerregelung, Onboarding, Arbeitsorganisation, Personalplanung); re‑`update-post-content.php` from `content.html`
- Content review (2026‑03‑21): legal tone in FAQs (kein „Steuern sparen“ durch Honorar); Dienst vs. Werk + AN‑Schutz klarer; H3 Steuern/SV mit EÜR/Bilanz‑Kontext und SV‑Praxis; Pros/Cons und Festanstellung‑Absatz erweitert; Begriffsklarheit: Werkvertrag verlinkt; Scheinselbstständigkeit: HR‑Dokumentationsbezug

## Validators (key)

- `validate-content-completeness.php` — PASS (56/56 PAA keywords)
- `validate-new-post.php --post=honorarbasis --category=lexikon --strict` — PASS (optional WARN: validator expects `docs/.../data/seo-meta.json` — project uses `v2/data/blog/seo-meta.json` + sync)
- `validate-faq-quality.php` — EXCELLENT
- `check-h2-faq-overlap.php` — no overlap

## Files

- Post: `v2/data/blog/posts/lexikon/honorarbasis.json`
- Working HTML: `docs/content/blog/posts/lexikon/honorarbasis/content.html`
- Bidirectional patch sources (optional archive): `content-bidir-patch.html` on freelancer/projektzeiterfassung/werkvertrag under respective docs dirs