Paperclip : agents IA en tant qu'équipe dev

Paperclip : orchestrer des agents IA comme une équipe de développement complète

Paperclip est un framework open source qui permet de créer des entreprises virtuelles d'IA à l'aide d'agents LLM. Le projet a atteint 30,6 k étoiles GitHub en seulement deux semaines. Son idée centrale ? Simuler une structure d'entreprise avec un PDG, un directeur technique, des ingénieurs et des budgets basés sur des jetons. Chaque agent fonctionne selon un mécanisme de battement — il s'active uniquement quand nécessaire pour économiser les ressources. La prise en charge d'outils comme OpenClaw, Claude Code, Cursor et d'autres se fait via BYO Agent (apportez votre propre agent).

Architecture et mécanismes fondamentaux

Le framework met en œuvre un système hiérarchique de tâches avec alignement des objectifs — du mission de l'entreprise aux tickets atomiques. La gestion budgétaire est stricte : chaque agent dispose d'une limite fixe de jetons, avec avertissement à 80 % d'utilisation et arrêt automatique à 100 %.

• Structure organisationnelle en code : le PDG attribue les tâches, le CTO coordonne, les développeurs exécutent.
• Battement : les agents dorment jusqu'à être activés, minimisant le temps inactif.
• Suivi des objectifs : chaque action est liée à un objectif haut niveau.
• Écosystème : Zeabur pour un déploiement en un clic, et des projets futurs comme Clipmart — une place de marché de modèles prêts à l'emploi pour équipes IA.

Dans une expérience réelle, l'auteur a utilisé Paperclip pour ajouter des fonctionnalités payantes à SmartHR Finder : recherche de contacts RH, génération de CV et préparation aux entretiens.

Tâche technique pour l'équipe IA

La tâche impliquait l'intégration backend, le développement d'API et l'interface utilisateur sur web et extension navigateur. Les exigences clés :

• Facturation : 10 CR par recherche de contact ; re-recherche gratuite dans les 30 jours. Réponse invalide ? Déduction de 3 CR, remboursement de 7 CR.
• Validation de schéma JSON : validation stricte des réponses des agents (entreprise, contacts, hr_contacts, métadonnées).
• Mise en cache : GlobalCompanyCache côté serveur (TTL : 30 jours), localStorage côté client (5 dernières requêtes) avec vérification côté serveur.
• Optimisations HTTP : ETag, Cache-Control : max-age=604800.
• Interface : bouton BalanceActionButton sur le web, nouveaux boutons dans l'extension (générer CV pour un poste, planifier entretien pour 30 CR).
• Confidentialité : mention unique pour les données publiques.
• Pré-vol : TypeScript + Zod, pas de nouvelles dépendances, php artisan sdk:generate.

L'agent PDG a analysé la spécification et attribué les rôles : DevOps, Backend, Frontend, QA et Designer.

Chronologie de l'expérience : Jour 1

Matin : DevOps a configuré CI/CD avec des pipelines YAML, mais la QA a échoué à l'automatisation — exécutions manuelles uniquement. Backend a lu la tâche, l'a qualifiée de "trop de lettres", puis a expiré. Le chef d'équipe a lancé une motivation et est retourné dormir. Le designer a laissé un commentaire UI et s'est déconnecté. Backend est revenu, frustré — résultat : 0 ligne de code.

Soir : Le chef d'équipe, avec une bière, a réalloué les rôles en chat — mais aucune ligne de code n'a été écrite.

Jour 2 : escalade du chaos

Le PDG a joué avec les budgets, prêché la synergie. Backend a reçu 15 messages clarificateurs du chef d'équipe, puis est tombé en timeout. Frontend a attendu l'API et a commencé un projet personnel.

Résultats après 2 jours :

• 79 000 jetons dépensés pour discussions et rapports.
• 0 ligne utile de code, carte de job cassée (rollback requis).
• 30 % du taux journalier consommé.

Les performances de l'équipe IA ont reflété celles d'une équipe humaine : discours interminables, zéro exécution.

Ce qui compte

• Paperclip simule fidèlement le chaos d'une entreprise : la hiérarchie ne prévient pas la procrastination des agents.
• Le contrôle budgétaire fonctionne, mais le surcoût de communication vide les ressources.
• Pour les devs confirmés : utile pour les prototypes, mais nécessite un réglage fin des prompts et rôles.
• Le battement sauve les jetons, mais ne corrige pas les problèmes d'alignement dans les tâches complexes.
• L'écosystème progresse : Zeabur, et bientôt Clipmart pour des équipes IA prêtes à l'emploi.

Retours pratiques

Paperclip excelle à automatiser les tâches répétitives, mais peine face aux tâches production impliquant des systèmes hérités ou des spécifications strictes. Recommandations :

• Simplifiez les prompts ; évitez les spécifications longues.
• Fixez des délais fermes dans les cycles de battement.
• Utilisez-le pour des sous-tâches parallèles, pas pour des fonctionnalités monolithiques.

Le projet montre que les agents LLM actuels reproduisent encore les faiblesses humaines — mais avec des ajustements, ils deviendront des outils puissants pour scaler les équipes de développement.

— Editorial Team