Chore: ajoute le CLAUDE.md documentant les conventions du projet

[Zoubeir23]

Contexte

Le dépôt n'avait pas de CLAUDE.md : les conventions du projet (Server Actions, RLS, tokens de thème, parité i18n) n'étaient documentées nulle part et devaient être redécouvertes à chaque session ou à chaque arrivée sur le projet.

Ce qui change

Ajout d'un CLAUDE.md à la racine (120 lignes), inféré de la codebase :

• Stack : Next.js 15 App Router, React 19, Supabase + RLS, IA multi-fournisseurs, Stripe + USDC/Polygon, Vitest, CI GitHub Actions
• Architecture : rôle de chaque dossier et règles structurantes — mutations en Server Actions dans actions/, app/api/ réservé aux webhooks / API v1 / MCP / proxys WHO, composants Server par défaut, isolation RLS doublée par lib/rbac.ts
• Conventions : Git (branches, commits), style de code (kebab-case, pas d'abréviation, immutabilité, Zod aux frontières), design system (couleurs uniquement via les tokens de globals.css, trio typographique), i18n à parité fr/en
• Commandes et stratégie de test (environnement node, donc pas de rendu de composants)
• Anti-patterns tirés de problèmes réellement rencontrés : couleur codée en dur cassant le thème clair, duplication des prix, catch silencieux, migration mergée modifiée

Tests

Fichier de documentation uniquement — aucun impact sur le build, les tests ou le runtime.

À compléter

• Convention de numérotation des <code> de branche (la séquence suit les numéros de PR, actuellement 063)
• URL d'environnement de préproduction, absente du dépôt

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
doc-flow-ai	Ready	Preview	Aug 2, 2026 12:41am

[coderabbitai]

Warning

Review limit reached

@Zoubeir23, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 38 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Free

Run ID: 31f71466-8130-47ff-9ef1-a28761f01f57

📥 Commits

Reviewing files that changed from the base of the PR and between 21dc560 and 79d0443.

📒 Files selected for processing (1)

• CLAUDE.md

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Pull request overview

Ajoute un fichier CLAUDE.md à la racine pour centraliser les conventions d’architecture et de contribution du projet (stack, organisation des dossiers, règles de mutation, design system, i18n, commandes, stratégie de tests), afin d’éviter de devoir les redécouvrir à chaque session.

Changes:

• Ajout d’un guide de conventions projet (stack, architecture, règles structurantes).
• Documentation des pratiques de contribution (workflow Git, style, design tokens, i18n).
• Ajout d’un mémo de commandes et d’anti-patterns récurrents.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.