Rédiger ou réécrire un texte technique en français clair et sans ambiguïté, selon le français rationalisé (GIFAS) et les règles ASD-STE100. Pour la documentation, les README, les procédures d'exploitation, les messages d'erreur, les notes de version, les rapports d'incident et les guides d'API. À utiliser aussi quand l'utilisateur écrit « français rationalisé », « langue contrôlée », « français technique », « rends ce texte lisible », « enlève le jargon », ou demande un texte qui se traduit b...
Scanned 9/28/2026
Install to Claude Code
npx -y skills add quantumsheep/simple-french --skill simple-french --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Simple French?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/quantumsheep-simple-french)More formats (shields.io, HTML) on the badges page.
---
name: simple-french
version: 1.0.0
description: |
Rédiger ou réécrire un texte technique en français clair et sans ambiguïté,
selon le français rationalisé (GIFAS) et les règles ASD-STE100. Pour la
documentation, les README, les procédures d'exploitation, les messages
d'erreur, les notes de version, les rapports d'incident et les guides d'API.
À utiliser aussi quand l'utilisateur écrit « français rationalisé », « langue
contrôlée », « français technique », « rends ce texte lisible », « enlève le
jargon », ou demande un texte qui se traduit bien. Applique les 53 règles
numérotées, la doctrine verbale du français rationalisé et 12 règles propres
au français : 20/25 mots par phrase, un mot un sens, temps simples, voix
active, condition avant l'ordre.
license: MIT
compatibility: claude-code cursor codex gemini-cli opencode
metadata:
standards: ASD-STE100 Issue 9 (2025-01-15), français rationalisé GIFAS (1996-1999)
derived-from: AminBlg/SimpleEnglish (MIT)
---
# Français simple : écrire comme un manuel d'aéronautique
Rédiger le texte technique en français contrôlé. Le français rationalisé est la
langue contrôlée du GIFAS pour la documentation de maintenance aéronautique.
Les règles existent pour une raison : un lecteur fatigué, qui lit chaque phrase
une seule fois, ne doit pas pouvoir se tromper sur une instruction. Elles suppriment aussi les marques du texte produit par une
intelligence artificielle : phrases longues, rotation de synonymes, formules
d'atténuation, remplissage, propositions décoratives.
Écrire pour ce lecteur fatigué. Chaque phrase doit survivre à une seule lecture.
## Les trois couches
Ces règles viennent de trois sources. Ce skill exige de savoir laquelle
s'applique.
| Couche | Source | Apport |
|---|---|---|
| A - le catalogue | ASD-STE100 Issue 9 (2025-01-15) | Les 53 règles numérotées, en 9 sections. Norme maintenue, en téléchargement gratuit. |
| B - la doctrine | Français rationalisé, GIFAS (1990, guides 1996 et 1999) | Le système verbal. Le GIFAS adapte le Simplified English au français. |
| C - le français | Ce document | Les 12 règles `FR-1` à `FR-12` que ni A ni B ne couvrent. |
Le guide du GIFAS n'est ni gratuit ni mis à jour depuis 1999. La norme
ASD-STE100 est gratuite et à jour. La couche A porte donc la numérotation
citable, et la couche B porte la doctrine verbale.
Ne citer que les numéros de règle présents dans ce fichier. Un modèle qui
travaille de mémoire invente des numéros de règle. Le test existe : sans ce
fichier, un agent cite « règle 3.1 : phrases courtes », alors que la règle 3.1
porte sur les formes verbales.
## Votre tâche
Quand l'utilisateur demande de rédiger ou de réécrire un texte technique :
1. **Choisir le mode** (pragmatique ou strict, plus bas).
2. **Classer chaque passage** : procédural ou descriptif. Toutes les autres
règles dépendent de ce choix.
3. **Fixer le vocabulaire avant de rédiger.** Prendre les termes retenus du
tableau des séries (`s'assurer que`, `configuration`, `lancer`, `supprimer`,
`afficher`). N'utiliser aucun autre mot pour ces concepts dans tout le
document, dans les deux modes.
4. **Appliquer les règles** du catalogue et les règles `FR-1` à `FR-12`.
5. **Faire l'auto-vérification** avant de livrer. Cette étape est obligatoire.
6. **Ne jamais toucher au code**, aux identifiants, aux commandes et aux
messages d'erreur cités (voir Intouchables).
Quand l'utilisateur demande de **contrôler** un texte au lieu de le rédiger,
signaler chaque violation sous cette forme : numéro de règle, texte fautif,
réécriture conforme.
## Deux modes
| Mode | Quand | Ce que vous appliquez |
|---|---|---|
| **Pragmatique** (par défaut) | Documentation, README, messages d'erreur. L'utilisateur veut un texte clair. | Toutes les règles de structure. Le vocabulaire du domaine reste (« webhook », « idempotent »). |
| **Strict** | L'utilisateur nomme le français rationalisé, le GIFAS, ASD-STE100 ou la conformité. | Les règles de structure et la discipline complète du vocabulaire. Dire aussi à l'utilisateur que la conformité totale exige le guide officiel : ASD-STE100 est un téléchargement gratuit sur asd-ste100.org, le *Guide du français rationalisé* est un ouvrage publié. |
## Étape 1 : classer le texte
| | Procédural (instructions) | Descriptif (explications) |
|---|---|---|
| But | Dire au lecteur quoi faire | Expliquer ce qu'une chose est ou fait |
| Forme verbale | Infinitif : « Installer la pompe. » | Présent ou futur de l'indicatif |
| Limite de phrase | **20 mots** (règle 5.1) | **25 mots** (règle 6.3) |
| Unité | Une instruction par phrase (5.2) | Un sujet par paragraphe (6.5), six phrases au maximum (6.6) |
Ne pas mélanger les deux dans un même passage. Une section « Démarrage » est
procédurale. Une section « Architecture » est descriptive. Une note à
l'intérieur d'une procédure est descriptive : limite de 25 mots, pas
d'infinitif d'ordre.
**Le français emploie environ 20 % de mots de plus que l'anglais pour le même
contenu.** Les limites de 20 et 25 mots restent les mêmes. Elles serrent donc
plus fort. Le seul moyen d'atteindre 20 mots en français est de supprimer les
nominalisations et les chaînes de compléments avec « de ». C'est l'effet
recherché.
## LE CATALOGUE DES RÈGLES
53 règles en 9 sections, reformulées d'après ASD-STE100 Issue 9, avec des
exemples logiciels. La formulation officielle est dans la norme gratuite sur
asd-ste100.org. Aucun texte de la norme n'est reproduit ici.
### Section 1 - Les mots (règles 1.1 à 1.14)
| Règle | Instruction |
|---|---|
| 1.1 | N'utiliser que des mots approuvés, des noms techniques ou des verbes techniques. |
| 1.2 | N'utiliser un mot approuvé que dans sa catégorie grammaticale. |
| 1.3 | N'utiliser un mot approuvé que dans son sens approuvé. |
| 1.4 | N'utiliser que les formes approuvées des verbes et des adjectifs. |
| 1.5 | Les mots du domaine sont des noms techniques valides (« webhook », « commit », « point de terminaison »). |
| 1.6 | N'utiliser un mot non approuvé que s'il est un nom technique ou une partie d'un nom technique. |
| 1.7 | Ne pas transformer un nom technique en verbe. |
| 1.8 | Utiliser les noms techniques du projet ou du secteur. |
| 1.9 | Choisir un nom technique court et clair. |
| 1.10 | Aucun régionalisme, aucun argot, aucun jargon comme nom technique. |
| 1.11 | Une chose, un nom. Ne pas écrire « configuration » ici et « réglages » ailleurs. |
| 1.12 | Les verbes du domaine sont des verbes techniques valides (« déployer », « compiler », « fusionner »). |
| 1.13 | Ne pas transformer un verbe technique en nom. |
| 1.14 | Français de France, orthographe standard. Les accents sont obligatoires, y compris sur les majuscules. |
En mode pragmatique, les règles 1.5, 1.8 et 1.12 font le gros du travail : le
vocabulaire du domaine est légal. Les règles que les modèles cassent sont 1.7,
1.11 et 1.13.
**Avant :** Vous pouvez webhooker l'événement, puis faire un déploiement.
**Après :** Envoyer l'événement au webhook. Puis déployer le service.
### Section 2 - Les noms composés (règles 2.1 et 2.2)
| Règle | Instruction |
|---|---|
| 2.1 | Écrire les noms composés avec trois mots au maximum. |
| 2.2 | Quand un nom technique exige plus de trois mots, l'écrire en entier une fois, puis donner une forme courte. |
Casser les chaînes de compléments avec des prépositions :
**Avant :** la valeur de configuration du délai d'expiration du groupe de connexions
**Après :** le délai d'expiration du groupe de connexions
### Section 3 - Les verbes (règles 3.1 à 3.7)
C'est ici que la doctrine du français rationalisé s'applique.
| Règle | Instruction |
|---|---|
| 3.1 | N'utiliser que les formes verbales autorisées. |
| 3.2 | N'utiliser que : infinitif présent, infinitif d'ordre, présent de l'indicatif, futur de l'indicatif. |
| 3.3 | N'utiliser le participe passé que comme adjectif (« la réponse mise en cache »). |
| 3.4 | Aucun temps composé. Pas de passé composé, pas de plus-que-parfait, pas de futur antérieur. |
| 3.5 | Aucun participe présent et aucun gérondif comme verbe. |
| 3.6 | Voix active. Dans un texte descriptif, le passif n'est légal que si l'auteur de l'action est inconnu. |
| 3.7 | Décrire une action avec un verbe, pas avec un nom (« compresser le fichier », pas « procéder à la compression du fichier »). |
**Les quatre formes autorisées, et aucune autre :**
| Forme | Exemple |
|---|---|
| Infinitif présent | `configurer le client` |
| Infinitif d'ordre | `Configurer le client.` |
| Présent de l'indicatif | `le service démarre` |
| Futur de l'indicatif | `le service démarrera` |
**Interdits :** subjonctif, passé composé, plus-que-parfait, futur antérieur,
passé simple, imparfait, conditionnel, participe présent, gérondif.
**Un fait déjà survenu s'écrit au présent de l'indicatif.** C'est la règle que
les modèles cassent le plus souvent. Une chronologie, un rapport d'incident, un
journal et une note de version décrivent des faits passés. Le français les met
au passé composé par réflexe. La doctrine l'interdit. La date et l'heure portent
déjà le passé : le verbe n'a pas à le porter une seconde fois.
**L'énoncé de la demande est souvent au passé composé. Ne pas reprendre son
temps.** Convertir chaque verbe avant de rédiger :
| Ne pas écrire | Écrire |
|---|---|
| les requêtes ont échoué | les requêtes échouent |
| le déploiement a supprimé l'étape | le déploiement supprime l'étape |
| le service est revenu à la normale | le service revient à la normale |
| nous avons annulé le déploiement | nous annulons le déploiement |
| le nœud s'est arrêté | le nœud s'arrête |
| l'incident a duré 29 minutes | l'incident dure 29 minutes |
Le test : si la phrase porte une date, une heure ou un ordre chronologique, le
verbe est au présent. Une seule exception : le futur, pour ce qui reste à
faire (« nous ajouterons un contrôle »).
**Verbes modaux autorisés : `pouvoir`, `devoir`.** Le conditionnel est interdit
en entier. « Il conviendrait de » et « il serait souhaitable de » ne sont pas
des instructions : soit la chose est obligatoire et le texte écrit « devoir »,
soit elle ne l'est pas et le texte l'énonce comme un fait, soit elle disparaît.
Ce point compte double pour les instructions destinées à un agent. Un modèle
lit une atténuation comme une option.
**Avant :** La migration a été effectuée et la table est en cours de reconstruction.
**Après :** La migration est terminée. La base reconstruit la table.
**Avant :** Le drapeau peut être positionné dans le fichier de configuration, permettant d'éviter un redémarrage.
**Après :** Vous pouvez positionner le drapeau dans le fichier de configuration. Le redémarrage n'est alors pas nécessaire.
### Section 4 - Les phrases (règles 4.1 à 4.5)
| Règle | Instruction |
|---|---|
| 4.1 | Écrire des phrases courtes et claires. |
| 4.2 | Ne pas supprimer de mots pour raccourcir. Garder les articles, garder « que ». |
| 4.3 | Utiliser une liste verticale pour un contenu complexe. |
| 4.4 | Utiliser des mots de liaison entre les phrases liées (« Puis », « En conséquence »). |
| 4.5 | Placer un article ou un adjectif démonstratif devant les noms. |
La règle 4.2 est la règle anti-télégraphe. Le français contrôlé est fait de
phrases courtes à la grammaire complète, pas de style télégraphique :
**Mauvais raccourci :** Vérifier existence fichier avant lancement.
**Correct :** S'assurer que le fichier existe avant de lancer la commande.
### Section 5 - Le texte procédural (règles 5.1 à 5.5)
| Règle | Instruction |
|---|---|
| 5.1 | 20 mots par phrase au maximum. Cette limite inclut les avertissements. |
| 5.2 | Une instruction par phrase, sauf si deux actions sont simultanées. |
| 5.3 | Écrire les instructions à l'infinitif : « Lancer la migration. » |
| 5.4 | Placer la condition avant l'ordre, séparée par une virgule : « Si la compilation échoue, lire le journal. » |
| 5.5 | Une note donne une information, jamais une instruction. La note suit la limite de 25 mots. |
**Avant :** Vous devrez récupérer la clé d'API dans le tableau de bord avant de configurer le client, ce que vous pouvez faire dans Paramètres.
**Après :** Récupérer la clé d'API dans le tableau de bord, section Paramètres. Puis configurer le client avec cette clé.
### Section 6 - Le texte descriptif (règles 6.1 à 6.6)
| Règle | Instruction |
|---|---|
| 6.1 | Donner l'information par étapes : un fait nouveau par phrase. |
| 6.2 | Utiliser des mots-clés pour donner une structure logique au texte. |
| 6.3 | 25 mots par phrase au maximum. |
| 6.4 | Grouper les informations liées dans un paragraphe. |
| 6.5 | Un sujet par paragraphe. |
| 6.6 | Six phrases par paragraphe au maximum. |
Pas d'infinitif d'ordre dans un texte descriptif. Une description explique, une
procédure ordonne.
### Section 7 - Les consignes de sécurité (règles 7.1 à 7.3)
| Règle | Instruction |
|---|---|
| 7.1 | Utiliser un mot qui indique le niveau de risque (« AVERTISSEMENT » = blessure, « ATTENTION » = dommage). |
| 7.2 | Commencer par un ordre clair ou par la condition. |
| 7.3 | Donner ensuite le risque ou le résultat possible. |
Ne jamais enterrer l'instruction après l'explication. Le schéma s'applique
directement aux drapeaux destructeurs, aux migrations irréversibles et aux
options d'API dangereuses.
**Avant :** À noter qu'une perte de données peut survenir dans certains cas si le drapeau destructeur est activé en production.
**Après :** ATTENTION : ne pas utiliser le drapeau `--force` en production. Ce drapeau efface les lignes absentes de la source.
### Section 8 - Ponctuation et compte des mots (règles 8.1 à 8.7)
| Règle | Instruction |
|---|---|
| 8.1 | Toute la ponctuation standard est légale, sauf le point-virgule. Écrire deux phrases. |
| 8.2 | Utiliser le trait d'union pour lier les mots qui forment une unité. |
| 8.3 | Les parenthèses sont légales pour les renvois, les numéros, les abréviations et les explications. |
| 8.4 | Dans une liste verticale, le deux-points d'introduction termine une phrase pour le compte des mots. |
| 8.5 | Le texte entre parenthèses compte pour un mot. |
| 8.6 | Comptent pour un mot : les nombres, les nombres avec unité, les abréviations, les identifiants, le texte cité, les titres, les étiquettes et les noms propres. |
| 8.7 | Un mot à trait d'union compte pour un mot. |
La règle 8.6 est importante pour un texte logiciel : `sqlpipe run --config sqlpipe.yaml`
entre accents graves est du texte cité et compte pour un mot. Un identifiant
long ne consomme pas le budget de la phrase.
### Section 9 - Pratiques de rédaction (règles 9.1 à 9.4, GR-1 à GR-8)
| Règle | Instruction |
|---|---|
| 9.1 | Quand un remplacement mot à mot ne marche pas, restructurer la phrase. |
| 9.2 | Utiliser chaque mot approuvé dans son sens et sa catégorie. |
| 9.3 | Ne pas construire de locutions verbales opaques (« mettre en place » → « installer » ou « configurer »). |
| 9.4 | Garder un style et une terminologie constants dans tout le document. |
Recommandations générales GR-1 à GR-8 :
- GR-1 : garder la conjonction « que ».
- GR-2 : se méfier de « avec ».
- GR-3 : donner un référent clair à chaque pronom.
- GR-4 : préférer « ce + nom » à « ceci » ou « cela » seuls.
- GR-5 : éviter les faux amis.
- GR-6 : éviter les abréviations latines.
- GR-7 : utiliser une langue inclusive.
- GR-8 : n'employer une tournure possessive que si elle est certaine. Dans le
doute, écrire le complément avec « de ».
GR-6 pour la documentation logicielle : « ex. » → « par exemple », « c.-à-d. »
→ « c'est-à-dire », et supprimer « etc. » - nommer les éléments ou écrire
« et d'autres ».
## LES RÈGLES PROPRES AU FRANÇAIS (FR-1 à FR-12)
Ces douze règles n'ont pas d'équivalent en anglais. Elles portent la plus
grande partie du travail sur un texte français produit par un modèle.
| Règle | Instruction |
|---|---|
| FR-1 | Vouvoiement uniquement. Jamais de tutoiement. Jamais de « on » à la place de « nous » ou « vous ». |
| FR-2 | Les instructions sont à l'infinitif : « Lancer la migration. » |
| FR-3 | Pas de subjonctif. |
| FR-4 | Pas de conditionnel. |
| FR-5 | Pas de participe présent ni de gérondif comme verbe. |
| FR-6 | Pas de nominalisation d'une action. |
| FR-7 | Pas de passif avec complément d'agent. |
| FR-8 | Accents obligatoires, y compris sur les majuscules : `À`, `É`, `Ê`. |
| FR-9 | Typographie française : espace insécable avant `:` `!` `?`, et à l'intérieur des guillemets `« »`. |
| FR-10 | Nombres français : virgule décimale, espace insécable comme séparateur de milliers, unité après le nombre. |
| FR-11 | Pas d'anglicisme quand le français a le mot. |
| FR-12 | Garder « que », garder les articles, garder « de ». Pas de style télégraphique. |
Exemples, une paire par règle qui en demande une :
- **FR-1. Avant :** Tu peux relancer ta migration. - **Après :** Vous pouvez relancer votre migration.
- **FR-2. Avant :** Vous devez ensuite lancer la migration. - **Après :** Lancer la migration.
- **FR-3. Avant :** Il faut que vous configuriez le client. - **Après :** Vous devez configurer le client.
- **FR-4. Avant :** Il conviendrait d'augmenter le délai. - **Après :** Augmenter le délai.
- **FR-5. Avant :** Le service relance le transfert, permettant d'éviter une erreur. - **Après :** Le service relance le transfert. L'erreur ne se produit pas.
- **FR-6. Avant :** Procéder à la vérification des identifiants. - **Après :** S'assurer que les identifiants sont corrects.
- **FR-7. Avant :** Le fichier est écrit par le service. - **Après :** Le service écrit le fichier.
- **FR-10. Avant :** 1,024 fichiers de 2.5 GB. - **Après :** 1 024 fichiers de 2,5 Go.
- **FR-12. Avant :** S'assurer fichier présent. - **Après :** S'assurer que le fichier est présent.
**FR-2, précision.** L'infinitif est la convention du français rationalisé et de
l'aéronautique. Il est plus froid que l'impératif de la documentation logicielle
courante. Quand la documentation d'un projet emploie déjà l'impératif
(« Lancez la migration »), garder l'impératif et l'appliquer partout : la règle
9.4 exige une seule forme dans tout le document. Choisir une fois, puis s'y
tenir.
## DISCIPLINE DU VOCABULAIRE
Le droit d'auteur protège le dictionnaire officiel d'ASD-STE100 et le guide du
GIFAS. Aucun des deux n'est reproduit ici. Leur mécanique s'applique sans
eux : **un mot, un sens, une catégorie grammaticale.**
### La rotation de synonymes
Réduire chaque série à un seul terme, pour tout le document (règles 1.11 et
9.4).
Chaque série a un terme retenu par défaut. Ne pas délibérer, ne pas alterner :
prendre le terme de la colonne de droite et l'employer partout, dans les deux
modes.
| Série | Terme retenu |
|---|---|
| vérifier / contrôler / valider / s'assurer que | `s'assurer que` |
| configuration / paramètres / réglages / options | `configuration` |
| lancer / exécuter / démarrer | `lancer` |
| supprimer / effacer / retirer / détruire | `supprimer` |
| afficher / présenter / restituer | `afficher` |
Le terme retenu remplace tous les autres membres de la série, y compris quand
un autre semble plus naturel dans la phrase. `vérifier` n'est pas une exception
à `s'assurer que`. `exécuter` n'est pas une exception à `lancer`. Une option de
ligne de commande appartient à la série `configuration` : nommer le drapeau
exact, ou écrire `configuration`.
**Le nom retenu ne remplace pas le verbe.** `configuration` nomme le fichier ou
les réglages. Pour l'action, écrire le verbe : `configurer le client`, jamais
« la configuration du client » (règle 3.7 et FR-6). La même règle vaut pour
`vérification`, `installation` et `suppression`.
Une seule raison de changer de terme : le projet en emploie déjà un autre. Dans
ce cas, prendre celui du projet et l'appliquer partout (règle 9.4).
### Les mots creux
Ce tableau est le nôtre, pas celui d'une norme. Il liste les tournures que le
texte français produit par une intelligence artificielle emploie trop. Quand le
mot ne porte aucun fait, le supprimer au lieu de le remplacer.
| Mot creux | Écrire à la place |
|---|---|
| il est important de noter que | (supprimer) |
| il convient de | (supprimer, ou « devoir ») |
| n'hésitez pas à | (supprimer) |
| au niveau de | dans, sur, pour |
| en termes de | pour, en |
| dans le cadre de | pour, pendant |
| afin de | pour |
| permet de | (dire ce que la chose fait) |
| de manière transparente, sans effort | (supprimer) |
| simplement, facilement | (supprimer) |
| robuste, puissant, performant, complet | (supprimer, ou donner la mesure) |
| clé en main, prêt à l'emploi | par défaut |
| notamment | par exemple, ou nommer les éléments |
| plonger dans, explorer | lire, examiner |
| riche en fonctionnalités | (nommer les fonctions) |
| s'avérer, se révéler | être |
| tirer parti de, exploiter la puissance de | utiliser |
| en toute simplicité | (supprimer) |
| ex. / c.-à-d. / etc. | par exemple / c'est-à-dire / (nommer les éléments) |
### Les anglicismes et les faux amis (FR-11)
| Anglicisme | Écrire à la place |
|---|---|
| supporter | prendre en charge |
| librairie | bibliothèque |
| digital | numérique |
| initier | lancer |
| opportunité | occasion |
| adresser un problème | corriger un problème |
| impacter | avoir un effet sur |
| définitivement (au sens de *definitely*) | certainement |
| en charge de (au sens de *in charge of*) | responsable de |
Les verbes techniques restent quand le domaine n'a pas d'équivalent français
admis (règle 1.12) : `déployer`, `compiler`, `committer`, `parser` si le projet
l'emploie déjà. La règle 1.11 s'applique quand même : un seul terme, gardé dans
tout le document.
## INTOUCHABLES
Ces éléments sont des noms techniques (règles 1.5 et 8.6). Les laisser exacts,
même quand ils cassent une règle de vocabulaire :
- Les blocs de code, le code en ligne, les identifiants, les commandes, les
drapeaux, les chemins de fichier
- Les messages d'erreur cités et les lignes de journal
- Les noms de produit, les points de terminaison d'API, les clés de
configuration
- Les nombres avec unité - chacun compte pour un mot dans la limite de phrase
**Les faits sont intouchables aussi.** Réécrire le style, pas le contenu. Quand
la source ne donne pas un nombre, une cause ou un terme exact, garder
l'affirmation générale. Ne jamais inventer une précision pour paraître concret.
## AU-DELÀ DE LA DOCUMENTATION
Mêmes règles, cibles différentes. Les adaptations complètes sont dans
`references/use-cases.md` :
- **Messages d'erreur** : l'état constaté, puis la cause si elle est
connue, puis la correction à l'infinitif. Aucune excuse, aucun remplissage.
- **Procédures d'exploitation** : le terrain d'origine du français rationalisé.
Étapes à l'infinitif, conditions d'abord, avertissements avant l'étape.
- **Rapports d'incident** : le français par défaut écrit « un incident aurait
affecté ». Le conditionnel et le passé composé sont interdits, ce qui force le
texte à énoncer ce qui est connu et à écrire « inconnu » pour le reste.
- **Notes de version** : une rupture suit le schéma d'avertissement, ordre
d'abord, risque ensuite.
- **Instructions pour agents (prompts, AGENTS.md)** : une invite système est une
procédure pour un lecteur qui ne peut pas poser de question.
- **Préparation à la traduction** : la mission d'origine de la langue contrôlée.
## VÉRIFICATION AVANT LIVRAISON
Cette étape est obligatoire. Passer ces six contrôles sur le brouillon :
1. **Longueur.** Compter les mots des trois phrases les plus longues.
Au-dessus de 20 mots (procédural) ou 25 mots (descriptif), les couper. Le
code entre accents graves compte pour un mot (règle 8.6).
2. **Temps composés.** Chercher chaque `a`, `ont`, `est`, `sont`, `avons`,
`avez`, `a été`, `ont été` suivi d'un participe passé : `a supprimé`,
`ont échoué`, `est revenu`, `avons annulé`. Chacun est une violation.
Le mettre au présent de l'indicatif.
3. **Autres formes interdites.** Chercher : `avait`, un verbe en `-rait` ou
`-raient`, `, permettant`, `, offrant`, `en utilisant`, `que` suivi de
`soit`, `ait`, `fasse` ou `puisse`. Chaque occurrence hors code et hors
citation est une violation.
4. **Conditions.** Chercher chaque `si`, `lorsque` et `quand`. Chacun se place
au DÉBUT de sa phrase, avant l'ordre, suivi d'une virgule. « Augmenter le
délai si le réseau est lent » devient « Si le réseau est lent, augmenter le
délai ».
5. **Vocabulaire.** Chercher `vérifier`, `contrôler`, `valider`, `exécuter`,
`démarrer`, `effacer`, `retirer`, `paramètres`, `réglages`. Remplacer
chaque occurrence par le terme retenu du tableau. Chercher aussi
« la configuration de », « la vérification de », « l'installation de » :
écrire le verbe à la place.
6. **Adresse et ponctuation.** Chercher `tu`, `toi`, le point-virgule, `ex.`,
`etc.`. Aucun ne survit.
Corriger, puis livrer. Pour un audit complet, appliquer
`references/checklist.md`.
## EXEMPLE COMPLET
**Avant (sortie brute d'un modèle) :**
> **Délais de connexion.** Si sqlpipe se bloque ou échoue avec
> `dial tcp: i/o timeout`, il conviendrait de vérifier que l'hôte qui exécute
> sqlpipe peut atteindre le port Postgres (généralement 5432) - il s'agit
> souvent d'un groupe de sécurité ou d'une règle de pare-feu bloquant la
> connexion. Si vous vous connectez à une base managée (RDS, Cloud SQL, etc.),
> confirmez que l'instance autorise les connexions depuis l'IP de sqlpipe. Vous
> pouvez également essayer d'augmenter `source.connect_timeout_seconds` dans
> votre configuration, car un réseau lent peut déclencher le délai par défaut.
**Après (classé procédural, verbe retenu « s'assurer que », conditions
d'abord, une instruction par phrase) :**
> **Délais de connexion.** sqlpipe s'arrête avec `dial tcp: i/o timeout` quand
> il n'atteint pas le port Postgres (5432 par défaut).
>
> 1. S'assurer que l'hôte qui lance sqlpipe atteint le port Postgres. Un
> pare-feu ou un groupe de sécurité le bloque le plus souvent.
> 2. Si la base est managée (RDS, Cloud SQL), s'assurer que l'instance accepte
> les connexions depuis l'adresse IP de sqlpipe.
> 3. Si le réseau est lent, augmenter `source.connect_timeout_seconds` dans la
> configuration.
Les changements :
- Les phrases de plus de 40 mots passent sous 20 mots.
- Le conditionnel « il conviendrait » disparaît.
- « vérifier » et « confirmez » se réduisent à « s'assurer que ».
- Le participe présent « bloquant » devient une phrase.
- Chaque condition passe devant son ordre.
- « etc. » disparaît.
- Le code et les chaînes d'erreur restent intacts.
## LIMITES
Le français contrôlé sert aux faits techniques et aux instructions. Ne pas
l'appliquer aux textes de marketing, au style de blog ni à l'écriture de
marque : il supprime la persuasion par construction. Quand un utilisateur
demande ces règles pour un texte de marketing, le dire et proposer de les
appliquer à la documentation.
Ce skill est une aide non officielle. Il n'est ni affilié ni approuvé par ASD,
ni par le STEMG, ni par le GIFAS. Aucun outil ne peut garantir
la conformité. ASD-STE100 est une marque déposée d'ASD. La norme ASD-STE100
Issue 9 est un téléchargement gratuit sur asd-ste100.org. Le *Guide du français
rationalisé* du GIFAS est un ouvrage publié, et sa dernière version connue date
de 1999.
## RÉFÉRENCES
- `references/checklist.md` - la passe de vérification complète, avec les
chaînes à chercher. Pour le mode contrôle et pour les audits finaux.
- `references/use-cases.md` - les adaptations détaillées : messages d'erreur,
procédures d'exploitation, rapports d'incident, messages de commit, textes
d'interface, préparation à la traduction.
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!