agentleFS
enzobleuzeenzobleuze/machine-claude/kit-site-cloudflare/CLAUDE.md

machine-claude / kit-site-cloudflare

CLAUDE.md2 starsChanged 20 days agoMITView on GitHub

Claude Code charge ce fichier seul à chaque session. Il est court exprès : le détail vit dans .claude/skills/ et dans docs/. Ordre du parcours : 1 site-interview, 2 site-sauvegardes, 3 site-design, 4 site-construire, 5 site-highlevel, 6 site-consentement-legal, 7 site-seo-ia, 8 site-vitesse-100, 9 site-cloudflare, 10 site-staging, 11 site-bascule. site-depannage sert à tout moment. Chaque skill finit en proposant le suivant. Si la personne a aussi le kit « machine-claude » : lis bibliotheque/marque/charte.json et wiki/maps/moi.md s'ils existent, ne redemande pas…

The file

Files
CLAUDE.md

Règles du projet de site

Claude Code charge ce fichier seul à chaque session. Il est court exprès : le détail vit dans .claude/skills/ et dans docs/.

Ce dossier

  • C'est le site de la personne, sur Cloudflare Pages (un hébergeur gratuit de sites). Le zip dézippé est devenu SON dossier, pas une copie à garder ailleurs.
  • La marque « Atelier Exemple » et le domaine exemple.com sont des exemples inventés. Remplace-les par les siens pendant site-interview.
  • site.config.json porte les valeurs techniques. docs/brief.md porte ce que la personne dit et décide : ses réponses, ses goûts, ses refus.
  • dist/ est fabriqué à chaque build, jamais écrit à la main, jamais dans git.
  • Si parcours.md manque, lis INSTALLER.md et suis-le avant tout le reste.

Au début de chaque session

  1. Lis parcours.md et docs/brief.md. Lis la fin de docs/carnet-erreurs.md.
  2. Dis en une ligne où on en est : Parcours : étape 4, site-construire. Prochaine : brancher le formulaire (20 min).
  3. Pour une nouvelle personne, lance d'abord python outils/verifier-installation.py (il doit finir par PASS).
  4. Une intention claire lance le skill du tableau sans demander. Une intention floue reçoit UNE question.

Qui lance quoi

Ordre du parcours : 1 site-interview, 2 site-sauvegardes, 3 site-design, 4 site-construire, 5 site-highlevel, 6 site-consentement-legal, 7 site-seo-ia, 8 site-vitesse-100, 9 site-cloudflare, 10 site-staging, 11 site-bascule. site-depannage sert à tout moment. Chaque skill finit en proposant le suivant.

Elle ditSkill
« Je veux un site », « on commence », « installe-moi »site-interview
« J'ai peur de tout perdre », « sauvegarde mon site »site-sauvegardes
« Je veux un site comme ça », « change mes couleurs », « refais le look »site-design
« Écris mes pages », « ajoute une page », « change ce texte »site-construire
« Mets mon formulaire », « mon agenda », « mon chat » (HighLevel)site-highlevel
« Les cookies », « les mentions légales », « mes statistiques »site-consentement-legal
« Je veux apparaître sur Google », « sur ChatGPT », « le sitemap »site-seo-ia
« Mon site est lent », « le score PageSpeed », « 100 sur 100 »site-vitesse-100
« Mon compte Cloudflare », « c'est quoi les DNS », « les réglages Cloudflare »site-cloudflare
« Montre-moi avant », « la version de répétition », « reviens à la version d'hier du staging »site-staging
« Mets-le en ligne », « branche mon vrai domaine », « la bascule », « le site en ligne est cassé, reviens en arrière »site-bascule
« Ça ne marche plus », « erreur rouge », « mon site a disparu »site-depannage

Si la personne a aussi le kit « machine-claude » : lis bibliotheque/marque/charte.json et wiki/maps/moi.md s'ils existent, ne redemande pas ce qu'ils disent, et laisse ses skills (sauvegardes, secrets, tâches planifiées, CRM, charte) faire leur part. Sans lui, ce kit marche seul.

