Construire un site client
La session principale exécute ce pipeline et délègue aux sous-agents. (Les sous-agents ne peuvent pas démarrer d'autres sous-agents, c'est pourquoi ceci est un skill, pas un agent orchestrateur.)
[0 Porte d'entrée du brief] brief + DESIGN.md + références
↓
[1 Plan] sitemap, sections de page, contenu → plan.md, src/data/*
↓
[PORTE UTILISATEUR 1] approuver le plan et le contenu
↓
[2 Construction] pages et système visuel
↓
[3 SEO] agent seo → seo-report.md
↓
[4 Vérification] npm run verify (porte stricte)
↓
[5 Révision] agent réviseur de site → review-report.md
↓
[6 Boucle de correctifs] P0/P1 → correction → vérification → re-révision (max 2 tours)
↓
[PORTE UTILISATEUR 2] approuver le site
↓
[7 Préparation au lancement] checklist de lancement + document de remise
↓
[8 Leçons] ajouter à docs/lessons.md
Artefacts
Tout se trouve dans .claude/pipeline/ :
pipeline-state.md étape, tour de correction, dernière mise à jour
plan.md sitemap, sections par page, action principale par page
review-report.md du site-reviewer
seo-report.md du seo
screenshots/ de npm run verify
Lire pipeline-state.md au début de chaque étape et reprendre là où il l'indique. Le mettre à jour à la fin de chaque étape. Cela permet à une construction de s'étendre sur plusieurs sessions.
Étape 0 : Porte d'entrée du brief
Vérifier chaque élément. Si l'un manque, s'arrêter et aider l'utilisateur à le remplir avant toute autre chose.
| Élément | Prêt quand |
|---|---|
.agents/product-marketing.md | La section des faits métier est complète, l'action principale nommée, l'audience et la voix renseignées. Utiliser le skill product-marketing pour le rédiger à partir de ce que l'utilisateur fournit. |
src/data/business.json | Le nom, le téléphone, l'adresse, les horaires, le lien Google Maps correspondent au brief. Les copier depuis le brief. |
DESIGN.md | Chaque section est remplie. Si l'utilisateur n'a que des références, le rédiger à partir de references/ et lui demander de confirmer. |
references/ | Au moins deux captures d'écran ou URL avec une ligne sur ce qu'il faut en tirer. |
| Actifs du client | Logo et photos, ou une note explicite indiquant que des substituts conviennent pour l'instant. |
| Édition | Le client modifiera-t-il le site lui-même ? (Affecte l'étape 7.) |
Ensuite, remplir src/styles/tokens.css à partir de DESIGN.md.
Étape 1 : Plan
- Écrire
plan.md: les pages (la plupart des clients ont besoin d'Accueil, une page par offre principale ou une page Menu/Services, À propos, Contact), l'action principale par page, et les sections de chaque page dans l'ordre. Utiliser le brief etsite-essentials. - Rédiger le contenu avec le skill
copywriting, puis exécutercopy-editingdessus. Partir du langage client du brief et des propres mots du client, et utiliser certaines de ces expressions presque textuellement. Suivre la règle maison 9 dans CLAUDE.md (pas de formulation IA générique). Le placer danssrc/data/(home.json, services, FAQs), pas dans les composants. - Marquer tout ce qui est inconnu comme
[NEED: ...]. Ne jamais combler un vide avec un fait inventé.
Porte utilisateur 1
S'arrêter. Montrer à l'utilisateur : le sitemap, les sections et l'action principale de chaque page, le contenu complet, et chaque élément [NEED: ...]. Attendre l'approbation ou les modifications. Le contenu est moins coûteux à modifier maintenant qu'après la construction.
Étape 2 : Construction
Construire avec le skill design-taste-frontend (Taste Skill), dans ce projet Astro. Avant de commencer, lui indiquer :
- Le type est
place(les gens viennent) ouservice(les gens sont embauchés), jamais un type technique. - DESIGN.md et
references/définissent la palette, la typographie et le ressenti. Sa propre palette et ses polices par défaut sont remplacées. - Les faits métier proviennent de
src/data/business.json. Ses règles de contact par défaut ne s'appliquent pas. - L'animation suit les règles maison dans CLAUDE.md.
Construire page par page, l'accueil en premier. Après l'accueil, exécuter npm run verify, regarder les trois captures d'écran et corriger ce qui est vu avant de construire la page suivante. La porte de fin du Taste Skill s'exécute d'elle-même lorsqu'il s'arrête ; traiter ses résultats comme des entrées, mais CLAUDE.md prévaut en cas de conflit.
Étape 3 : SEO
L'agent SEO modifie les balises head, JSON-LD et robots, il s'exécute donc avant la vérification et la révision. Ainsi, la révision juge le site terminé.
seo : "Auditer et implémenter le SEO de ce site, y compris l'étape entreprise locale. Brief : .agents/product-marketing.md. Rédiger le rapport dans .claude/pipeline/seo-report.md."
Étape 4 : Vérification (porte stricte)
npm run verify
Tous les échecs check-site et les problèmes de captures d'écran (défilement horizontal, erreurs console) doivent être corrigés avant la révision. Les échecs [NEED: ...] sont autorisés uniquement pour les faits déjà demandés à l'utilisateur ; les lister. Réécrire tout contenu signalé par check-site comme générique, sauf si le client utilise réellement ce mot.
Étape 5 : Révision
Le réviseur est en lecture seule et renvoie son rapport comme son message final. Sauvegarder ce message textuellement dans .claude/pipeline/review-report.md.
site-reviewer : "Réviser le site construit. Plan : .claude/pipeline/plan.md. Brief : .agents/product-marketing.md. Design : DESIGN.md. Captures d'écran : .claude/pipeline/screenshots/. Modifications SEO déjà effectuées : .claude/pipeline/seo-report.md. Retourner le rapport complet comme message final."
Étape 6 : Boucle de correctifs
| Verdict du site-reviewer | Action |
|---|---|
| Prêt | Aller à la porte 2 |
| Nécessite un suivi, P2 uniquement | Aller à la porte 2, lister les P2 |
| Nécessite un suivi (P1) ou Bloqué (P0) | Tour < 2 : les corriger, relancer l'étape 4 (vérification), relancer le site-reviewer sur les pages modifiées et sauvegarder son rapport. Tour = 2 : s'arrêter et montrer à l'utilisateur. |
Utiliser l'agent bug-fixer pour tout ce qui est cassé plutôt que simplement hors brief. Incrémenter le tour dans pipeline-state.md à chaque fois.
Porte utilisateur 2
S'arrêter. Montrer à l'utilisateur : les captures d'écran de l'accueil à 390 et 1440, le verdict, les P2 restants, les décisions SEO nécessaires, les éléments [NEED: ...] restants, et les photos de substitution à remplacer. Attendre l'approbation.
Étape 7 : Préparation au lancement
- Exécuter
npm run check:launchet corriger chaque échec. Ensuite, remplirdocs/launch-checklist.md, en marquant chaque élément comme fait, non applicable, ou en attente de quelqu'un (préciser qui). - Remplir
docs/handoff.mdpour le client. - Si le client modifiera le site, suivre
docs/client-editing.md. - Après la mise en ligne du site sur son domaine réel, rappeler à l'utilisateur d'exécuter claude-seo dessus :
/seo local <url>et/seo audit <url>.
Étape 8 : Leçons
Parcourir les rapports et les tours de correctifs pour tout ce qui a mal tourné deux fois ou a coûté du temps réel. Ajouter une ligne datée par leçon à docs/lessons.md. Dire à l'utilisateur quelles leçons valent la peine d'être recopiées dans site-starter pour que chaque futur site en bénéficie.