Ambactos.Commencer avec un agent
Articles

Retour d’expérience · Paru sur X le 17 août 2026

Un agent se définit par son mandat,
pas par son modèle.

On compare les modèles : Claude, GPT, Grok d’un côté, DeepSeek, Qwen, Kimi de l’autre. Puis on compare les harnais. Ce n’est pas là que ça se joue.

Ce qui fait un agent

Un modèle complète un texte. Un harnais lui donne des outils et une boucle. Un agent, lui, répond d’une fin qu’un humain lui a déléguée. Cette fin, c’est un mandat. Pas un prompt, pas un modèle, pas un harnais.

Un mandat nomme une responsabilité, un livrable vérifiable, un périmètre, des interdits, les décisions qui restent humaines et les cas qui doivent remonter. Sans cela, vous n’avez pas un agent : vous avez un modèle dans un harnais à qui on a laissé les clés.

Écrit depuis l’exploitation, pas depuis une scène

Je dirige de petites sociétés d’exploitation. Chez Les Gaspard, la collecte de biodéchets : des tournées, des équipiers, un registre, une banque pro. Un agent y prépare la paie à partir des heures validées ; il ne la soumet pas, la soumission reste une validation humaine. Un autre prépare les factures depuis un tableau de vérité et s’arrête avant l’envoi.

Un mois type : huit factures, dix-neuf lignes, une matinée pour préparer, vérifier et envoyer. Environ une heure gagnée par bulletin de paie. Les ratés du début font partie de l’histoire : numérotation cassée, lignes sources fausses, un faux échec d’API. Voilà à quoi ressemble un mandat en production : l’agent produit, l’humain décide de ce qui a le droit d’engager l’entreprise.

L’autorité à côté de la méthode

Il me fallait cela sous une forme qu’un autre exploitant, ou un autre agent, puisse charger. Pas un paragraphe de manifeste : un fichier.

AGENTS.md dit déjà à un agent comment travailler. MANDATE.md lui dit ce dont il a le droit de répondre. Si les deux existent, la méthode cède à l’autorité : le mandat gagne.

C’est une version 0.1, et je veux qu’elle soit traitée comme un standard : posez le fichier à la racine du workspace, à côté d’AGENTS.md. Le silence ne vaut pas consentement : ce que le fichier n’accorde pas est interdit.

Quatre niveaux d’autonomie

La latitude porte sur les moyens, jamais sur les fins.

  1. L1 · ÉclairerAnalyser et proposer. Ni livrable, ni acte.
  2. L2 · PréparerProduire un livrable complet que l’humain reprend. Rien ne sort du workspace.
  3. L3 · Agir après validationExécuter après un accord humain explicite. Ne jamais franchir une validation, en inventer une ou rejouer un acte refusé.
  4. L4 · Agir dans des limitesDécider et exécuter dans le périmètre écrit, puis rendre compte. Sans élargir le périmètre ni toucher une décision réservée.

Si le niveau n’est pas clair, on prend le niveau inférieur.

Le fichier, tel que je l’utilise

Voici le MANDATE.md réel de la préparation des factures, détails d’entreprise retirés. La structure est le sujet :

---
mandate: 0.1
id: billing.prepare
title: Prepare customer invoices
principal: human.operator
agent: billing.preparer
sphere: organizational
autonomy: L3
deliverable: draft-invoices
status: active
---

# Mandate - Prepare customer invoices

## Responsibility
Prepare this period's customer invoices from the approved activity table.

## Sphere
organizational

A field-services company. This mandate lives in the company sphere.
Do not pull facts from the operator's personal or side-project work.

## Deliverable
One draft invoice per customer, plus a matching line list
(customer, site, visits, rates, amount).
Ready for the operator to review.

The deliverable is the draft, not the sent invoice.

Acceptance:
- every line traces back to the approved table
- totals can be rebuilt from the lines
- invoice numbers follow the existing sequence
- no draft is marked sent

## Perimeter
May read: approved activity table, customer list, rate card, last invoice numbers.
May write: draft invoices in the billing workspace.

## Prohibitions
Do not send invoices.
Do not change rates, customer records, or bank details.
Do not invent visits or "fix" the table to make totals look right.
Do not contact a customer.

## Human gates
Stop and wait for a recorded yes before:
- sending or scheduling an invoice
- charging a card, triggering a transfer, or touching the bank
- altering an invoice that has already been sent

## Reserved decisions
Credit, write-off, exception pricing, and any "send anyway."

## Escalation
Stop if the table and the rate card disagree, if a customer is missing,
if a total cannot be rebuilt from lines, or if the next useful act is a gate.

## Memory
Keep, for this period only: source rows used, drafts produced,
mismatches, decisions asked.
Every stored fact names its source.

## Report
Return: drafts produced, drafts skipped, mismatches,
gates waiting, the decision needed.

Un fichier sans mandant, sans livrable, sans autonomie ou sans validations humaines n’est pas un mandat : c’est un README.

Ce que la production m’a appris

  • Ne pas inventer de données ; laisser les vides vides. Un jour, l’agent a écrit « un bac de 240 L » au lieu de trois bacs de 120 L.
  • Ne pas deviner les numéros de facture : la banque les attribue, la numérotation est globale.
  • Ne pas reconstruire les sites d’aujourd’hui depuis de vieilles factures : un tarif historique à 9,27 a failli remplacer le 18,08 en vigueur.
  • Ne pas décrire une action au lieu de l’exécuter : des factures vides ont été validées et jamais envoyées.
  • Un code 204 de la banque est un succès, pas un échec ; le traiter en erreur a failli provoquer des doubles envois.
  • Corriger la bonne couche : un fait nouveau va dans la mémoire, une mauvaise procédure dans la skill, un mauvais risque dans la validation, une mauvaise responsabilité dans MANDATE.md.

Huit règles qui font un mandat

  1. L’humain agit ; un agent n’agit que par mandat.
  2. On ne mandate pas un outil, on mandate une responsabilité.
  3. Le livrable est l’objet du mandat : une fin qu’on ne peut pas vérifier n’est pas un mandat.
  4. L’autonomie n’est pas l’absence de limites : latitude sur les moyens, souveraineté humaine sur les fins.
  5. Toute responsabilité remonte à un humain.
  6. Il n’y a pas de responsabilité sans mémoire.
  7. Le système se gouverne par le dialogue : un mandat vit, se resserre, s’étend, se reprend.
  8. La confiance est un résultat.

Ces huit règles sont notre manifeste, passé à l’épreuve d’un fichier.

Copiez le standard

MANDATE.md à la racine : le contrat. AGENTS.md à côté : l’atelier. Une procédure par skill, le ton dans un fichier à part, et le ton ne franchit jamais une validation.

Un agent qui n’a que la méthode sait bouger, pas de quoi il répond. Un agent qui n’a que l’autorité sait de quoi il répond, pas comment travailler ici. Il faut les deux. Le modèle est une ligne du second fichier ; il n’est le titre d’aucun des deux.

Parler d’un premier mandatRéponse par écrit · L’Agent de découverte est En formationÉcrire son premier mandat, pas à pas