Compétences pour page d'atterrissage — Contrat d'intégration v1
Deux compétences, un pipeline :
Brief utilisateur
│
▼
[ landing-page-composition-architect ] ← décide QUOI & ORDRE
│ émet : Composition Blueprint (verrouillé)
▼
[ INTEGRATION.md ← ce fichier ] ← traduit blueprint → spécification de construction
│ émet : Build Spec (archétype + animation + stack)
▼
[ cinematic-landing-page ] ← décide APPARENCE & MOUVEMENTS, écrit le code
│
▼
Page livrée
Règle d'or. Le planificateur possède la structure. Le constructeur possède la surface. Aucun des deux ne peut franchir la ligne. Ce fichier est leur garde-fou.
1. L'ARTEFACT DE TRANSFERT — Composition Blueprint (JSON)
L'artefact final du planificateur DOIT pouvoir être rendu sous ce format JSON, même s'il a été présenté à l'utilisateur sous forme de tableau. Le constructeur lit ce JSON textuellement.
{
"blueprint_version": "1.0",
"page": {
"intent": "I1 | I2 | I3 | I4 | I5 | I6",
"intent_name": "Lancement | Conversion | Marque | Portfolio | Histoire Produit | Campagne",
"awareness": "froid | tiède | chaud",
"traffic": "annonces | organique | social | referral | direct",
"narrative_spine": "Accroche -> Valeur -> Preuve -> CTA",
"pace": "rapide | équilibré | lent",
"density": "minimal | équilibré | riche",
"primary_emotion": "chaîne (un mot)",
"total_sections": 5
},
"sections": [
{
"index": 1,
"slot": "S1",
"name": "Hero",
"jtbd": "attirer l'attention + donner le ton",
"why_here": "première impression",
"layout_family": "full-bleed hero",
"content_required": ["headline", "subcopy", "hero_media"],
"visual_weight": "très élevé",
"cta_role": "soft"
}
],
"rhythm_rules": [
"Deux sections de poids 'très élevé' ne peuvent pas être adjacentes.",
"Après un hero full-bleed ou une galerie d'ambiance, la section suivante doit être un bloc éditorial ou une déclaration centrée.",
"Le CTA principal apparaît exactement une fois."
],
"kill_list": [
"Pas de FAQ",
"Pas de grille de 6 cartes",
"Pas de bande de métriques"
],
"handoff_note": "Un paragraphe : émotion à préserver, quels slots veulent un traitement cinématographique, lesquels restent sobres.",
"locked": true
}
Invariants.
sections.length∈ [4, 9] ; 5–8 pour les intentions standard.- Chaque
slot∈{S1..S16}, unique par page. layout_family∈ liste fermée (voir §3).locked: trueest une promesse : le constructeur NE DOIT PAS réordonner, ajouter, supprimer ou renommer les sections.
2. CE QUE LE CONSTRUCTEUR PEUT DÉCIDER (et ce qu'il ne PEUT PAS)
Le constructeur PEUT décider
- Archétype cinématographique (A/B/C/D/E/F de
cinematic-landing-page). - Signatures d'animation, courbes d'assouplissement, comportement de défilement.
- Ambiance colorimétrique, typographie, échelle d'espacement.
- Traitement des médias (grain, flou, cadrage, découpes).
- Stack technique (V1 vanilla ou V2 React+Vite+Tailwind).
- Peaufinage de la micro-copie (à condition de préserver l'intention).
Le constructeur NE PEUT PAS décider
- Le nombre de sections.
- L'ordre des sections.
- Quel slot correspond à quelle position.
- Si une section existe ou non.
- Renommer le but d'un slot (le nom visible par l'utilisateur peut changer ; le JTBD ne change pas).
- Ajouter des sections qui ne sont pas dans le blueprint (pas de bannière CTA surprise, pas de bloc newsletter surprise).
- Supprimer le CTA principal ou le dupliquer.
Si le constructeur estime que le blueprint est erroné, il doit s'arrêter et demander une re-planification, sans mutation silencieuse.
3. MAPPING FAMILLE DE MISE EN PAGE → ARCHÉTYPE VISUEL
Le planificateur parle en familles de mise en page. Le constructeur parle en archétypes cinématographiques (A–F). Voici la table de traduction.
| Famille de mise en page (planificateur) | Archétype principal (constructeur) | Repli | Notes |
|---|---|---|---|
full-bleed hero | A (Hero à vue fixe) | B | Variante cadre-toile si ambiance = premium |
split hero | A (motif : split) | D | Texte à gauche / média à droite |
centered statement | Section D OU A (centré) | — | Faible animation, haute lisibilité |
benefit rail | Rangée de cartes D | — | 3–4 éléments, pas de cartes plus lourdes qu'icône+titre+ligne |
card grid | Grille D | — | Max 6 tuiles ; désactiver l'animation au survol en I3 |
staggered stack | Section asymétrique D | B | Rangées alternées image/texte |
editorial block | Éditorial D | F (si type d'affichage) | Long format ; éviter l'interface carte |
mood gallery | B (défilement fixe) ou E (commutateur) | — | Choisir selon le rythme : lent→B, équilibré→E |
logo strip | Rangée discrète D | — | Pas d'animation au-delà du défilement si demandé |
metric band | Rangée de grands chiffres D | — | Animation de comptage uniquement si rythme ≠ lent |
quote panel | D ou A scène unique | — | Une citation unique > carrousel |
accordion list | Accordéon D | — | Interdit pour I3 (voir kill list) |
CTA band | CTA centré D | A | Le CTA principal vit ici |
sticky footer CTA | Pied de page collant D | — | Uniquement si rythme = rapide |
soft footer | Pied de page minimal D | — | Sortie calme en fin de page |
Limite d'archétypes par page.
- Maximum 2 archétypes de signature par page (hérité de la règle
cinematic-landing-page). - La section hero choisit l'archétype dominant. Les autres sections utilisent par défaut
un style D, sauf si la
handoff_notedu planificateur demande explicitement un traitement cinématographique pour elles.
Archétypes par défaut basés sur l'intention (quand le planificateur n'a pas donné d'indice) :
| Intention | Archétype dominant | Deuxième archétype (optionnel) |
|---|---|---|
| I1 Lancement | A | E |
| I2 Conversion | A (split) | — (rester discret) |
| I3 Marque Éditoriale | F ou B | E |
| I4 Portfolio | F ou C | B |
| I5 Histoire Produit | A + B (histoire par défilement) | — |
| I6 Campagne / Teaser | A ou F | — |
4. BUILD SPEC — l'artefact que le constructeur émet avant de coder
Avant d'écrire une seule ligne de code, le constructeur DOIT produire une Build Spec (dérivée du Blueprint). C'est le deuxième contrat du pipeline.
{
"build_spec_version": "1.0",
"blueprint_ref": "locked",
"stack": "V1 vanilla | V2 react-vite-tailwind",
"dominant_archetype": "A | B | C | D | E | F",
"second_archetype": "A | B | C | D | E | F | null",
"mood": "Cinématographique sombre | Éditorial chaleureux | Neo-Tech | Minimaliste lumineux | Éditorial lumineux | Verre doux",
"sections": [
{
"index": 1,
"slot": "S1",
"layout_family": "full-bleed hero",
"archetype": "A",
"pattern": "framed-canvas",
"motion": ["hero_fade_in_800ms", "subcopy_delay_200ms"],
"media": {"type": "image | video | none", "asset_ref": "…"},
"notes": "pourquoi cet archétype a été choisi pour ce slot"
}
],
"acceptance_criteria": [
"Premier viewport = composition S1 uniquement.",
"CTA principal dans S15 exactement une fois.",
"Pas de sections adjacentes de poids 'très élevé'.",
"Nombre d'animations sur la page <= 2 signatures."
]
}
Le constructeur valide la Build Spec par rapport au Blueprint (voir §6) AVANT de coder. Échec fermé.
5. RÈGLES DE TRADUCTION (planificateur → constructeur)
Appliquées dans l'ordre.
T1. L'ordre des sections est loi. sections[i].index dans le blueprint = position sur la
page. Le constructeur ne réordonne jamais.
T2. Éligibilité slot → archétype. Utiliser le tableau §3. Si une famille de mise en page apparaît dont l'archétype principal entre en conflit avec l'archétype dominant déjà choisi pour le hero, utiliser le repli.
T3. Poids → budget d'animation.
| Poids visuel | Budget d'animation |
|---|---|
| très élevé | jusqu'à 2 interactions de signature |
| élevé | 1 interaction de signature |
| moyen | micro-interactions uniquement (survol, petits fondus) |
| faible | fondus uniquement |
| très faible | statique |
T4. Rôle CTA → traitement de surface.
| Rôle CTA | Traitement |
|---|---|
| principal | bouton complet + formulaire/ancre, contraste élevé |
| dur | bouton, contraste élevé, pas de formulaire |
| doux | lien texte avec flèche |
| aucun | aucun élément CTA rendu |
T5. Émotion → mapping d'ambiance (indicatif).
| primary_emotion (planificateur) | Ambiance suggérée (constructeur) |
|---|---|
| révérence, calme, luxe | Cinématographique sombre / Verre doux |
| clarté, confiance, précision | Minimaliste lumineux / Neo-Tech |
| chaleur, humain, histoire | Éditorial chaleureux / Éditorial lumineux |
| énergie, urgence, hype | Neo-Tech / Cinématographique sombre |
T6. Rythme → longueur de défilement.
| Rythme | Défilement total (desktop) |
|---|---|
| rapide | ≤ 2,5 viewports |
| équilibré | 3–5 viewports |
| lent | 5–8 viewports |
T7. Densité → choix de composant.
- minimal → privilégier sections uniquement textuelles, grands espaces blancs.
- équilibré → mix texte + média.
- riche → lourd en blocs éditoriaux ; respecter toujours la kill list.
T8. La kill list est absolue. Tout ce qui se trouve dans kill_list est interdit dans la
Build Spec et le code, même si cela "aurait l'air cool".
6. GRILLE DE VALIDATION (exécutée avant toute écriture de code)
Le constructeur exécute cette checklist sur la Build Spec. Tout doit être validé.
- Chaque section du blueprint a exactement une ligne dans
build_spec.sections. - Les valeurs
indexsont consécutives, en commençant par 1. - Aucune section ajoutée, supprimée, réordonnée ou fusionnée.
-
layout_familypar ligne correspond au blueprint. - L'archétype dominant est utilisé par le hero (
index: 1). - Nombre total d'archétypes de signature sur la page ≤ 2.
- Somme des "interactions de signature" sur toutes les sections ≤ 2.
- Nombre de CTA principal = 1 (ou 0 si l'intention = I3 avec pied de page doux).
- Aucun élément de
kill_listn'est présent dans la spec. - La règle de notoriété est respectée : froid ⇒ S2 existe juste après S1.
- Pas d'adjacence interdite (S6+S9, S11+S13, etc.).
Échec → retourner au planificateur avec une revision_request (voir §7). Ne PAS coder
en contournant une validation échouée.
7. PROTOCOLE DE RÉVISION
Si le constructeur doit refuser, il émet une demande structurée, pas de texte libre :
{
"revision_request": {
"reason": "conflit_de_mise_en_page | ressource_manquante | budget_animation_depassé | kill_list_impossible | violation_adjacence",
"affected_sections": [3, 4],
"explanation": "un court paragraphe",
"suggested_fix": "échanger l'ordre de S6 et S9 | supprimer S13 | réduire le poids de S1 à élevé"
}
}
Le planificateur répond avec un nouveau blueprint verrouillé, pas une note de patch.
Les blueprints sont réémis entièrement, versionnés par incrémentation de blueprint_version.
8. MODES D'ÉCHEC QUE LES DEUX PARTIES DOIVENT REFUSER
Le planificateur doit refuser de :
- Émettre un blueprint non verrouillé.
- Émettre moins de 4 ou plus de 9 sections.
- Inclure un slot avec
content_requiredque l'utilisateur ne peut pas fournir. - Réutiliser un ID de slot.
- Sauter S1 ou (généralement) S15.
- Choisir une famille de mise en page en dehors de la liste fermée du §3.
Le constructeur doit refuser de :
- Coder sans blueprint verrouillé.
- Coder sans Build Spec ayant passé le §6.
- Ajouter une section "parce que la page semblait vide".
- Supprimer une section "parce qu'elle semblait redondante".
- Utiliser plus de 2 archétypes de signature.
- Ignorer la kill list.
- Rétrograder silencieusement un CTA
principalendoux.
Si un utilisateur demande directement une violation, répondre une fois avec le compromis,
puis ne se conformer que s'il confirme explicitement — et l'enregistrer dans la Build Spec
sous "user_override": true sur la ligne concernée.
9. EXEMPLE MINIMAL DE BOUT EN BOUT
Blueprint (sortie du planificateur, condensé)
- Intention : I2 Conversion, froid, annonces, rythme équilibré, densité équilibrée.
- Sections :
S1 → S2 → S4 → S5 → S6 → S12 → S13 → S15 - Kill list : pas de S8, pas de S9, pas de S14, pas de S11.
- Émotion principale : clarté.
Build Spec (sortie du constructeur, condensé)
- Stack : V2 (React + Vite + Tailwind + framer-motion).
- Archétype dominant : A (split hero). Deuxième archétype : aucun.
- Ambiance : Minimaliste lumineux.
- Budget d'animation utilisé : 2 / 2 (révélation du hero split + comptage de métriques).
- S1 = A split hero. S2 = D déclaration centrée. S4 = D bloc éditorial. S5 = D pile décalée. S6 = D grille de cartes (4 tuiles). S12 = D bande de métriques. S13 = D panneau de citation (citation unique). S15 = D bande CTA avec formulaire.
- Acceptation : CTA principal une fois (S15) ; pas d'adjacence S6/S9 ; défilement total ≈ 4 viewports.
Validation
Toutes les vérifications §6 passent. Le constructeur procède au codage.
10. QUE DIRE À L'UTILISATEUR (extraits de script)
Lors du transfert du planificateur :
"Blueprint verrouillé. Passer à la compétence de construction (
cinematic-landing-page) ? Cette compétence choisira l'archétype visuel + animations + code, sans changer l'ordre des sections."
Lorsque le constructeur rejette un blueprint :
"Ce blueprint présente un conflit dans la section {n} — {raison}. Je renvoie au planificateur pour publier une nouvelle version, au lieu de modifier moi-même."
Lorsque l'utilisateur insiste pour un dérogation :
"Si vous insister pour faire cela, je marquerai
user_override: truesur cette section. La page se construira quand même, mais la règle de rythme sera brisée — vous confirmez ?"
Fin du contrat d'intégration.