Agents IA

Cette section agrège rules, skills et commandes utilisées par les agents IA (Cursor, Claude Code) qui éditent le monorepo. Source canonique : .cursor/ à la racine et dans chaque sub-projet.

Les fichiers symlinkés (par exemple projects/bricksoffice-projects/.claude/rules/ → .cursor/rules/bo/) sont dédupliqués automatiquement : le contenu n'apparaît qu'une fois.

Rules

Les rules .cursor/rules/**/*.mdc sont auto-chargées quand un agent travaille sur le code. Elles formalisent le contrat technique (typage, conventions, non-négociables) et délèguent aux rules topiques (forms, tables, modals, …) pour les détails. Les CLAUDE.md à la racine du monorepo et de chaque sub-projet sont des symlinks vers .cursor/rules/claude-*.mdc.

Skills

Les skills .cursor/skills/<name>/SKILL.md sont des workflows pas-à-pas déclenchables à la demande via /<nom-du-skill> (Claude Code). Chaque skill capture une procédure répétée — scaffolder un composant, créer une page table BO, diagnostiquer un incident — au lieu de la décrire en prompt à chaque fois. Certaines skills embarquent une sous-doc (references/) accessible dans la nav.

Commands

Les commandes .cursor/commands/<name>.md sont des slash-commands courtes (/commit-push, /create-pr, /check-my-tools, …) qui rappellent à l'agent une procédure standard sans nécessiter un workflow complet de skill.

Sub-projets

Chaque sub-projet (projects/api, projects/bricksoffice-projects, …) peut maintenir ses propres rules / skills / commandes en local. Section dédiée pour les contenus spécifiques (API conventions, domain map, better-auth, …).

Hygiène

Les rules suivent une discipline DRY / why-only auditée via la skill rules-hygiene (commande /rules-hygiene). Avant d'ajouter une ligne à une rule, vérifier qu'elle n'est pas déjà couverte ailleurs.