# Tool page — FAQ data-driven refresh (checklist)

Use when reworking `v2/data/tools-faqs/{tool}.json` with GSC/SISTRIX support. Hub: [FAQ_WEBSITE_STANDARD.md](../../FAQ_WEBSITE_STANDARD.md), [DATA_COLLECTION_TOOLS.md](../DATA_COLLECTION_TOOLS.md).

## Before writing copy

1. Ensure `docs/content/tools/{slug}/data/` exists (required for default `collect-tool-gsc-queries.php` output).
2. Refresh aggregates: `php v2/scripts/tools/collect-tools-performance-gsc.php`, `php v2/scripts/tools/collect-tools-performance-ga4.php` (optional `--compare-28d`).
3. Page queries: `php v2/scripts/tools/collect-tool-gsc-queries.php --tool={slug}` → `data/gsc-queries.json`.
4. Maintain `data/keywords-candidate.json` so the **first entries match the tool type** (e.g. ROI-Schichtplanung vs. generisches „Personalkosten senken“); run `collect-tool-keywords-sistrix.php --dry-run` first (credits). If an older run used a **SERP-mismatched** primary keyword, regenerate `competitive-depth-analysis.md` / `SERP_ANALYSIS.md` / `CONTENT_OUTLINE.md` before trusting PAA or competitor headings.
5. `collect-tool-paa-questions.php`, `collect-tool-competitor-analysis.php`, `analyze-tool-competitor-depth.php` for the same slug.
6. `php v2/scripts/tools/generate-tool-data-synthesis.php --tool={slug} --output=docs/content/tools/{slug}/DATA_DRIVEN_SYNTHESIS.md`.

## Editorial

7. Map top queries/PAA to questions; **prune** overlap with on-page H2/H3 (see [FAQ_REWORK_DECISION_TREE.md](../../FAQ_REWORK_DECISION_TREE.md)). For **tools**, SISTRIX PAA can include **off-topic high-traffic** rows (z. B. Einzelhandels-Aktionen) — filter by **intent** before copying questions verbatim.
7b. **SERP-Produkt-Mismatch:** Wenn die Top-SERP für das Seed-Keyword **einen anderen Rechnertyp** zeigt (z. B. Lohnnebenkosten-/Brutto-Netto-Rechner, während euer Tool Zeit- oder Prozesskosten schätzt), dann **keine inhaltliche Gleichsetzung** in FAQs: kurze **Abgrenzungs-FAQ** + **Bridge-Links** zu passenden eigenen Tools/Lexikon. Beispiel-Artefakt: [FAQ_INTENT_MATRIX.md](../kostenrechner/FAQ_INTENT_MATRIX.md).
8. **KI-/Generator-Tools mit Export:** FAQ-Antworten gegen **Alpine/JS** prüfen (PDF/CSV vorhanden?, E-Mail-Gate?, Kopieren ohne Gate) — nicht nur „kostenlos & ohne Anmeldung“ behaupten, wenn der Download Lead-Daten braucht.
9. `du` tone; short lists only when enumerating; one contextual Ordio mention if natural ([ordio-promotion-contextual.mdc](../../../.cursor/rules/ordio-promotion-contextual.mdc)); no `/kostenlos-testen` links.
10. **Kalender-Tools (z. B. Arbeitstage-Rechner):** Keine **konkreten Einzeldaten** (Brückentage, Feiertage) in FAQs behaupten, ohne sie gegen den Rechner oder einen amtlichen Kalender zu prüfen — lieber allgemein erklären oder auf die Tool-Berechnung verweisen.

## After edits

11. `php v2/scripts/dev-helpers/verify-faq-jsonld-parity.php --file=tools-faqs/{file}.json`
12. `php v2/scripts/dev-helpers/audit-faq-json-internal-links.php '--glob=v2/data/tools-faqs/{file}.json'`
13. `php v2/scripts/dev-helpers/audit-faq-json-self-links-and-anchors.php --file=v2/data/tools-faqs/{file}.json`
14. Post-deploy: [Rich Results Test](https://search.google.com/test/rich-results) on the canonical tool URL (FAQPage `@context` = schema.org).

**TVöD-SuE example:** SSOT `v2/data/tools-faqs/tvoed_sue.json`, canonical `/tools/tvoed-sue-gehaltsrechner`.