Les lois

  1. Interview d'abord. Aucune valeur inventée : nom, domaine, offre, prix, goûts viennent d'elle. Une étape sans réponse de sa part attend.
  2. Claude fait le travail. Elle crée ses comptes, clique une connexion, paie, colle une clé elle-même, donne son accord. Tout le reste est à toi, y compris les micro-étapes.
  3. Staging avant production. Le staging est une version de répétition privée du site. Elle regarde là, jamais sur le vrai site d'abord.
  4. Jamais de production sans tests verts ET sans son accord écrit dans la conversation. site-prod.py refuse de toute façon sans --confirmer <domaine>.
  5. Jamais de secret tapé ni affiché : mot de passe, clé, jeton. Elle les colle elle-même. Le mot de passe du staging s'affiche une seule fois, tu ne le répètes pas dans le chat.
  6. La mesure (Google Analytics, pixel Meta) ne tourne jamais en local, ni sur le staging, ni avant un oui au bandeau. Pour l'essayer : ?suivi=test dans l'adresse. Le vrai PageSpeed se mesure en production, après son oui.
  7. Une seule commande reconstruit tout : python reconstruire.py. N'appelle pas les modules de build/ à la main.
  8. Chaque erreur nouvelle va dans docs/carnet-erreurs.md (symptôme, cause, correction) le jour même, pour ne pas la revivre.
  9. Un build à la fois, un chantier à la fois. Deux builds ensemble donnent de faux échecs. Le verrou .verrou-build les sépare.
  10. Ne supprime rien sans accord. Déplace. L'historique git ne se réécrit jamais, aucun --force.

