# Template FAQ Workflow

**Last Updated:** 2026-02-18

FAQ creation for template pages. Parallel to [FAQ_CREATION_WORKFLOW_2026.md](../../content/blog/FAQ_CREATION_WORKFLOW_2026.md).

## Target

- **Count:** 8–12 FAQs per template
- **Answer length:** 40–80 words
- **Tone:** Du, benefit-driven
- **Sources:** PAA questions, GSC top queries

## Steps

1. **Collect FAQ research**
   ```bash
   php v2/scripts/templates/collect-template-faq-research-data.php --template=ID
   ```

2. **Generate questions**
   ```bash
   php v2/scripts/templates/generate-template-faq-questions.php --template=ID
   ```

3. **Generate answers**
   ```bash
   php v2/scripts/templates/generate-template-faq-answers-optimized.php --template=ID --use-ai [--dry-run]
   ```
   - **CRITICAL:** Always use `--use-ai` flag for production. Without it, outputs empty answer placeholders.
   - With `--use-ai`: uses Gemini API to generate 40-80 word answers (same as blog FAQs). Requires `GEMINI_API_KEY`.
   - `--dry-run`: Test without API calls (useful for validation).

4. **Check block-FAQ overlap** (before add-template-faqs)
   ```bash
   php v2/scripts/templates/check-template-block-faq-overlap.php --template=ID
   ```
   - Ensures FAQs don't duplicate content block headings. Remove or rephrase overlapping FAQs.

5. **Supplemental FAQs** (when count < 8)
   ```bash
   php v2/scripts/templates/collect-template-supplemental-faq-questions.php --template=ID
   ```
   - Gathers additional FAQ candidates from competitor analysis, PAA, competitor URLs.

6. **Add to template-faqs**
   ```bash
   php v2/scripts/templates/add-template-faqs.php --template=ID
   ```

7. **Validate**
   ```bash
   php v2/scripts/templates/validate-template-faq-quality.php --template=ID
   php v2/scripts/templates/validate-template-faq-schema.php --template=ID
   ```

## Manual Review

- Review faq-answers-optimized.json before add-template-faqs
- Fill empty answers manually, or run with `--use-ai` to generate via Gemini
- Compare with existing FAQs in template-faqs.json; keep best of both