Outil

# Ancre Outil dans ton agent

## Objectif
Emploie « Outil » avec précision dans le code, la documentation et les échanges : Une opération invocable qui permet à un agent d’observer ou de modifier un système selon un contrat d’entrée et de sortie.

## Prérequis
- Inspecte comment le terme est employé aujourd’hui dans le dépôt, la documentation et les prompts.
- Repère les notions voisines déjà nommées : Skill, Agent, Model Context Protocol (MCP).
- Préserve les usages corrects existants.

## Définition de travail
Une opération invocable qui permet à un agent d’observer ou de modifier un système selon un contrat d’entrée et de sortie.

## Différence décisive
L’outil fournit une capacité ; la skill explique quand et comment l’utiliser dans une procédure.

## Exemple qui compte comme Outil
Tu fournis un chemin à un outil de lecture de fichier. Il renvoie le contenu ou une erreur, par exemple « fichier introuvable ». Demander la lecture ne prouve pas qu’elle a réussi : regarde le résultat renvoyé.

## Contre-exemple
Une checklist de revue n’est pas un outil exécutable ; elle peut faire partie d’une skill.

## Critères d’acceptation
- Chaque usage du terme correspond à la définition de travail.
- Les cas limites sont tranchés avec la différence décisive, pas à l’intuition.
- Les notions voisines (Skill, Agent, Model Context Protocol (MCP)) sont désignées par leur propre terme.

## Garde-fous
- Montre d’abord les changements envisagés avant toute action externe.
- Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
- Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.

## Format de sortie
- Résultat obtenu ou verdict.
- Fichiers ou actions concernés.
- Vérifications exécutées et preuves observables.
- Blocages ou limites restantes.

• Prérequis · Le vocabulaire agentique déjà employé dans le dépôt et la documentation

# Cartographie les notions voisines

## Objectif
Étends la même rigueur aux notions liées (Skill, Agent, Model Context Protocol (MCP)) pour que le vocabulaire du projet reste cohérent.

## Contrôles
- Relève chaque notion voisine employée sans définition.
- Applique sa différence décisive documentée.
- Note les cas encore ambigus pour la fiche suivante.

## Garde-fous
- Montre d’abord les changements envisagés avant toute action externe.
- Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
- Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.

## Format de sortie
- Résultat obtenu ou verdict.
- Fichiers ou actions concernés.
- Vérifications exécutées et preuves observables.
- Blocages ou limites restantes.

sha256:737b53da4d43db6992a29dca7ce81febb5b397bfd398a500a82dbfe1def49e1d

# Corrige une confusion autour d’Outil

## Symptôme observé
[DÉCRIS ICI LE SYMPTÔME]

## Contrôles observables
- Compare l’usage contesté à la définition de travail : Une opération invocable qui permet à un agent d’observer ou de modifier un système selon un contrat d’entrée et de sortie.
- Applique la différence décisive : L’outil fournit une capacité ; la skill explique quand et comment l’utiliser dans une procédure.
- Confronte le cas au contre-exemple documenté : Une checklist de revue n’est pas un outil exécutable ; elle peut faire partie d’une skill.

## Causes possibles
- Le terme est employé pour une notion voisine (Skill, Agent, Model Context Protocol (MCP)).
- La forme observée (interface, script, service) est confondue avec le comportement réel.
- Un alias (capacité d’action) porte un autre sens dans le projet.

## Corrections bornées
- Renomme ou reclasse uniquement les usages qui contredisent la définition de travail.
- Documente chaque choix en citant la différence décisive.

## Vérification finale
- Relis chaque occurrence corrigée face à l’exemple et au contre-exemple documentés.

## Garde-fous
- Montre d’abord les changements envisagés avant toute action externe.
- Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
- Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.

## Format de sortie
- Résultat obtenu ou verdict.
- Fichiers ou actions concernés.
- Vérifications exécutées et preuves observables.
- Blocages ou limites restantes.

• Prérequis · Le vocabulaire agentique déjà employé dans le dépôt et la documentation

# Fixe le vocabulaire dans le projet

## Objectif
Transforme la clarification en règle réutilisable pour éviter que la confusion revienne.

## Contrôles
- Ajoute la définition de travail au glossaire du projet.
- Relie chaque terme voisin à sa propre entrée.
- Vérifie les nouveaux documents face à la différence décisive.

## Garde-fous
- Montre d’abord les changements envisagés avant toute action externe.
- Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
- Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.

## Format de sortie
- Résultat obtenu ou verdict.
- Fichiers ou actions concernés.
- Vérifications exécutées et preuves observables.
- Blocages ou limites restantes.

sha256:6ad781a29e54239c9750836c83dee93d7c321ec48dfc84f3bcec2f7bcd40f2c3