# Templates de sortie par phase

Référence consultée pendant l'exécution du flow pour produire des outputs structurés. Format Markdown sauf indication contraire.

## Phase 1 — Competitors deconstruction table

À reproduire dans le checkpoint 1 ET dans le `<query-slug>.workflow.md` final.

```markdown
| # | URL | Meta Title | Meta Description | Grammage | Structure Hx | Angle | EEAT forces | EEAT faiblesses |
|---|-----|------------|------------------|----------|--------------|-------|-------------|-----------------|
| 1 | https://… | … | … | 2340 | H1 + 8×H2 + 12×H3 | Tutoriel débutant | citations ISO, photos atelier | aucune source chiffrée |
| 2 | … | … | … | … | … | … | … | … |
| … | | | | | | | | |
| 7 | … | … | … | … | … | … | … | … |
```

**Conseils de remplissage** :
- **Grammage** : compter les mots du body markdown brut (sans nav / footer). `wc -w` ou équivalent.
- **Structure Hx** : compter par niveau (`H1: 1, H2: 8, H3: 12`). Plus court à lire qu'une liste complète.
- **Angle** : 3-7 mots max. Ex: "Tutoriel débutant", "Guide acheteur B2B", "Comparatif technique", "Listicle inspirationnel".
- **EEAT forces / faiblesses** : 1-3 items chacun, factuels. Ce sont les inputs principaux du jugement Phase 4.

### Synthèse comparative (200 mots max)

```markdown
**Patterns Hx** : <observation transversale>

**Topics sur-couverts** : <topics que tous traitent>

**Topics sous-couverts** : <topics que ≤ 2 concurrents abordent — c'est notre opportunité>

**Gaps d'opportunité** : <angles non exploités par la concurrence>

**Benchmark grammage** :
- Min : <N> mots
- Médiane : <N> mots
- **MAX : <N> mots** ← référence pour Phase 2
```

## Phase 2 — Lumenia analysis output

```markdown
### Top terms (50, top 20 prioritaires)
1. <terme> — priorité haute (fréquence + position)
2. …
20. <terme>
[…liste complète des 50, ordre = ordre Lumenia, marquage des 20 premiers comme prioritaires]

### Two-grams prioritaires (20)
1. <2-gram>
…

### Three-grams prioritaires (20)
1. <3-gram>
…

### Named entities (20 — toutes obligatoires à citer si pertinentes)
1. <entity>
…

### 🎯 Grammage final visé
**<grammage_final> mots** = MAX concurrent (<MAX>) + <delta> (overshoot 500-1000)
```

## Phase 3 — Brief analysis output

```markdown
### Intent
<informational | transactional | commercial | navigational>

### Objectifs
- <obj 1>
- <obj 2>
…

### Topics & questions FAQ
**Key subjects (→ H2/H3)** :
- <topic 1>
- <topic 2>
…

**Questions FAQ (→ H3 sous H2 FAQ)** :
- <question 1>
- <question 2>
…

### Ton & style
**Ton** : <tone 1>, <tone 2>, …
**Style** : <règles de style>

### Value proposition
<résumé 2-3 lignes de la VP du brief>
```

## Phase 4 — EEAT scoring grid

```markdown
| Critère EEAT 2025 | Score /5 | Justification | Action corrective |
|---|---|---|---|
| Experience (first-hand signals) | 3 | Marqueurs métier prévus mais pas de signal personnel | Injecter 3-4 "In practice…" + 1 cas industrie cité |
| Expertise (vocabulaire, entities) | 4 | 14/20 entities citables, vocabulaire métier maîtrisé | OK |
| Authoritativeness (sources, data) | 3 | 2 standards industrie identifiés, données partiellement sourcées | Ajouter 2 sources, marquer `[SOURCE TO ADD]` pour les chiffres non sourcés |
| Trustworthiness (transparence) | 4 | Présentation équilibrée, mention durabilité | OK |
| **Total** | **14/20** | | |

| Helpful Content | Verdict |
|---|---|
| People-first (gap concurrents comblé) | PASS — 2 topics sous-couverts identifiés |
| Satisfying experience (FAQ exhaustive) | PASS |
| AI disclosure | N/A (responsabilité du publisher) |
| **Verdict global** | **PASS** |

### Itération nécessaire
Score < 16. Itération 1 : appliquer les actions correctives sur Experience et Authoritativeness. Re-scorer.

[Tableau re-scoré après itération]

| Critère EEAT 2025 | Score /5 |
|---|---|
| Experience | 4 |
| Expertise | 4 |
| Authoritativeness | 4 |
| Trustworthiness | 4 |
| **Total** | **16/20 ✅** |
```

## Phase 5 — Hx architecture template

