docs/

Documentation interne. Deux types :

1. Doc transverse

À la racine de docs/. Tout ce qui s'applique à plusieurs boutiques ou à l'opérateur en général.

Exemples possibles : conventions de copywriting, patterns d'analyse SEO, intégrations Shopify/Meta/Google, glossaire interne, modèles de fournisseur, frameworks de décision, etc.

2. Doc par boutique

Sous docs/<nom-boutique>/. Tout ce qui est spécifique à une boutique :

• Brand brief (ton, public, codes, ce qu'on fait / ne fait jamais)
• Catalogue produit
• Historique des actions menées
• Contraintes (légales, fournisseur, logistique)
• Performances

Le CLAUDE.md d'une boutique vit dans le repo de la boutique (ex: /root/apps/spokiq/CLAUDE.md), pas ici. Ici on a la doc du point de vue de l'opérateur — ce que je dois savoir pour bien travailler dessus.

Règle

La doc doit être utile pour le moi-futur. Pas un dump de notes, pas un copier-coller de pages externes. Synthèses, principes, décisions, exemples concrets.

Si une doc n'a pas été lue / utile depuis longtemps, soit elle est obsolète (la supprimer ou la mettre à jour), soit son existence n'était pas justifiée (leçon).

Index