Brand-OS

Conventions agents

Ces conventions s'appliquent quand un agent (Claude, Codex, Gemini) travaille dans ce repo Brand-OS.

Brand-OS — CLAUDE.md

L'identité de marque (archétype, ton, anti-keywords, cible) est dans ~/.claude/CLAUDE.md global. Ne pas la dupliquer ici.


1. Ce qu'est ce repo

Brand-OS est la source de vérité de la marque MIND7 (Flo & Racha, copreneurs). Chaque fichier .md à la racine est un document de marque versionné dans Git. L'app Next.js (app/) rend ces fichiers en interface de consultation locale. Ce repo est déployé sur Vercel en continu depuis la branche main.


2. Fichiers à lire avant toute action

Lire ces fichiers avant d'écrire du code ou du contenu :

  • voice.md — ton, archétype, keywords/anti-keywords, rules de format
  • design.md — palette, typographie, variables CSS du design system
  • audience.md — 3 personas, kryptonites, registre de langage
  • offers.md — catalogue d'offres actif (maximum 5 offres)
  • content-pillars.md — 5 piliers avec hypothèses, exemples, anti-piliers

3. Conventions de code

Framework Next.js 16 App Router — cette version a des changements incompatibles avec les données d'entraînement habituelles. Lire node_modules/next/dist/docs/ avant d'écrire du code. Respecter les deprecation notices.

TypeScript Strict. Pas de any. Pas d'assertions non justifiées. Typer les props de chaque composant.

Styles Tailwind CSS v4. Couleurs du design system via var(--color-*) en inline style — ne pas coder les valeurs hex directement.

Composants Server Components par défaut. "use client" uniquement quand l'interactivité l'exige (useState, useEffect).

Données Les fichiers .md sont lus côté serveur via fs.readFile. Le frontmatter YAML est parsé à la main (regex sur ---) — pas de dépendance externe pour ça.

Dépendances disponibles react-markdown, remark-gfm — pour le rendu markdown dans l'app.


4. Règles spécifiques

Fichiers de marque → Ne jamais écrire de données fictives dans les .md de marque (voice.md, audience.md, offers.md, content-pillars.md, prompts/*.md) → Ne jamais inventer un témoignage, un chiffre ou une source

offers.md → Toute modification requiert une confirmation explicite avant écriture — c'est le catalogue actif

Git → Ne jamais push sans demande explicite → Ne jamais commit de fichiers de secrets (.env, clés API)

Environnement → Ne jamais toucher .env ni aucun fichier de configuration d'infrastructure