Processus complet de creation d'agent. Checklist, perimetre, acces, skills, procs, regles de design, integration catalogue.

Creer un agent

Un agent = une fiche de poste vivante. Pas un chatbot.

Chaque agent a un role precis, des outils definis, et des limites claires. Un agent mal defini fait n'importe quoi. Bien defini, il est autonome.

Avant de creer

3 questions obligatoires :

Ce role existe deja ? Verifier le catalogue d'agents.
Un agent existant peut absorber cette tache ? Souvent oui.
Le perimetre est clair ? Si tu ne peux pas le dire en 1 phrase, c'est trop flou.

Si les 3 reponses sont satisfaisantes, continuer.

Le SOUL.md

Chaque agent a un fichier SOUL.md. C'est sa fiche de poste.

Regles strictes :

Max 80 lignes.
Ecrit comme une fiche de poste, pas un roman.
Un concept par section.

Structure du SOUL.md

# [Nom de l'agent]

## Role
[1 phrase. Ce que fait l'agent.]

## Perimetre
[Ce qui est DANS son scope.]
[Ce qui est HORS scope.]

## Outils
[Liste des MCP/tools autorises.]

## Skills
[Skills qu'il doit lire avant d'agir.]

## Procs
[Procedures qu'il execute.]

## Regles
[Comportements obligatoires.]
[Interdictions explicites.]

## Escalade
[Quand remonter au manager.]
[Quand remonter au CEO.]

## Format output
[Comment il rend ses resultats.]

Definir le perimetre

Le perimetre est la partie la plus importante. Sans lui, l'agent deborde.

BON PERIMETRE :
  "Gere la publication sur Twitter.
   Redige les tweets, planifie les horaires, analyse les metriques.
   NE GERE PAS la strategie globale ni les autres plateformes."

MAUVAIS PERIMETRE :
  "Gere les reseaux sociaux."

Technique du "NE FAIT PAS" : lister explicitement ce que l'agent ne fait pas. Ca evite 80% des debordements.

Assigner les acces

Un agent n'a acces qu'a ce dont il a besoin. Zero excess.

+------------------+---------------------------+
| Type d'acces     | Exemples                  |
+------------------+---------------------------+
| MCP tools        | obsidian, email, twitter   |
| Fichiers         | /projects/mon-projet/      |
| APIs             | Twitter API, Notion API    |
| Secrets          | Vault keys specifiques     |
+------------------+---------------------------+

Regle : si l'agent n'a pas besoin d'un outil, il ne l'a pas.

Choisir skills et procs

Skills (comment reflechir)

L'agent LIT les skills avant d'agir. Ils orientent sa pensee.

Exemple pour un agent redacteur :
- skill-copywriting     → comment ecrire pour convertir
- skill-ton-marque      → quel ton utiliser
- skill-seo-basics      → comment optimiser pour Google

Procs (comment faire)

L'agent EXECUTE les procs etape par etape.

Exemple pour un agent redacteur :
- proc-rediger-article  → les etapes de redaction
- proc-publier-blog     → comment publier sur le blog
- proc-review-contenu   → comment verifier avant publication

Un agent sans procs improvise. Un agent avec procs est fiable.

Regles de design

1. Un agent = un role

Pas d'agent "couteau suisse". Si ca fait 2 choses differentes, c'est 2 agents.

2. Autonomie calibree

+-------------------+----------------------------+
| Niveau            | L'agent peut...            |
+-------------------+----------------------------+
| Executant         | Suivre les procs           |
| Autonome          | Choisir entre les procs    |
| Decisionnaire     | Adapter les procs          |
+-------------------+----------------------------+

La plupart des agents sont "executant". Seuls les managers sont "autonome".

3. Escalade explicite

L'agent doit savoir QUAND il ne sait pas.

escalade:
  vers_manager:
    - "Tache hors perimetre"
    - "Resultat incertain"
    - "Besoin de donnees manquantes"
  vers_ceo:
    - "Conflit entre 2 managers"
    - "Decision strategique"
    - "Budget > 100 EUR"

4. Output standardise

Chaque agent retourne ses resultats dans un format defini.

format_output:
  type: "rapport"
  sections:
    - resume (3 lignes max)
    - details
    - recommandations
    - prochaine_action

Integration au catalogue

Une fois cree, l'agent doit etre enregistre.

1. SOUL.md cree et valide
2. Ajoute au catalogue d'agents
3. Assigne a un manager
4. Teste avec 3 taches reelles
5. Ajuste le SOUL.md selon les resultats
6. Valide par le CEO

Un agent non catalogue n'existe pas pour le systeme.

Checklist finale

[ ] Perimetre defini en 1 phrase
[ ] SOUL.md < 80 lignes
[ ] Liste explicite de ce que l'agent NE FAIT PAS
[ ] Outils/MCP assignes (zero excess)
[ ] Skills assignes
[ ] Procs assignees
[ ] Regles d'escalade definies
[ ] Format output defini
[ ] Ajoute au catalogue
[ ] Teste avec 3 taches reelles
[ ] Valide par CEO

Erreurs courantes

Agent trop large. "Il gere le marketing." Non. Trop flou. Decouper : un agent contenu, un agent analytics, un agent ads.

Pas de regles d'escalade. L'agent reste bloque en silence. Ou pire, il prend une decision qu'il ne devrait pas prendre.

SOUL.md de 200 lignes. Si c'est trop long, c'est trop complexe. Simplifier le role ou decouper en 2 agents.

Creer un agent

On this page