# Blog content system index **Last Updated:** 2026-04-04 **Purpose:** Single entry map to workflows, gates, validators, and scripts. **Do not duplicate** long prose here—follow links. ## Start here | Goal | Document | | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Improve existing page (GSC, GA4, SISTRIX, research)** | [PAGE_IMPROVEMENT_DATA_PLAYBOOK.md](../PAGE_IMPROVEMENT_DATA_PLAYBOOK.md) · [PAGE_IMPROVEMENT_ITERATION_CHECKLIST.md](../PAGE_IMPROVEMENT_ITERATION_CHECKLIST.md) — baseline + period compare / Firecrawl / handoff | | **New website page (tools, templates, downloads, OG, carousels)** | [WEBSITE_PAGE_PUBLICATION_INDEX.md](../WEBSITE_PAGE_PUBLICATION_INDEX.md) | | New lexikon post (human checklist) | [lexikon-inventory/LEXIKON_NEW_POST_CHECKLIST.md](lexikon-inventory/LEXIKON_NEW_POST_CHECKLIST.md) | | **Edit existing post (iterative)** | [BLOG_CONTENT_EDIT_WORKFLOW.md](BLOG_CONTENT_EDIT_WORKFLOW.md) — canonical `content-draft.html`, `apply-and-validate-post.sh`, `blog-post-validate-strict` | | **Backups (Git vs local snapshots)** | [guides/BACKUP_GUIDE.md](guides/BACKUP_GUIDE.md) — GitHub = primary; `backup-blog-content.py` → `docs/backups/blog-snapshots/` (gitignored); retention: `v2/scripts/blog/cleanup-old-backups.py` (default delete; `--archive` / `--prune-archive`), `v2/scripts/blog/cleanup-seo-meta-sync-backups.py`; inventory: `v2/scripts/blog/inventory-docs-backups.py`; optional index: [guides/BACKUP_INDEX.md](guides/BACKUP_INDEX.md) | | **Cursor skills (project)** | `.cursor/skills/` — `ordio-blog-content-router`, `ordio-blog-new-post-pipeline`, `ordio-faq-workflow`, `ordio-template-content-workflow`, `ordio-tools-content-block`, `ordio-new-page-og-carousel`, `ordio-feature-page-seo-workflow` (`SKILL.md` each); usage: [cursor-playbook.md](../../ai/cursor-playbook.md) **Content workflows** | | **Agent phase map (scaffold → data → outline → draft → validate)** | [BLOG_AGENT_PHASE_RUNBOOK.md](BLOG_AGENT_PHASE_RUNBOOK.md) — dependencies + copy-paste commands; link hub for long sessions | | **Fast iteration / commands** | [BLOG_WORKFLOW_EFFICIENCY.md](BLOG_WORKFLOW_EFFICIENCY.md) — `make blog-apply-validate` / `blog-apply-validate-strict` (POST, CAT, HTML=path); `blog-audit-meta-intro`; FAQ-only: `make blog-post-validate-faq` | | Copy-paste agent todos | Lexikon: [posts/_templates/LEXIKON_POST_CREATION_TODO_TEMPLATE.md](posts/_templates/LEXIKON_POST_CREATION_TODO_TEMPLATE.md) · Ratgeber: [posts/_templates/RATGEBER_POST_CREATION_TODO_TEMPLATE.md](posts/_templates/RATGEBER_POST_CREATION_TODO_TEMPLATE.md) | | New vs revise (outline-first) | [CONTENT_CREATION_WORKFLOW_2026.md](CONTENT_CREATION_WORKFLOW_2026.md) | | **„vs.“ / Vergleich vs. Abgrenzung (Outlines)** | [COMPARISON_AND_VS_SECTIONS_GUIDE.md](COMPARISON_AND_VS_SECTIONS_GUIDE.md) — Evidence, PAA-Matrix, Lexikon-TOC | | **Data collection (blog + cross-surface)** | [CONTENT_CREATION_DATA_CHECKLIST.md](../CONTENT_CREATION_DATA_CHECKLIST.md) — `run-new-post-pipeline.php`, `run-post-improvement-pipeline.php`, `data/` artifacts, post-pipeline outline steps; bulk cadence: [.cursor/rules/blog-data-collection.mdc](../../.cursor/rules/blog-data-collection.mdc) | | **Data collection (tools / Rechner)** | [DATA_COLLECTION_TOOLS.md](../tools/DATA_COLLECTION_TOOLS.md) — SISTRIX + GSC merge, per-tool `docs/content/tools/{slug}/data/`, [TOOLS_SLUG_MATRIX.md](../tools/TOOLS_SLUG_MATRIX.md), backlog: [TOOLS_SEO_IMPROVEMENT_BACKLOG.md](../tools/TOOLS_SEO_IMPROVEMENT_BACKLOG.md) | | **Product feature pages (10 Funktionen)** | [FEATURE_PAGES_CONTENT_INDEX.md](../pages/product-pages/FEATURE_PAGES_CONTENT_INDEX.md) — `run-feature-page-research-pipeline.sh`, `generate-feature-page-data-synthesis.php`, [FEATURE_PAGE_IMPROVEMENT_WORKFLOW.md](../pages/product-pages/FEATURE_PAGE_IMPROVEMENT_WORKFLOW.md); `make feature-research PAGE=feature-`* / `make feature-synthesis PAGE=feature-*`; skill `ordio-feature-page-seo-workflow` | | **Skyscraper + depth (data → outline → body)** | [SKYSCRAPER_TECHNIQUE_2026.md](SKYSCRAPER_TECHNIQUE_2026.md) · [SKYSCRAPER_CONTENT_QUALITY_ENFORCEMENT.md](SKYSCRAPER_CONTENT_QUALITY_ENFORCEMENT.md) · [CONTENT_PIPELINE_AUDIT_2026-03-23.md](CONTENT_PIPELINE_AUDIT_2026-03-23.md) · scaffold: `synthesize-outline-scaffold.php` ([BLOG_SCRIPTS_USAGE_GUIDE.md](BLOG_SCRIPTS_USAGE_GUIDE.md)) | | Depth, AEO capsules, stop rules | [CONTENT_DEPTH_GUIDELINES.md](CONTENT_DEPTH_GUIDELINES.md) | | **Formula-block, tables, notes (when & how much)** | [CONTENT_FORMAT_PATTERNS.md](CONTENT_FORMAT_PATTERNS.md) § *Visual format decision guide* · [BLOG_TABLE_FORMAT.md](BLOG_TABLE_FORMAT.md) | | SEO / AEO / GEO checklist | [SEO_GEO_AEO_CHECKLIST.md](SEO_GEO_AEO_CHECKLIST.md) (see **Canonical title** note at top) | | AEO/GEO narrative | [AEO_GEO_BEST_PRACTICES_2026.md](AEO_GEO_BEST_PRACTICES_2026.md) | | External research log | [EXTERNAL_CONTENT_SEO_RESEARCH_LOG.md](EXTERNAL_CONTENT_SEO_RESEARCH_LOG.md) | | **FAQ pipeline vs canonical post** | [FAQ_SOURCE_OF_TRUTH.md](FAQ_SOURCE_OF_TRUTH.md) — `faqs` in `post.json` is published truth; `faq-research.json` → `faq-questions.json` → `faq-answers-optimized.json` are pipeline stages; apply with `add-faqs-to-post.php`; optional drift check: `audit-faq-source-drift.php` · **All surfaces:** [FAQ_WEBSITE_STANDARD.md](../FAQ_WEBSITE_STANDARD.md) | | Pipeline audit (metrics) | [CONTENT_PIPELINE_AUDIT_2026-03-23.md](CONTENT_PIPELINE_AUDIT_2026-03-23.md) | | Legacy draft filenames / cleanup | [CONTENT_DRAFT_LEGACY_INVENTORY.md](CONTENT_DRAFT_LEGACY_INVENTORY.md) | | Tooling roadmap (Phase C) | [CONTENT_TOOLING_ROADMAP.md](CONTENT_TOOLING_ROADMAP.md) | | **Blog-wide backlog / next steps** | [NEXT_STEPS.md](NEXT_STEPS.md) — single file; old `NEXT_STEPS_*.md` companions removed 2026-04 (stubs: [archive/2026-01-20-consolidated-next-steps/](../../archive/2026-01-20-consolidated-next-steps/)) | | Per-post `NEXT_STEPS` / `COMPLETION_`* policy | [posts/POST_LEVEL_DOCS_POLICY.md](posts/POST_LEVEL_DOCS_POLICY.md) | | CI scope (blog validators) | [CI_BLOG_CONTENT_GUARDRAILS.md](CI_BLOG_CONTENT_GUARDRAILS.md) | ## Cursor rules - [.cursor/rules/blog-content-creation-gate.mdc](../../.cursor/rules/blog-content-creation-gate.mdc) — Pre/post write gates - [.cursor/rules/blog-new-post-creation.mdc](../../.cursor/rules/blog-new-post-creation.mdc) — Scaffold + pipeline - [.cursor/rules/blog-ratgeber-quality.mdc](../../.cursor/rules/blog-ratgeber-quality.mdc) — Ratgeber parity - **`v2/data/blog/posts/**/*.json`** is matched by multiple rules (linking, tool linking, FAQ, JSON prohibition, etc.): run `python3 scripts/ai/rule-footprint.py` and read `blog-json-edit-prohibition.mdc` first when editing post JSON. ## Makefile shortcuts ```bash make blog-outline-gate POST=slug CAT=lexikon make blog-post-validate POST=slug CAT=lexikon make blog-post-validate-strict POST=slug CAT=lexikon # pre-publish: compare --strict, internal links, content-flow, aeo-capsule-diversity --strict make blog-post-validate-faq POST=slug CAT=lexikon # FAQ-only: faq-quality + h2-faq-overlap + audit-faq-source-drift make blog-audit-meta-intro POST=slug CAT=lexikon # meta-intro audit (also last step of blog-post-validate-strict) make blog-apply-validate POST=slug CAT=lexikon HTML=docs/content/blog/posts/lexikon/slug/content-draft.html make blog-apply-validate-strict POST=slug CAT=lexikon HTML=docs/content/blog/posts/lexikon/slug/content-draft.html make audit-blog-repetition # optional: repetitive „In Kürze:“ / soft tells across all JSON posts make feature-research PAGE=feature-schichtplan # product feature: SISTRIX + GSC queries (+ Serper/Firecrawl if keys set) make feature-synthesis PAGE=feature-schichtplan # product feature: DATA_DRIVEN_SYNTHESIS.generated.md ``` ## Script reference See [BLOG_SCRIPTS_USAGE_GUIDE.md](BLOG_SCRIPTS_USAGE_GUIDE.md) — sections **Outline and skyscraper** and **Post-body validation (AEO / GEO / competitive)**. ## Content edit safety - [BLOG_CONTENT_EDIT_WORKFLOW.md](BLOG_CONTENT_EDIT_WORKFLOW.md) — `update-post-content.php`; no direct JSON text edits - **Several Cursor rules match `v2/data/blog/posts/**/*.json`:** read [.cursor/rules/blog-json-edit-prohibition.mdc](../../.cursor/rules/blog-json-edit-prohibition.mdc) first (scripts + prohibition), then topic rules (linking, flow, FAQ) for editorial rules.