WordPress Theme to EmDash

Porter des thèmes WordPress vers EmDash en six phases. Lisez le fichier de phase avant de commencer chaque phase.

Critical Rules

1. Copier le scaffold d'abord - Commencez chaque thème en copiant scaffold/ depuis cette skill
2. Prendre des captures d'écran de la démo - Identifiez l'URL de démo et capturez tous les types de pages avec agent-browser avant de commencer
3. Pas de contenu en dur - Utilisez getSiteSettings() pour titre/tagline, getMenu() pour la navigation
4. Pages rendues côté serveur - N'utilisez jamais getStaticPaths() pour le contenu EmDash
5. Astro 6 - Utilisez ClientRouter au lieu de ViewTransitions, syntaxe Zod 4, Node 22+
6. Utiliser le composant Image emdash - Pour toutes les images, importez Image depuis "emdash/ui"

Phases

Checklist

Setup

• [ ] Copier scaffold/ vers le nouveau répertoire de thème. Sauf indication contraire de l'utilisateur, faites-en un sous-répertoire de themes/ et nommez-le d'après le thème WordPress (ex : themes/twentytwentyfour/).
• [ ] Renommer le dossier, mettre à jour package.json
• [ ] Vérifier la build : pnpm build

Phase 1 : Discovery

• [ ] Source du thème téléchargée
• [ ] Site de démo identifié
• [ ] Dossier discovery/ créé avec screenshots/, images/, notes.md
• [ ] Tous les types de pages capturés
• [ ] Images d'exemple téléchargées

Phase 2 : Design

• [ ] Variables CSS dans global.css
• [ ] Polices chargées
• [ ] Couleurs correspondant à la démo

Phase 3 : Templates

• [ ] Accueil, article unique, archive, catégorie, tag, page, 404
• [ ] Composants extraits (PostCard, etc.)

Phase 4 : Dynamic

• [ ] Paramètres site (titre, tagline, logo depuis CMS)
• [ ] Menus de navigation (depuis CMS, pas en dur)
• [ ] Taxonomies
• [ ] Zones de widget (si applicable)

Phase 5 : Seed

• [ ] Fichier seed créé avec images de démo à .emdash/seed.json (ou connecté via package.json#emdash.seed)

Phase 6 : Verify

• [ ] Serveur dev applique le seed proprement au premier chargement (pas d'erreurs de validation dans les logs)
• [ ] Captures d'écran de sortie capturées
• [ ] Comparaison visuelle effectuée
• [ ] Build réussit : pnpm build
• [ ] Fichier LICENSE téléchargé (GPL-2.0 dans la plupart des cas)
• [ ] README crédite le thème original

Reference Documents

• references/astro-essentials.md - Patterns Astro 6
• references/template-patterns.md - Conversion PHP → Astro
• references/concept-mapping.md - Concepts WP → EmDash
• references/emdash-api.md - Référence API complète
• references/design-extraction.md - Techniques d'extraction CSS