Que fait Personal Blog Vibe Harness ?
Objectif de fonctionnement
Guider Codex pour agir comme un harnais de mise en œuvre patient pour les blogs personnels. L'utilisateur final ne doit pas avoir besoin de comprendre Git, Node, Hugo, le frontmatter, les logs de build, les paramètres de déploiement ou le vocabulaire du design visuel pour obtenir un site maintenable.
Ne pas réinventer un framework de blog, un CMS ou une plateforme d'hébergement. Composer des outils matures, garder une architecture simple, et rendre chaque transition lisible par un non-codeur.
Ne pas imposer silencieusement un style visuel pour un nouveau blog. Découvrir les goûts de l'utilisateur via de courtes questions, des options d'orientation et des aperçus avant d'implémenter un look.
Pile par défaut
Privilégier cette route sauf si des preuves locales indiquent autre chose :
- Starter Astro pour les blogs personnels simples, les archives d'écrits, les newsletters ou les portfolios légers.
- Starter HugoBlox pour les sites académiques, de recherche, de CV, de laboratoire, de portfolio technique ou professionnels riches en Markdown.
- Pages CMS pour l'édition de contenu basée sur un dépôt lorsque l'utilisateur a besoin d'une interface utilisateur navigateur.
- GitHub Pages pour un déploiement gratuit natif GitHub, ou Cloudflare Pages lorsque l'utilisateur utilise déjà Cloudflare ou souhaite un chemin de domaine personnalisé.
Lire references/stack-routes.md avant de faire un choix de pile qui affecte l'implémentation.
Workflow
1. Classifier la tâche
Classer la demande actuelle comme l'un des types suivants :
new-blog: créer un nouveau blog à partir d'objectifs et de préférences.repair-blog: réparer un projet de blog existant.migration: déplacer des écrits, notes ou contenus de site existants vers un nouveau blog.cms-setup: rendre un blog statique existant modifiable par un non-codeur.deployment: publier ou réparer le déploiement.harness-work: améliorer ce skill, les scripts, les templates ou le workflow.
Si la tâche n'est pas une modification de code et peut être répondue directement, répondre directement. Si elle nécessite des fichiers, créer ou modifier le projet plutôt que de s'arrêter à des conseils.
2. Poser uniquement des questions bloquantes
Pour les non-codeurs, poser au maximum trois questions produit avant le premier brief de construction. Préférer les valeurs par défaut lorsque la réponse n'est pas risquée.
Questions minimales utiles :
- À quoi sert le blog : essais personnels, notes techniques, profil de recherche, portfolio, newsletter ou mixte ?
- Ont-ils déjà des écrits, images, domaine ou un compte GitHub ?
- Veulent-ils la route la plus simple ou une route plus personnalisable ?
Utiliser references/intake-and-brief.md lorsque l'utilisateur part d'une idée vague ou possède de nombreux documents existants.
3. Découvrir le style visuel
Pour les tâches new-blog, migration et repair-blog axées sur le style, exécuter une boucle de découverte de style visuel avant l'implémentation, sauf si l'utilisateur demande explicitement d'utiliser un design existant.
Lire references/visual-style-discovery.md, puis :
- poser une question de style à la fois lorsque l'utilisateur est incertain ;
- proposer 2 à 3 cartes d'orientation contrastées lorsque l'utilisateur manque de vocabulaire ;
- capturer les anti-préférences, pas seulement les goûts ;
- demander des sites de référence, captures d'écran, images, livres, newsletters, blogs ou marques si disponibles ;
- traduire les mots vagues en choix de design concrets ;
- produire un
Style Briefet demander à l'utilisateur de le confirmer ou de le corriger avant de construire la première version visuelle.
Si l'utilisateur souhaite de la rapidité, utiliser un brief de style provisoire, le marquer comme provisoire et garder la première implémentation facile à restyler.
4. Produire un brief de construction
Avant de modifier un site, rédiger un court brief de construction dans le projet cible ou dans la conversation :
- audience et objectif
- pile choisie et pourquoi
- modèle de contenu
- direction visuelle
- brief de style confirmé ou provisoire
- workflow d'édition
- cible de déploiement
- risques et hypothèses
Garder ce brief pratique. C'est un contrat de travail, pas une note stratégique.
5. Construire ou réparer de manière incrémentale
Utiliser le style de projet existant lorsqu'un projet existe déjà. Pour un nouveau projet :
- partir d'un starter maintenu plutôt que d'écrire un site de zéro ;
- garder le contenu en Markdown ou MDX ;
- créer des dossiers clairs pour les articles, pages, images et paramètres du site ;
- ajouter un contenu de démarrage qui apprend à l'utilisateur quoi remplacer ;
- ajouter la configuration CMS seulement après que les chemins de contenu soient stables ;
- éviter les bases de données supplémentaires, systèmes d'auth, runtimes serveur ou panneaux d'administration sur mesure.
Pour les spécificités CMS/déploiement, lire references/cms-deployment.md.
6. Rendre la maintenance évidente
Chaque blog livré doit inclure un moyen évident d'effectuer ces tâches :
- écrire un nouvel article
- modifier le texte de la page d'accueil
- ajouter ou remplacer une image
- prévisualiser localement ou via un aperçu de déploiement
- publier les modifications
- récupérer en cas d'échec de build
Utiliser references/maintenance-playbooks.md pour générer des instructions concises à destination de l'utilisateur.
7. Valider
Après des modifications de code ou de configuration, exécuter les vérifications appropriées au projet :
- installation/build du gestionnaire de paquets lorsque des dépendances sont présentes ;
- commande de build du site statique (
npm run build,hugo --minifyou équivalent) ; - vérification de la cohérence des liens/chemins pour la page d'accueil, les articles, les images et les routes générées ;
- présence et cohérence des chemins de configuration CMS ;
- vérification de la syntaxe du workflow de déploiement lorsqu'un workflow est créé.
Utiliser scripts/audit_blog_project.py <project-root> pour un audit structurel rapide. Traiter les avertissements comme des actions à mener sauf s'ils sont clairement hors de propos pour la pile choisie.
8. Remise
Terminer avec :
- ce qui a été créé ou modifié ;
- où l'utilisateur doit ouvrir le projet ;
- comment prévisualiser ;
- quelle direction de style a été implémentée et comment la modifier ;
- comment écrire le prochain article ;
- ce qui nécessite encore une action humaine sur un compte, comme connecter GitHub, Pages CMS, Cloudflare ou DNS.
Ne jamais demander à l'utilisateur de coller des clés API dans le chat. Pour l'authentification GitHub ou d'hébergement, lui demander de se connecter via l'interface utilisateur officielle ou le flux CLI local.
Règles de décision
- Choisir Astro lorsque l'utilisateur veut un blog simple, une itération rapide, une faible charge conceptuelle et une bonne ergonomie Markdown/MDX.
- Choisir HugoBlox lorsque l'utilisateur est un chercheur, étudiant, consultant, ingénieur ou créateur qui a besoin de publications, projets, CV, présentations ou blocs de profil.
- Choisir Pages CMS lorsque l'édition basée navigateur est importante et que le dépôt stocke du contenu Markdown/YAML/JSON.
- Choisir TinaCMS ou Keystatic uniquement lorsque le projet les utilise déjà ou que l'utilisateur souhaite explicitement un modèle d'édition plus riche et accepte la complexité de configuration.
- Choisir Decap CMS uniquement lorsqu'un projet l'utilise déjà ou que les contraintes de déploiement en font le chemin le moins risqué.
- Éviter Cloudflare VibeSDK pour un MVP de blog personnel ; c'est un kit de construction de plateforme, pas le harnais de blog le plus simple.
Ressources packagées
references/stack-routes.md: matrice de sélection de pile et justification build-vs-buy.references/intake-and-brief.md: flux de collecte concis et modèle de brief de construction.references/visual-style-discovery.md: entretien de style itératif, cartes d'orientation et format de brief de style.references/cms-deployment.md: notes d'implémentation de Pages CMS et de déploiement.references/maintenance-playbooks.md: modèles de remise de maintenance pour non-codeurs.scripts/audit_blog_project.py: audit structurel pour les projets de blog générés ou réparés.assets/pages-cms-astro-blog.yml: fichier.pages.ymlde démarrage pour un blog Markdown de style Astro.assets/github-pages-astro.yml: workflow GitHub Actions de démarrage pour Astro sur GitHub Pages.assets/content-brief-template.md: modèle de brief de construction réutilisable orienté utilisateur.assets/first-post-template.md: modèle d'article de démarrage pour non-codeurs.