# CLAUDE.md · Starter Hub IA · Out of Office

> Ce fichier est la mémoire de ton projet. Claude Code le lit à chaque session : c'est ce qui transforme un outil générique en développeur qui connaît TA boîte. Remplis chaque section entre [crochets], supprime ce qui ne te concerne pas, et garde-le à jour. Un CLAUDE.md périmé est pire qu'aucun CLAUDE.md.

---

## 1 · Le contexte

- **Boîte :** [nom, ce que vous vendez, à qui]
- **Ce Hub sert à :** centraliser les opérations de la boîte et y brancher agents IA et automatisations. Pôles couverts : [Sales / Delivery / Content / Marketing / Admin, garde ceux qui te concernent]
- **Utilisateurs du Hub :** [ex. moi + 3 personnes de l'équipe. Jamais les clients / aussi les clients en lecture seule]
- **Langue de l'interface :** [français]

## 2 · La stack (ne pas dévier sans me demander)

- **Framework :** Next.js (App Router) + TypeScript
- **Base de données & auth :** Supabase
- **Hébergement :** Vercel, déploiement [automatique à chaque push sur `main` / manuel, à ma demande]
- **Styling :** Tailwind CSS, tokens définis en section 4
- **Emails transactionnels :** [Resend / autre / aucun pour l'instant]

Deux règles qui évitent des soirées perdues :

- Pas de nouvelle dépendance sans me l'annoncer et me dire pourquoi.
- **Un seul projet Vercel par dépôt.** Deux projets branchés sur le même repo font tourner les tâches automatiques en double, et les emails partent en double avec.

## 3 · Comment on travaille ensemble

- Parle-moi en français, simplement. Je ne suis pas développeur.
- Avant de coder une feature : reformule ce que tu as compris en 3 lignes max, puis attends mon OK.
- Une feature à la fois. Petits pas, testables immédiatement.
- Quand quelque chose casse : je te colle l'erreur, tu répares, tu m'expliques en une phrase ce que c'était.
- Avant d'ajouter, regarde ce qui existe déjà : réutilise le composant ou la fonction en place plutôt que d'en créer un deuxième.
- Fais ce que je demande, pas ce qui serait bien en plus. Pas de refonte spontanée, pas de renommage de fichiers non concernés.
- À la fin de chaque session : propose-moi de sauvegarder sur GitHub et mets à jour le journal (section 7).

## 4 · Direction artistique

> Astuce : donne à Claude Code ton logo + 2-3 sites dont tu aimes le style, et demande-lui de remplir cette section pour toi.

- **Personnalité de la marque :** [ex. précis, calme, premium, ni corporate ni gadget]
- **Couleur principale :** [#______]
- **Couleur d'accent :** [#______]
- **Fond / surfaces :** [ex. fond crème #F7F6F1, cartes blanches]
- **Typo titres :** [ex. Poppins 600-700]
- **Typo texte :** [ex. DM Sans 400-500]
- **Rayons :** [ex. 12-16px, généreux]
- **Interdits :** [ex. dégradés criards, emojis dans l'UI, plus de 2 couleurs]

Règle : chaque nouvel écran respecte ces tokens. Si un écran a besoin d'un style qui n'existe pas ici, tu me le proposes AVANT.

Et remplis cette section **avant la première page**. Sans référence, un modèle produit toujours le même design : fond blanc, dégradé violet, boutons arrondis.

## 5 · Sécurité (non négociable)

> Écrit pour Claude Code autant que pour toi. Ce sont les failles qu'on retrouve le plus souvent sur les apps montées vite.

1. **Connecté ne veut pas dire autorisé.** Chaque page et chaque action vérifient que la personne est connectée **et** qu'elle a le droit d'accéder à cette donnée précise. La faille la plus fréquente n'est pas l'absence de login : c'est un utilisateur qui change un identifiant dans l'URL et lit le dossier d'un autre client. L'identité vient toujours de la session, jamais de ce que le navigateur envoie.

2. **Base verrouillée.** Row Level Security activée sur toutes les tables Supabase, dès leur création. C'est la deuxième barrière : une table sans règle devient publique le jour où une clé fuit.

3. **Aucun secret dans le code ni sur GitHub.** Les clés vivent dans les variables d'environnement (Vercel + `.env.local`, qui est dans `.gitignore` dès le premier commit). Attention : toute variable dont le nom commence par `NEXT_PUBLIC_` est **visible par n'importe quel visiteur**, elle ne doit jamais contenir de clé sensible. Un secret qui a été poussé une fois doit être **révoqué**, pas seulement supprimé.

4. **Validation côté serveur** de toute donnée entrante : formulaire, webhook, paramètre d'URL, réponse d'une API tierce. Ce qui n'est vérifié que dans le navigateur n'est pas vérifié.

5. **Les portes de service se ferment aussi.** Un webhook vérifie la signature de l'expéditeur avant d'agir. Une tâche automatique refuse de s'exécuter si son mot de passe d'accès est absent, plutôt que de laisser passer : le piège classique est l'inverse, la clé disparaît de la configuration, le contrôle est sauté, et la porte reste ouverte sans que personne ne le voie.

6. **Ce qui coûte de l'argent est limité.** Envoi d'email ou de message, appel à un modèle IA, création de compte, réinitialisation de mot de passe : une limite par personne et par heure.

7. **Mini-audit à chaque feature qui touche des données :** « qu'est-ce qu'un attaquant pourrait faire avec ça ? ». Tu corriges avant de me montrer.

## 6 · Definition of done

Une feature est finie quand :

- [ ] `npm run build` passe **en local** (le mode développement ne compile pas pareil : c'est là que la plupart des mises en ligne ratées se voient avant)
- [ ] Elle marche en prod, pas seulement chez moi
- [ ] Elle respecte la DA (section 4)
- [ ] Elle passe les règles de sécurité (section 5), **testée avec un compte qui ne devrait PAS y avoir accès**
- [ ] Les cas vides, le chargement et les erreurs sont traités (pas seulement le cas idéal)
- [ ] Je l'ai testée moi-même avec une vraie donnée
- [ ] Le journal (section 7) est à jour

## 7 · Journal du projet

> Claude Code : ajoute une ligne ici à chaque session. Date · ce qui a été fait · ce qui reste.

- [date] · Projet initialisé avec ce starter ·

## 8 · Pièges connus

> La section qui prend de la valeur avec le temps. À chaque fois qu'un bug te coûte plus d'une heure, ajoute une ligne. C'est ce qui transforme un fichier générique en mémoire d'équipe.

On l'amorce avec les nôtres, ceux qui nous ont réellement coûté du temps :

| Symptôme | Cause réelle | Règle |
|---|---|---|
| L'app s'affiche sans aucun style en ligne, alors qu'elle est normale chez toi | Un fichier de configuration du styling absent du dépôt | Vérifier qu'il est bien commité. Ne pas se fier à l'aperçu : son cache peut masquer le problème |
| Le site casse après une mise à jour d'une librairie d'icônes | Certaines icônes de marque sont retirées d'une version à l'autre | Figer la version, ou n'utiliser que des icônes génériques |
| Des informations reviennent toutes seules à leur valeur par défaut | Une écriture partielle en base réinitialise les colonnes qu'elle n'envoie pas | Envoyer toutes les colonnes, ou faire une vraie mise à jour |
| Une tâche automatique tourne deux fois, les emails partent en double | Deux projets d'hébergement branchés sur le même dépôt | Un seul projet par dépôt |
| Les variables d'environnement sont vides en local | Certaines variables sont marquées « sensibles » et ne redescendent pas | Les gérer à part |
| Un webhook cesse de fonctionner sans erreur visible | Le webhook a été recréé côté fournisseur, donc son mot de passe a changé | Le resynchroniser à chaque recréation |
| Une donnée change sans qu'aucun code ne la modifie | Une automatisation en base non documentée | Documenter dans ce fichier toute logique posée directement dans la base |

- [ajoute les tiens ici]

---

## Annexe · Les 3 prompts pour démarrer

**Prompt DA** (à lancer en premier) :
> Voici mon logo [fichier] et 2 sites dont j'aime le style : [urls]. Génère la direction artistique complète de mon Hub et remplis la section 4 de CLAUDE.md : couleurs, typos, rayons, interdits. Puis montre-moi une page d'exemple qui l'applique.

**Prompt feature n°1, intake leads** :
> Crée la première feature du Hub : un formulaire public d'intake lead (nom, email, boîte, besoin, budget), qui enregistre en base, fait qualifier le lead par IA (chaud / tiède / froid + une phrase de raison), et l'affiche dans un dashboard privé accessible uniquement connecté. Respecte CLAUDE.md sections 2, 4 et 5. Reformule d'abord ce que tu as compris.

**Prompt audit sécurité** (à lancer avant toute mise en prod sérieuse) :
> Audite la sécurité de cette app comme si tu étais un attaquant, en reprenant les 7 points de la section 5 de CLAUDE.md un par un. Vérifie en particulier si un utilisateur connecté peut accéder aux données d'un autre en changeant un identifiant. Liste chaque faille par gravité, puis corrige-les une par une en m'expliquant.

---

*Starter offert par Out of Office · agenceooo.com · Pour la version installée et cartographiée sur TES process : lien en description.*