```markdown
### Arborescence Hx proposée

H1: <titre principal — keyword + angle différenciant>

H2: <section 1 — topic du brief>
  H3: <sous-section>
  H3: <sous-section>

H2: <section 2 — topic du brief>
  H3: <sous-section>
    H4: <détail technique si pertinent>
  H3: <sous-section>

[… toutes les sections H2 + H3 …]

H2: FAQ
  H3: <question 1 du brief>
  H3: <question 2 du brief>
  H3: <question 3 du brief>
  H3: <question 4 du brief>
  H3: <question 5 du brief>

H2: Conclusion
```

**Auto-check avant checkpoint** :
- [ ] Tous les `key_subjects` du brief sont couverts par au moins un H2 ou H3.
- [ ] Toutes les `questions` du brief sont en H3 dans la section FAQ.
- [ ] Le H1 inclut le keyword principal (`brief.query` ou variante).
- [ ] Au moins 3 H2 ont un titre qui reflète un 3-gram Lumenia (intégration naturelle).
- [ ] La profondeur (nombre de H2/H3) bat la médiane des concurrents.

## Phase 6 — Output contract

### Fichier 1 : `<query-slug>.md`

Structure complète Markdown, dans `brief.language`. Pas de frontmatter par défaut — meta tags vivent dans le `.meta.json`. Si l'utilisateur veut un frontmatter (ex: Hugo, Astro, MDX), il le demandera explicitement.

```markdown
# <H1>

<intro 2-4 paragraphes — contient le keyword, situe l'angle, annonce la VP>

## <H2 section 1>

<contenu>

### <H3 sous-section>

<contenu>

[… toute la structure de Phase 5 …]

## FAQ

### <question 1>

<réponse 3-5 lignes>

### <question 2>

<réponse 3-5 lignes>

[… toutes les questions …]

## Conclusion

<conclusion 2-3 paragraphes — rappelle la VP, donne une perspective>
```

### Fichier 2 : `<query-slug>.meta.json`

```json
{
  "meta_title": "string ≤ 60 chars, inclut le keyword principal",
  "meta_description": "string ≤ 155 chars, CTA implicite",
  "slug": "<query-slug>",
  "word_count": 5230,
  "lumenia_coverage": {
    "top_terms": [
      { "term": "jewellery", "integrated": true, "occurrences": 18 },
      { "term": "jewelers", "integrated": true, "occurrences": 5 },
      { "term": "chainmaking", "integrated": false, "occurrences": 0 }
    ],
    "two_grams": [
      { "term": "jewellery making", "integrated": true }
    ],
    "three_grams": [
      { "term": "jewellery process production", "integrated": false }
    ],
    "named_entities": [
      { "entity": "MKM Jewelry", "cited": true },
      { "entity": "Computer Aided Manufacture", "cited": true },
      { "entity": "Japan", "cited": false }
    ],
    "summary": {
      "top_terms_integrated_pct": 76,
      "two_grams_integrated_pct": 70,
      "three_grams_integrated_pct": 45,
      "named_entities_cited_pct": 65
    }
  }
}
```

**`integrated` / `cited`** : déterminé après rédaction. Le `occurrences` n'est rempli que pour les top terms (les n-grams et entities sont binaires : présents ou pas).

**Cible de couverture** : top_terms ≥ 70%, two_grams ≥ 60%, three_grams ≥ 30% (les 3-grams sont plus durs à intégrer naturellement, c'est OK d'en omettre), entities ≥ 60%. Si une valeur est sous la cible, signaler dans le récap final.

### Fichier 3 : `<query-slug>.workflow.md`

Trace lisible des Phases 1 à 5. Format :

```markdown
# Workflow seo-eeat — <query>

**Date** : <YYYY-MM-DD>
**Inputs** : <chemin dossier Lumenia> + <N> URLs

## Phase 1 — Déconstruction concurrentielle
[Tableau competitors + synthèse 200 mots]

## Phase 2 — Analyse Lumenia
[Top terms top 20 + n-grams + entities + grammage cible]

## Phase 3 — Analyse brief
[Intent + topics + questions + ton + VP]

## Phase 4 — Jugement EEAT
[Grille scoring + verdict Helpful Content + itérations]

## Phase 5 — Architecture Hx
[Arborescence complète]
```

Cette trace sert à itérer plus tard : si l'utilisateur veut produire une v2 de la page sur la même query (ex: après 6 mois), il peut relire ce workflow sans rejouer toute la déconstruction.

## Récap final à présenter à l'utilisateur

Après l'écriture des 3 fichiers, annoncer en 4-5 lignes :

```
✅ Page SEO produite.
   - <query-slug>.md (XXXX mots — cible YYYY ± 5%)
   - <query-slug>.meta.json (couverture Lumenia : XX% top terms, XX% entities)
   - <query-slug>.workflow.md (audit Phases 1-5)
   
   Score EEAT final : XX/20 + Helpful Content : PASS
   ⚠️ <N> marqueurs [SOURCE TO ADD] à compléter manuellement avant publication.
```