De l'idée au site personnel
Objectif
Transformer une demande de site personnel ou de blog, de l'idée initiale à un site statique local validé, et éventuellement à une URL publiée en direct.
Il s'agit du pipeline de bout en bout orienté utilisateur. Il doit choisir et chaîner les compétences spécialisées existantes, appliquer des portes de validation après chaque étape, réparer les échecs en les routant vers la plus petite compétence responsable, et ne s'arrêter que lorsque le résultat demandé est effectivement atteint ou bloqué par une action utilisateur/manquante.
Contrat
Entrées :
- Idée utilisateur, URL de référence, modèle, capture d'écran, style cible, documents d'identité personnelle, dossier du site, brouillons de contenu et cible de publication optionnelle.
- Dossier de sortie optionnel, plateforme de déploiement, état du dépôt/compte et domaine personnalisé.
Sorties :
- Un site statique local terminé ou un site existant mis à jour.
- Déploiement en direct optionnel ou étapes/configuration exactes de la plateforme lorsque le déploiement nécessite une action du compte utilisateur.
- Une transition concise avec la route utilisée, le dossier du site, l'aperçu ou l'URL en direct, la validation effectuée, les fichiers modifiés et le contenu restant modifiable par l'utilisateur.
Limites :
- Ne pas implémenter les détails des sous-compétences directement lorsqu'une compétence spécialisée s'applique.
- Ne pas publier, pousser, créer de dépôts/projets, lier des domaines ou modifier le DNS à moins que l'utilisateur n'ait explicitement demandé cette action à distance.
- Ne pas sauter la validation après la génération, la recréation, la personnalisation, l'importation postérieure, les modifications larges ou avant le déploiement.
- Ne pas inventer de données personnelles détaillées lorsque les documents utilisateur sont manquants ; utiliser des espaces réservés modifiables et les documenter.
Porte de succès :
- Le site atteint le point final demandé par l'utilisateur : site local validé, paquet prêt à publier ou URL en direct vérifiée.
- Toutes les portes d'étape pertinentes sont passées, ou les risques non résolus sont explicites et acceptés par l'utilisateur.
Si la porte échoue :
- Router l'échec vers la plus petite compétence responsable.
- Réexécuter la validation affectée.
- Demander à l'utilisateur uniquement en cas de contenu manquant, d'identifiants manquants, de permissions de compte, de ressources indisponibles ou d'actions de plateforme externe empêchant la progression.
Compétences enfants
Utiliser les compétences installées comme blocs de construction :
search-blog-themepour une direction peu claire, la découverte de style ou la sélection de référence.find-style-referencespour ancrer une direction choisie dans des sites web réels, des modèles, des captures d'écran et un cahier des charges de design prêt à construire.make-personal-sitepour la génération originale d'un site statique sans dépendances.copy-website-stylepour recréer un site web, un modèle, une capture d'écran ou un système visuel spécifique.personalize-sitepour remplacer les espaces réservés, l'identité copiée, les métadonnées, les liens et le contenu de profil.add-blog-postspour importer du Markdown, des notes Obsidian, des brouillons Word, des articles anciens, des ressources, des maths, des liens et du contenu d'articles riches.edit-site-partpour des réparations ciblées ou de petits ajustements locaux découverts pendant la boucle.review-static-sitepour une validation déterministe et par navigateur.publish-static-sitepour la préparation à la publication ou le déploiement.build-personal-siteuniquement lorsqu'une décision de route de plus bas niveau est nécessaire.
Ne pas charger toutes les compétences enfants à l'avance. Charger la prochaine compétence enfant uniquement lorsque le pipeline atteint cette étape.
Pipeline par défaut
Utiliser cette boucle fermée pour les demandes larges « de l'idée au site » ou « blog personnel en un clic » :
-
Clarifier le point final. Entrée : demande utilisateur et documents disponibles. Sortie : plan de route et point final attendu : site local, site prêt à publier ou déploiement en direct. Porte : le type de site, les entrées disponibles et le point d'arrêt sont suffisamment clairs pour agir.
-
Choisir une direction. Entrée : idée, goût, exemples, audience ou document de référence. Sortie : direction visuelle/site spécifique. Porte : la direction est suffisamment concrète pour construire. Si peu clair : utiliser
search-blog-theme. -
Ancrer le style dans des références. Entrée : direction choisie, mots-clés de thème ou exemples utilisateur. Sortie : ensemble de références concrètes et cahier des charges de design prêt à construire. Porte : le cahier des charges est ancré dans plusieurs angles de recherche et au moins 3 références solides inspectées lorsque possible, et est suffisamment spécifique pour construire. Utiliser
find-style-referencesavant les constructions originales, sauf si l'utilisateur a fourni un site web de référence spécifique pour une recréation fidèle. -
Créer ou recréer le site. Entrée : direction ou URL de référence/capture d'écran/modèle. Sortie : dossier de site statique avec pages représentatives et
EDITING.md. Porte : les types de pages requis existent et la navigation pointe vers des pages réelles. Utilisermake-personal-sitepour les sites originaux. Utilisercopy-website-stylepour les références spécifiques. -
Personnaliser le contenu. Entrée : site généré plus identité utilisateur, bio, liens, projets, avatar, CV ou documents de profil fournis. Sortie : le contenu et les métadonnées du site reflètent l'utilisateur, avec l'identité de la source copiée supprimée. Porte : les informations fournies par l'utilisateur apparaissent dans les zones prévues et les résidus source/démo ont disparu. Utiliser
personalize-sitelorsque le remplacement d'identité ou d'espace réservé est nécessaire. -
Ajouter de l'écriture. Entrée : site généré ou existant plus brouillons d'articles, notes, Markdown, fichiers Word, dossiers d'images, maths, citations et liens. Sortie : pages d'articles/détails, index mis à jour, ressources copiées et notes spécifiques aux articles. Porte : les articles s'affichent avec des liens fonctionnels, des ressources, des maths, du code et une mise en page réactive. Utiliser
add-blog-postslorsque du contenu rédactionnel est fourni. -
Valider. Entrée : racine du site statique, périmètre de pages attendu, chaînes sources interdites et URL de référence optionnelle. Sortie : rapport de succès/échec ou corrections. Porte :
review-static-sitene présente aucun blocage pour les chemins, l'encodage, les résidus de confidentialité, les types de pages, le rendu du navigateur, les erreurs console/réseau ou l'utilisabilité mobile. Si la porte échoue : corriger avec la plus petite compétence enfant, puis réexécuter la validation affectée. -
Publier ou préparer. Entrée : racine statique validée plus plateforme souhaitée ou contraintes de compte. Sortie : paramètres de déploiement/config, étapes manuelles ou URL en direct. Porte : la racine de déploiement est correcte et le site en direct ou préparé utilise le bon dossier. Utiliser
publish-static-siteuniquement lorsque l'utilisateur a demandé à publier, déployer ou préparer la publication. -
Transition. Entrée : site terminé et résultats de validation/déploiement. Sortie : résumé final concis avec l'emplacement du site, comment le prévisualiser ou l'ouvrir, ce qui a été validé et ce que l'utilisateur peut modifier ensuite.
Raccourcis de routage
- Idée vague uniquement :
search-blog-theme->find-style-references->make-personal-site->review-static-site. - Direction choisie :
find-style-references->make-personal-site->personalize-sitesi nécessaire ->review-static-site. - Site web/modèle/capture d'écran de référence :
copy-website-style->personalize-site->review-static-site. - Site existant plus documents d'identité :
personalize-site->review-static-site. - Site existant plus articles :
add-blog-posts->review-static-site. - Site existant plus une modification précise :
edit-site-part-> validation navigateur affectée, etreview-static-sitesi la structure partagée a changé. - Demande de publication :
review-static-site->publish-static-site. - Demande complète de l'idée à la publication : choisir direction -> trouver références -> créer/recréer -> personnaliser -> ajouter des articles si fournis ->
review-static-site->publish-static-site.
Valeurs par défaut « un clic »
Lorsque l'utilisateur demande un site complet mais laisse des choix ouverts :
- Par défaut, HTML/CSS/JS statique simple pour cette version.
- Par défaut, dossier de sortie vers le dossier demandé par l'utilisateur, sinon un dossier
site/local clair dans l'espace de travail. - Par défaut, un premier écran utile, pas une page d'accueil marketing.
- Par défaut, des espaces réservés modifiables pour les données personnelles manquantes.
- Par défaut, recherche de références de style réelles avant de construire à partir de mots de goût.
- Par défaut, chemins relatifs à la page pour la compatibilité avec l'ouverture directe, le serveur HTTP local et le déploiement sur sous-chemin.
- Par défaut, validation et aperçu locaux avant toute étape de publication.
- Par défaut, conseils pour Cloudflare Pages ou GitHub Pages pour la publication statique simple si l'utilisateur demande où publier mais n'a pas de préférence.
Boucle de validation
Après chaque étape :
- Vérifier la porte de l'étape.
- Si elle passe, continuer.
- Si elle échoue, router vers la plus petite compétence enfant capable de la corriger.
- Réexécuter uniquement la validation concernée.
- Continuer jusqu'à ce que le point final soit atteint ou qu'un blocage externe persiste.
Gestion courante des blocages :
- Informations personnelles manquantes : conserver des espaces réservés neutres et les documenter, sauf si l'utilisateur souhaite faire une pause.
- Ressources d'articles manquantes : conserver l'article, marquer les ressources manquantes dans
EDITING.mdet les signaler. - Connexion ou autorisations de plateforme manquantes : préparer les étapes exactes de publication au lieu de simuler un déploiement.
- Blocages de confidentialité ou de chemins : corriger avant la publication.
Rapport final
Garder le rapport final court :
- Route utilisée.
- Dossier du site.
- URL d'aperçu, fichier local ou URL en direct.
- Pages/principaux contenus créés ou mis à jour.
- Validation effectuée.
- Statut de publication et toute action utilisateur requise.
Ne pas coller de longs journaux d'audit sauf si l'utilisateur le demande.