umairmsm/wp-site

Site WordPress : du dossier vide à la production

Ce kit est une méthode plus un projet de démarrage. Il a été appris sur un site de réservation multilingue en ligne que de vrais clients paient. Suivez les étapes dans l'ordre. Chaque étape se termine par une porte de sortie : ne quittez une étape que lorsque sa porte est vraie et que la preuve est écrite.

1. Trouver où en est le projet

1. Cherchez SITE_STATUS.md à la racine du projet.
   • Absent : le projet n'a pas commencé. Utilisez wp-kickoff.
   • Présent : lisez-le. L'étape actuelle est la première étape avec une porte non cochée.
2. Lisez AGENTS.md (les règles du projet), puis les dernières lignes de SESSION_LOG.md et DECISIONS.md.
3. Dites au propriétaire en deux lignes : l'étape actuelle et la prochaine étape concrète.

2. Les étapes

#	Étape	Compétence	Porte de sortie (preuve dans SITE_STATUS.md)
1	Kickoff	wp-kickoff	Brief approuvé par le propriétaire ; décisions verrouillées écrites ; dépôt privé ; identifiants listés par nom
2	Conception	wp-design	Prototype statique validé (captures d'écran + date) ; jetons définis ; polices auto-hébergées
3	Construction	wp-build	Site local fonctionne ; plugin principal + thème enfant actifs ; éléments réels rendus via les fonctions principales ; demandes enregistrées avant envoi ; tests de structure verts
4	Contenu	wp-content	Chaque page publique a du texte approuvé par le propriétaire et des photos réelles ; pages légales existent ; pas de texte IA non approuvé
5	SEO & langues	wp-seo	Tests titre, description, canonical, schema et hreflang verts ; carte de redirection d'anciennes URL ; chaque langue supplémentaire a passé son pilote
6	Qualité	wp-quality	Suite complète verte ; 0 violations d'accessibilité ; budgets de performance atteints sur la préproduction
7	Mise en production	wp-ship	Préproduction reflète la production ; durcissement appliqué ; launch-auditor PASS ; basculement effectué ; 7 jours surveillés
8	Exploitation	wp-operate	Sauvegardes automatiques avec copie hors machine ; un exercice de restauration effectué ; procédures de mise à jour et d'alerte écrites

• Pour confier le travail d'une étape à un agent constructeur (Antigravity, Codex, autre Claude) : wp-task-file.
• Revue avant fusion : agent wp-rules-reviewer. Avant mise en ligne : agent launch-auditor.

3. Règles strictes (chaque étape, chaque agent)

1. Plugin d'abord. La logique, les données, les textes de politique, les formulaires, le schéma et le SEO vivent dans le plugin principal à utiliser obligatoirement. Le thème est la mise en page. La peau est l'apparence. Une refonte ne doit pas perdre une fonctionnalité.
2. Pas de cartes, prix ou slugs en dur dans les modèles. Interrogez le type de contenu et rendez via la fonction de rendu du plugin principal, afin qu'une modification du CMS s'affiche partout.
3. Les prospects sont sauvegardés en premier. Les formulaires envoient vers admin-post.php avec un nonce. Le site stocke le prospect dans sa propre base de données, puis le transmet. Pas de clés API ou de points de terminaison tiers dans la page.
4. Pas de fausses preuves. Ne montrez jamais d'évaluations, de nombres d'avis ou de témoignages que personne ne peut prouver. Les nombres d'avis importés ou « hérités » sont considérés comme faux jusqu'à preuve du contraire.
5. Photos réelles pour tout lieu, pièce, produit ou personne nommé. Les images IA uniquement en tant que paysage général, nommées ai-*, journalisées, et jamais présentées comme « voici votre chambre ».
6. Les faits viennent du propriétaire. Les prix, politiques, inclusions et faits de sécurité ne sont jamais inventés. La copie IA est un brouillon jusqu'à approbation du propriétaire. Inconnu = PENDING-<qui>.
7. Pas de PHP écrit par IA en production sans branche, test local, diff et fusion humaine. Normes de codage WordPress. Préfixez tout.
8. Pas de constructeurs de pages. Pas d'appels Google Fonts. Polices auto-hébergées : un tribunal allemand a ordonné des dommages parce que leur chargement depuis Google divulguait les adresses IP des visiteurs.
9. La préproduction et le local ne sont jamais indexés et n'envoient jamais d'e-mails à de vrais clients.
10. Les tests ne sont jamais affaiblis pour obtenir du vert : pas de suppression, de saut ou de nouvelle capture instantanée. Renommer un test nécessite l'accord du propriétaire.
11. Les déploiements appartiennent au propriétaire. Depuis un commit, via scripts/deploy-safe.sh : d'abord un essai à sec, d'abord une sauvegarde, le mot live tapé par un humain.
12. La base de données est le contenu. Modifiez-la uniquement via un fichier de modification révisable et un script protégé avec un essai à sec. Sauvegardez avant chaque modification de base de données.
13. Les secrets n'entrent jamais dans git, les journaux, les invitations ou la page. CREDENTIALS_INVENTORY.md liste les noms et où chaque secret vit, jamais les valeurs.
14. Un seul propriétaire de schéma (généralement le plugin SEO). Ne produisez jamais une Offer sans prix.

4. Demandez d'abord au propriétaire

• Installer des plugins, thèmes, outils ou services payants (constructeurs de pages : jamais).
• Tout changement de prix, devise, politique, nom de marque ou logo. Publier une nouvelle langue.
• Tout ce qui touche au DNS, Cloudflare, hébergement, préproduction ou production. Commandes destructrices de base de données ou de fichiers.
• Envoyer du code ou du contenu client à une API IA tierce.

5. Comment travailler

• Une étape à la fois, un petit pas à la fois. Validez après chaque étape significative (Commits Conventionnels).
• Branche, test local, diff, puis le propriétaire fusionne. Les agents ne poussent, fusionnent, déploient ou ssh jamais sur un serveur sauf si le propriétaire demande cette action exacte.
• Chaque décision va dans DECISIONS.md (date, qui, pourquoi). Terminez chaque session par une ligne dans SESSION_LOG.md.
• « Fait » signifie vérifié : ouvrez la page, exécutez le test, lisez la réponse du serveur. Ne répétez jamais le « résolu » d'un autre agent sans le vérifier vous-même.

6. Compétences utiles d'autres kits (si installés)

• agent-skills-kit : wordpress-modern, wp-plugin-development, wp-wpcli-and-ops, wp-performance pour les détails de l'API WordPress.
• agent-loop-kit : supervised-build, agent-supervisor pour les boucles de construction non supervisées avec une porte et un relecteur.