Parent : [[INDEX-IA]]

Écrire une connaissance pour qu'une IA la comprenne bien

Problème

Une connaissance mal rédigée n'est pas exploitée par l'IA. Trop vague → ignorée. Trop longue → noyée dans le contexte. Sans mots-clés → jamais déclenchée.

Solution

Structurer chaque connaissance avec : titre précis, problème clair, solution actionnable, exemple concret.

Règles d'écriture

1. Titre — précis et scannable

✅ "FiveM - Callbacks d'argent vides : argent gratuit si non implémentés"
❌ "Problème avec l'argent dans FiveM"

2. La description de la Rule = les mots-clés déclencheurs

description: "FiveM Lua - scripts serveur ESX QBCore anti-cheat inventory NUI events"

→ Chaque mot est un déclencheur potentiel. Plus il y en a, plus la rule est chargée souvent.

3. Structure minimale efficace

## Problème
1 phrase claire sur ce qui se passe si on ignore cette connaissance.

## Solution
Ce qu'il faut faire, avec le verbe d'action en premier.

## Exemple
Code ou commande concrète.

4. Priorité = ce que l'IA va respecter en premier

5. Tags = aide à la recherche future

• 3 à 5 tags max
• Mettre le domaine, le sous-domaine, et un mot-clé technique précis
• Ex: [fivem, lua, anti-cheat, server-side]

6. Longueur idéale d'une Rule Windsurf

• Pas trop court : moins de 3 lignes → pas assez de contexte pour l'IA
• Pas trop long : plus de 200 lignes dans un fichier → le contexte est dilué
• Idéal : 1 fichier par domaine, 30-80 lignes par connaissance résumée

Anti-pattern associé

Voir [[KNOW-ANT-IA-001-connaissance-vague-sans-exemple|KNOW-ANT-IA-001]] — Connaissance trop vague ou sans exemple.