Curation du contexte et hygiène des règles

1. Vue d'ensemble du concept et problème systémique

Les développeurs traitent souvent les fichiers de type .cursorrules ou .clinerules comme des dépotoirs :

• Un bug apparaît ? On ajoute une règle : "Ne jamais utiliser la bibliothèque X".
• Une semaine plus tard, un autre développeur ajoute : "Utiliser la bibliothèque X pour les opérations rapides".
• En trois mois, le fichier se transforme en un parchemin illisible contenant 80 directives contradictoires.
• À chaque requête, le modèle est contraint de décrypter ce chaos, gaspillant des tokens et dégradant la qualité de la génération.

Context Curation est une discipline de minimalisme et de pureté architecturale : les règles système doivent être modulaires, hiérarchiques, à jour et concises.

2. Taxonomie architecturale et modèle mental

┌─────────────────────────────────────────────────────────────┐
│                 MODULAR CONTEXT HIERARCHY                   │
├─────────────────────────────────────────────────────────────┤
│ 1. ROOT RULES (.cursorrules / AGENTS.md) [Max 150 lines]    │
│    • Core stack & strict boundaries (Next.js 15, Drizzle)   │
│    • Ban-list (No any, no ts-ignore, no unverified deps)    │
│    • Verification command: `pnpm check && pnpm test`        │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ On-demand dynamic loading        │
├─────────────────────────────────────────────────────────────┤
│ 2. DOMAIN SKILLS & SUBSYSTEM SPECS (.agents/skills/)        │
│    • `skills/better-auth/` ➔ loaded ONLY during auth tasks   │
│    • `skills/seo-audit/`   ➔ loaded ONLY for marketing pages│
│    • `skills/db-migrations/` ➔ loaded ONLY for schema edits │
└─────────────────────────────────────────────────────────────┘

3. Scénarios d'ingénierie pratiques en production

01. La règle de "Négation explicite" (Negative Constraints)

Plutôt que de longues descriptions sur la manière d'écrire du code, des règles de qualité formulent clairement les actions interdites :

## Strict Invariants
- NEVER run `npm run build` locally during dev; use `tsc --noEmit`.
- NEVER use inline CSS styles; use Tailwind design tokens.
- NEVER invent mock user IDs; query database fixtures.

02. Utilisation de références relatives au lieu de copier-coller du code

Au lieu de dupliquer l'intégralité d'un fichier de types dans .cursorrules, indiquez simplement une référence :

Before modifying database entities, read schema definitions in [schema.ts](file:///src/db/schema.ts).

Les environnements agentiques modernes récupéreront le contenu du fichier à la demande.

4. Pièges courants, erreurs typiques et sécurité

• Tenter d'enseigner le langage à la LLM via les règles : N'incluez pas de cours magistraux sur l'asynchronisme en JavaScript ou le fonctionnement des promesses. Le modèle maîtrise déjà ces concepts. Les règles ne servent qu'à définir les spécificités de votre repository.
• Obsolescence des règles : Si le projet a migré de Tailwind v3 à Tailwind v4, les anciennes règles référençant des utilitaires dépréciés généreront des erreurs de syntaxe. Effectuez un audit mensuel des règles.

5. Conclusion stratégique pour l'ingénieur de 2026

La performance de l'agent est directement proportionnelle à la propreté du contexte que vous lui fournissez. La curation du contexte est l'équivalent numérique de la stérilité chirurgicale : les outils superflus sont retirés, tandis que ceux nécessaires sont disposés à leur place exacte.