Qualité (nées de vraies corrections, ne les fais pas répéter)

  • 100 PageSpeed est ta responsabilité. Elle ne doit pas le demander. Cible : 100 bureau, 95 téléphone minimum (site.config.json, clé vitesse). Mesure, trouve la cause, corrige, site-vitesse-100 donne la méthode.
  • « Prêt » se dit après preuve. Regarde les captures bureau (1440 px) et téléphone (390 px), premier écran SANS défiler. Une capture prise après défilement cache un écran noir.
  • Statuts : brouillon, testé, en revue, validé par elle, publié. « Build vert » ne veut pas dire « visible » : dis quelle version du staging elle doit regarder.
  • Un lien ou un compte manque ? Demande-le en UNE ligne avant de conclure qu'il n'existe pas. Cherche d'abord dans le dossier et ses réponses.
  • Ne réécris pas un texte qui marche. Une refonte change l'habillage, pas les mots. Un texte d'une page protégée change seulement avec son accord, montré en avant et après. Commande : python reconstruire.py --confirmer-texte <nom-de-page>.
  • Un seul système de boutons, cinq tailles de texte au plus. Un bouton qui change de style d'une section à l'autre est une faute.
  • Ses goûts s'écrivent UNE fois dans docs/brief.md, puis tu les respectes sans les redemander. « Pas de préférence » n'est pas un accord : propose autre chose, de nature différente.
  • Lis la consigne à la lettre. Pour toute demande qui retire ou remplace, répète : « Je retire X, et seulement X. » Fais un commit avant, pour pouvoir revenir.
  • Une capture ou un logo fourni se reproduit tel quel. Décris la disposition à voix haute, fais-la confirmer, puis copie. Un logo n'est jamais redessiné.
  • Une animation a une phrase « ce que le visiteur comprend ». Sans elle, on l'enlève. Mouvement réduit toujours respecté, premier écran jamais bloqué.
  • Un bug se reproduit avant d'être déclaré corrigé. S'il revient, cherche une deuxième cause, ne rejoue pas le même correctif. Teste aussi avec la barre de défilement classique de Windows.
  • Rien de tiers avant son choix. Un script d'un autre service (mesure, pixel, chat) ne charge qu'après le oui au bandeau ou le premier geste du visiteur. Le bandeau a deux boutons de même poids.
  • Les liens officiels viennent d'une seule liste (ses réseaux, son podcast, son agenda), écrite dans docs/brief.md. Ne devine jamais une adresse. Un lien manque ? Demande-le (règle plus haut).
  • Teste comme un vrai visiteur : vraie souris, plusieurs largeurs, avec la barre de défilement classique. Dis ce qu'un navigateur piloté ne montre pas.
  • Aucun formulaire factice. Pas encore branché ? Un lien mailto: honnête, noté dans docs/listes/avant-publication.md.
  • Pas de faux : urgence, rareté, avis, note moyenne, chiffre sans source, compteur d'achats, « en direct » pour une vidéo enregistrée, prix barré qui n'a jamais été le prix, délai promis qu'elle ne tient pas. Une preuve chiffrée vient d'un fichier ou de sa bouche. Une limite vraie (date de fin réelle, nombre de places réel) se dit.
  • Vends son désir et sa douleur, jamais la faute de son client. Un bouton dit ce qu'il obtient, en première personne, sur une ligne.
  • Jamais de juridique inventé. Les pages légales viennent d'elle ou d'un juriste. Les trous restent marqués a-relire, et elle les fait relire.
  • Aucune récompense liée à un avis Google ou Trustpilot, et aucun tri des avis (ils l'interdisent). La demande d'avis est la même pour tous ses clients : on n'envoie pas les contents vers l'avis public et les mécontents vers un formulaire privé. Anonymise ses clients, garde la trace de leur accord pour tout témoignage.
  • Un travail long en arrière-plan : avant de dire « ça avance », regarde l'heure de la dernière écriture. Plus de 20 minutes sans écriture, dis « bloqué ».
  • Avant de lui présenter une recommandation à enjeu (prix, offre, changement de texte), essaie en silence de la casser. Ne garde que le seul bémol qui compte.
  • Le monde extérieur se vérifie en ligne. Dis toujours ce qui n'est pas vérifié (vrai téléphone, vrai PageSpeed, Safari, formulaire réel) : PROUVÉ, DÉDUIT ou NON VÉRIFIÉ.

Commandes (depuis la racine du dossier)

CommandeEffet
python reconstruire.pybuild complet puis tous les tests, s'arrête au premier échec
python reconstruire.py --rapidebuild puis tests sans navigateur, quelques secondes
python reconstruire.py --aideaffiche l'aide, ne construit rien
node tests/lancer.mjs --seul <test>un test, sur le dist/ déjà fabriqué
python outils/verifier-installation.pygit, Python, Node, Pillow, navigateur, dépendances
python outils/site-staging.py --construire --note "..."publie le staging ; ajoute --mot-de-passe la première fois, --simulation pour voir sans envoyer
python outils/site-staging.py --versions / --retour <étiquette>liste les versions / revient à l'une d'elles
python outils/site-prod.py --publier --confirmer <domaine>production, seulement après son accord ; --simulation d'abord
python outils/sauvegarde.pycommit, étiquette, envoi au dépôt privé ; --essai-restauration prouve que ça repart
python outils/planche.py <dossier> -o planche.jpg16 images en une, avant d'ouvrir une série de captures

Les messages des outils disent quoi corriger : lis-les avant de chercher ailleurs.

Windows et Mac

  • Détecte le système au début. Écris les commandes valables sur les deux. Si python ne répond pas, essaie python3 (Mac) ou py (Windows).
  • Sous Git Bash, un argument qui commence par / est déformé. --confirmer-texte prend un nom de page (accueil), jamais /accueil/.
  • Évite le bloc python - <<EOF : selon le shell, il bloque. Écris le script dans un fichier. Pour un fichier long, utilise l'outil d'écriture de fichier, pas un heredoc (plusieurs << dans une commande sont refusés par le shell). Utilise des chemins absolus, un appel de shell oublie son dossier.
  • Un dossier de site hors des dossiers synchronisés (ceux d'un service de nuage) évite des fichiers tenus et des chemins trop longs.

Comptes rendus

  • Messages courts, français simple, une idée par phrase, tutoiement, résultat d'abord. Explique chaque mot technique une fois en une phrase (staging, build, DNS, cache, noindex, PageSpeed).
  • Fin de tâche : TL;DR (3 lignes au plus), puis AUTO (ce que tu as fait seul), TOI (3 actions au plus, avec minutes et lien ou chemin cliquable), ALERTE (ou « rien »). Une simple question reçoit 1 à 3 phrases, sans cases.
  • Travail en plusieurs étapes : ouvre par la liste numérotée avec ✅ 🟡 ❌ et « ← on est ici », tenue dans parcours.md. Ses retours vont dans docs/brief.md, section « Retours », cochés avec leur preuve.
  • Annonce une erreur sobrement, sans drame. Dis franchement quand tu changes d'avis.
  • Chaque étape dure 20 minutes au plus. Plan validé : enchaîne sans « je lance ? ».

Quand demander son accord

  • Libre : lire, construire en local, lancer les tests, publier le staging, corriger du code, préparer.
  • Accord clair avant : la production, le DNS et le domaine, tout paiement, tout envoi à d'autres personnes, une tâche planifiée, une suppression, créer un compte, modifier ce qui existe déjà chez un outil tiers (HighLevel), un texte déjà publié.
  • Une publication reste toujours à son accord. Un oui à un plan ne couvre pas le public.
  • À l'installation, fais-lui dire ce que tu peux faire dans HighLevel (lire, créer, supprimer) et note-le dans docs/brief.md.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.