# Content Creation Workflow

**Last Updated:** 2026-01-14

Complete workflow for creating new blog posts with integrated FAQ planning from scratch.

**Note:** This workflow is specific to blog posts. For universal content creation guidelines applicable to all content types, see `docs/content/CONTENT_CREATION_WORKFLOW_2026.md`.

**See Also:**

- `docs/content/CONTENT_CREATION_WORKFLOW_2026.md` - Universal content creation workflow
- `docs/content/CONTENT_WRITING_BEST_PRACTICES_2026.md` - Content writing best practices
- `.cursor/rules/content-writing.mdc` - Universal content writing guidelines

## Overview

This workflow guides the creation of new blog posts with FAQ planning integrated from the start, ensuring high-quality FAQs are part of the content creation process.

## Step-by-Step Workflow

### Step 1: Create Post Structure

**Script:** `v2/scripts/blog/create-new-post.php` (to be created)

```bash
php v2/scripts/blog/create-new-post.php --title="Post Title" --category=lexikon --slug=post-slug
```

**What it does:**

- Creates post JSON structure
- Sets up basic metadata
- Generates FAQ planning checklist
- Prepares post for content creation

**Output:**

- `v2/data/blog/posts/{category}/{slug}.json`
- `docs/content/blog/posts/{category}/{slug}/FAQ_PLANNING_CHECKLIST.md`

### Step 2: Write Post Content

1. Write main content following best practices
2. Include primary keyword naturally
3. Structure content with clear sections
4. Add internal links where relevant

**Reference:** `docs/content/blog/BLOG_BEST_PRACTICES.md`

### Step 3: FAQ Planning

**Generate Planning Checklist:**

```bash
php v2/scripts/blog/faq-planning-checklist.php --post=slug --category=category
```

**Checklist includes:**

- Post analysis (word count, keyword)
- Suggested FAQ count (10-15)
- Initial question suggestions
- Step-by-step planning guide

### Step 4: Generate FAQ Questions

**Script:** `v2/scripts/blog/generate-faq-questions.php`

```bash
php v2/scripts/blog/generate-faq-questions.php --post=slug --category=category
```

**What it does:**

- Collects PAA questions from SISTRIX
- Analyzes GSC queries
- Generates question suggestions
- Prioritizes by search volume

**Output:** `docs/content/blog/posts/{category}/{slug}/data/faq-questions.json`

### Step 5: Generate FAQ Answers

**Option A: AI-Powered (Recommended)**

```bash
php v2/scripts/blog/generate-faq-answers-ai.php --post=slug --category=category
```

**Option B: Manual Writing**

Follow FAQ best practices:

- Length: 40-80 words
- Structure: Direct answer → Context → Actionable info
- Tone: Du tone (informal)
- Keywords: Natural integration

**Reference:** `docs/content/blog/FAQ_BEST_PRACTICES.md`

### Step 6: Enhance FAQs

**Automated Enhancement:**

```bash
php v2/scripts/blog/automate-faq-enhancement.php --post=slug --category=category
```

**What it does:**

- Adds keywords to FAQs
- Adds internal links
- Expands short answers
- Condenses long answers
- Validates quality

### Step 7: Validate and Test

**Quality Audit:**

```bash
php v2/scripts/blog/audit-faq-quality.php
```

**Schema Validation:**

```bash
php v2/scripts/blog/validate-faq-schema.php --post=slug --category=category
```

**Check:**

- FAQ count: 10-15
- Answer length: 40-80 words
- Keyword integration: 50%+ FAQs
- Internal links: 1-2 per FAQ
- Schema validity

### Step 8: Add Internal Links

**Automated Link Addition:**

```bash
php v2/scripts/blog/add-pillar-links.php --post=slug --category=category
php v2/scripts/blog/add-tools-links.php --post=slug --category=category
```

**Manual Link Review:**

- Review suggested links from analysis
- Add pillar page links (1-2 per post)
- Add product page links (1-3 per post)
- Add template/comparison links (where relevant)
- Ensure anchor text is descriptive and natural

**Reference:** `docs/content/blog/guides/INTERNAL_LINKING_GUIDE.md`

### Step 9: Validate Content Quality

**Quality Validation:**

```bash
php v2/scripts/blog/validate-expansion-quality.php --post=slug --category=category
```

**Checks:**

- Word count meets targets (1,200+ for Lexikon, 1,500+ for Ratgeber)
- FAQ count and quality
- Internal links present
- SEO elements (meta tags, schema)
- Content structure

### Step 10: Publish and Monitor

1. **Publish Post**

   - Verify JSON syntax
   - Check image references
   - Validate schema markup

2. **Automated Monitoring**

   - Weekly quality checks run automatically
   - Priority refresh updates GA4/GSC data weekly
   - Data collection runs weekly (GA4/GSC) and monthly (SISTRIX)

3. **Performance Tracking**
   - Monitor FAQ engagement in GA4
   - Track Featured Snippet opportunities in GSC
   - Review performance monthly
   - Update content based on data insights

**Reference:** `docs/content/blog/MONITORING_RUNBOOK.md`

## FAQ-First Content Creation

### Best Practices

1. **Plan FAQs Early**

   - Generate FAQ planning checklist before writing
   - Use questions to guide content structure
   - Ensure content answers FAQ questions

2. **Integrate Naturally**

   - FAQs should complement main content
   - Answer questions raised in content
   - Add value beyond main content

3. **Optimize for Search**

   - Use PAA questions from SISTRIX
   - Target Featured Snippet opportunities
   - Integrate primary keyword naturally

4. **Maintain Quality**
   - Follow 40-80 word guideline
   - Use du tone consistently
   - Add internal links contextually

## Quick Reference

**Complete FAQ Generation:**

```bash
php v2/scripts/blog/generate-faqs-complete.php --post=slug --category=category
```

**This single command:**

1. Generates FAQ questions
2. Generates FAQ answers (AI)
3. Adds keywords
4. Adds links
5. Validates quality

## Related Documentation

- `FAQ_WORKFLOW.md` - Detailed FAQ workflow
- `FAQ_BEST_PRACTICES.md` - Content guidelines
- `FAQ_OPTIMIZATION_GUIDE.md` - Optimization strategies
- `CONTENT_CREATION_WORKFLOW.md` - This document