Communitygithub.com

wuongg/wait_skills

Contrat de transfert entre `landing-page-composition-architect` (planificateur) et `cinematic-landing-page` (constructeur). Définit le schéma du Blueprint JSON, le mapping famille de mise en page → archétype visuel, les invariants que le constructeur doit préserver, et les modes d'échec que les deux parties doivent refuser.

Qu'est-ce que wait_skills ?

Cette compétence définit le contrat d'intégration entre deux agents spécialisés dans la création de pages d'atterrissage : un planificateur (`landing-page-composition-architect`), qui décide de la structure et de l'ordre des sections, et un constructeur (`cinematic-landing-page`), qui s'occupe de l'apparence visuelle, des animations et du code. Le contrat centralise le format du Blueprint JSON (un artefact verrouillé décrivant l'intention, les sections, les règles de rythme, etc.), le mappage entre les familles de mise en page et les archétypes visuels (A-F), ainsi que les invariants que le constructeur doit respecter (ordre des sections, poids visuels, règles de budget d'animation). Cette compétence s'applique lors de tout transfert de blueprint planificateur → constructeur, ou lorsque le constructeur s'apprête à coder une page sans blueprint verrouillé. Les plateformes cibles sont les agents LLM (Claude Code, Cursor, etc.) dans un pipeline de génération de pages web. Le fonctionnement repose sur des règles strictes : le planificateur émet un blueprint verrouillé, le constructeur le valide via une checklist, puis génère un Build Spec avant de coder. Tout manquement déclenche un protocole de révision structuré pour éviter les dérives.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wuongg/wait_skills/tree/HEAD/.cursor/skills/landing-page-skills-integration

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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: true est 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)RepliNotes
full-bleed heroA (Hero à vue fixe)BVariante cadre-toile si ambiance = premium
split heroA (motif : split)DTexte à gauche / média à droite
centered statementSection D OU A (centré)—Faible animation, haute lisibilité
benefit railRangée de cartes D—3–4 éléments, pas de cartes plus lourdes qu'icône+titre+ligne
card gridGrille D—Max 6 tuiles ; désactiver l'animation au survol en I3
staggered stackSection asymétrique DBRangées alternées image/texte
editorial blockÉditorial DF (si type d'affichage)Long format ; éviter l'interface carte
mood galleryB (défilement fixe) ou E (commutateur)—Choisir selon le rythme : lent→B, équilibré→E
logo stripRangée discrète D—Pas d'animation au-delà du défilement si demandé
metric bandRangée de grands chiffres D—Animation de comptage uniquement si rythme ≠ lent
quote panelD ou A scène unique—Une citation unique > carrousel
accordion listAccordéon D—Interdit pour I3 (voir kill list)
CTA bandCTA centré DALe CTA principal vit ici
sticky footer CTAPied de page collant D—Uniquement si rythme = rapide
soft footerPied 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_note du 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) :

IntentionArchétype dominantDeuxième archétype (optionnel)
I1 LancementAE
I2 ConversionA (split)— (rester discret)
I3 Marque ÉditorialeF ou BE
I4 PortfolioF ou CB
I5 Histoire ProduitA + B (histoire par défilement)—
I6 Campagne / TeaserA 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 visuelBudget d'animation
très élevéjusqu'à 2 interactions de signature
élevé1 interaction de signature
moyenmicro-interactions uniquement (survol, petits fondus)
faiblefondus uniquement
très faiblestatique

T4. Rôle CTA → traitement de surface.

Rôle CTATraitement
principalbouton complet + formulaire/ancre, contraste élevé
durbouton, contraste élevé, pas de formulaire
douxlien texte avec flèche
aucunaucun élément CTA rendu

T5. Émotion → mapping d'ambiance (indicatif).

primary_emotion (planificateur)Ambiance suggérée (constructeur)
révérence, calme, luxeCinématographique sombre / Verre doux
clarté, confiance, précisionMinimaliste lumineux / Neo-Tech
chaleur, humain, histoireÉditorial chaleureux / Éditorial lumineux
énergie, urgence, hypeNeo-Tech / Cinématographique sombre

T6. Rythme → longueur de défilement.

RythmeDéfilement total (desktop)
rapide≤ 2,5 viewports
équilibré3–5 viewports
lent5–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 index sont consécutives, en commençant par 1.
  • Aucune section ajoutée, supprimée, réordonnée ou fusionnée.
  • layout_family par 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_list n'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_required que 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 principal en doux.

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: true sur 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés