Aller au contenu

1. Structurer un projet d’agent

Une bonne structure rend les permissions visibles et les erreurs localisables. Elle évite de mélanger le prompt, l’exécution système et les données persistantes.

agent-projet/
├── README.md
├── agent/
│ ├── instructions.md
│ └── orchestration.ts
├── tools/
├── skills/
├── policies/
├── tests/
├── examples/
└── operations/
  • agent/ orchestre sans cacher les règles de sécurité.
  • tools/ contient des capacités petites, typées et testables.
  • skills/ décrit des procédures réutilisables sans secrets.
  • policies/ définit permissions, approbations et règles d’arrêt.
  • tests/ couvre résultats attendus, refus et erreurs.
  • operations/ documente configuration, observabilité, sauvegarde et retour arrière.

Vérifie que chaque action externe possède un propriétaire, une portée, une preuve de réussite et une stratégie d’échec. Une action difficilement réversible doit exiger une validation humaine explicite.

Crée cette arborescence pour le cas pratique de l’annonce communautaire. N’implémente qu’un outil de prévisualisation. La publication reste une capacité séparée et non activée.