Aller au contenu principal

Review Rules

Statut​

Document de review qualité — version initiale.

Périmètre​

Fichiers principaux :

  • docs/rules/01-global-rules.md
  • docs/rules/02-writing-style.md
  • docs/rules/03-product-philosophy.md
  • docs/rules/04-ui-ux-rules.md
  • docs/rules/05-laravel-rules.md
  • docs/rules/06-react-rules.md
  • docs/rules/07-api-rules.md
  • docs/rules/08-security-rules.md
  • docs/rules/09-ai-rules.md
  • docs/rules/10-playloop-rules.md
  • docs/rules/11-data-rules.md
  • docs/rules/12-documentation-rules.md
  • docs/rules/13-git-rules.md
  • docs/rules/14-performance-rules.md
  • docs/rules/15-mobile-rules.md

Vérification factuelle​

  • Les règles reflètent l'état réel documenté.
  • Les règles ne créent pas d'obligation impossible aujourd'hui.
  • Les anciennes pages rules vides ne contredisent pas les nouvelles.
  • Les règles distinguent strict, recommandation et cible quand nécessaire.

Vérification stratégique​

  • Les règles protègent simplicité, maintenabilité et cohérence.
  • Les règles sont utilisables par développeurs et IA.
  • Les règles évitent sur-ingénierie et jargon.
  • Les règles restent compatibles avec futures équipes.

Vérification technique​

  • Règles Laravel alignées avec modules visibles.
  • Règles React alignées avec Next.js/Vite.
  • Règles API alignées avec /api/v1 et X-App-Source.
  • Règles data alignées avec PostgreSQL/Laravel/Supabase.
  • Règles performance alignées avec mobile-first.

Vérification business​

  • Les règles produit protègent freemium utile.
  • Les règles IA protègent coûts et valeur.
  • Les règles PlayLoop évitent publicité intrusive.
  • Les règles Git/Docs réduisent dette projet.

Vérification IA​

  • Les règles sont directement exploitables par agents IA.
  • Les interdits IA sont sans ambiguïté.
  • Le style documentaire est clair pour ingestion IA.
  • Les agents sont invités à signaler hypothèses et limites.

Vérification juridique / risques​

  • Les règles sécurité couvrent secrets, droits, données et IA.
  • Les règles documentation évitent promesses non validées.
  • Les règles mobile/accessibilité évitent exclusion utilisateur.

Questions ouvertes​

  • Faut-il archiver ou remplacer les anciennes pages global.md, backend.md, etc. ?
  • Qui valide une modification de règle ?
  • Faut-il un index officiel docs/rules/README.md mis à jour ?
  • Les règles doivent-elles être référencées dans AGENTS.md ?

Priorités de review​

  1. Cohérence des règles avec la réalité code.
  2. Exploitabilité par IA.
  3. Absence de contradiction entre règles et docs.
  4. Mise à jour de l'index rules.