DEV Community

Cover image for Paperclip : Comment gérer une entreprise individuelle avec ce framework open source
Antoine Laurent
Antoine Laurent

Posted on • Originally published at apidog.com

Paperclip : Comment gérer une entreprise individuelle avec ce framework open source

Paperclip est un framework open source pour entreprise individuelle qui orchestre les agents IA comme des employés : organigrammes, budgets, planification des pulsations, approbations de gouvernance et un journal d'audit complet. Une seule commande le démarre localement. Vos agents font le travail ; vous dirigez la réunion du conseil.

Essayez Apidog dès aujourd'hui

Diriger une entreprise individuelle en 2026 ne signifie plus tout faire soi-même, mais plutôt diriger une équipe d'agents IA qui effectuent le travail pendant que vous vous concentrez sur la stratégie. Paperclip est le framework open source pour entreprise individuelle conçu pour rendre cela possible. Il offre aux fondateurs solitaires un organigramme, un système de budget, une couche de gouvernance et un suivi des tâches pour leurs agents IA, le tout dans un tableau de bord auto-hébergé. Si vous utilisez également Apidog pour concevoir, simuler et tester les API avec lesquelles vos agents interagissent, Paperclip complète la pile : Apidog possède le contrat API, Paperclip possède les agents qui l'appellent. Ce guide explique exactement comment Paperclip fonctionne et comment l'intégrer dès aujourd'hui dans une opération individuelle.

💡Procurez-vous Apidog (gratuit) avant votre première pulsation Paperclip. Intégrez des URL de maquette dans les descriptions de tâches afin que les agents développent en fonction de contrats parfaits — coût zéro, surprises zéro. Passez aux API réelles plus tard avec les tests Apidog qui détectent toute dérive avant que le budget ne s'épuise.

Qu'est-ce que Paperclip et pourquoi le framework d'entreprise individuelle est-il important pour les utilisateurs d'Apidog ?

Le slogan de Paperclip le dit directement : "Si OpenClaw est un employé, Paperclip est l'entreprise."

Paperclip est un serveur Node.js et une interface utilisateur React qui transforme votre collection d'agents IA en une organisation structurée avec des titres, des lignes hiérarchiques, des budgets mensuels et des objectifs stratégiques. Contrairement à un simple chatbot ou gestionnaire d'invites, c'est un plan de contrôle pour une entreprise autonome.

Pourquoi ce framework change la donne pour les fondateurs solo :

  • Organigramme : Attribuez des rôles, des titres et des responsables à chaque agent.
  • Problèmes / tâches : Suivi structuré de chaque élément de travail (statut, priorité, responsable).
  • Objectifs : Reliez chaque tâche à des objectifs d'entreprise pour garder le cap stratégique.
  • Pulsations : Les agents se réveillent selon un planning, traitent leur backlog, et rendent compte.
  • Budgets : Limites de dépenses mensuelles par agent, contrôlées automatiquement.
  • Gouvernance : Toute embauche ou décision stratégique passe par votre approbation explicite.

Pour ceux qui utilisent Apidog pour définir et simuler les API, Paperclip orchestre quand, pourquoi, et comment les agents appellent ces API. Apidog définit le contrat ; Paperclip orchestre l'exécution et le suivi.

Pourquoi les fondateurs solitaires choisissent ce framework d'entreprise individuelle plutôt que l'approche Apidog seule

Apidog est optimal pour la conception et la validation d'API. Paperclip gère la couche opérationnelle : objectifs, tâches, budget, gouvernance, audit. Ensemble, ils offrent un système d'exploitation complet pour une entreprise logicielle solo où les humains définissent la vision et les agents IA exécutent.

Fonctionnalités clés du framework d'entreprise individuelle de Paperclip et où Apidog s'intègre

Pulsations : La boucle d'activation d'agent compatible Apidog

À chaque pulsation, un agent exécute la séquence suivante :

  1. GET /api/agents/me : vérification d'identité de l'agent
  2. GET /api/companies/:id/issues?status=todo,in_progress : récupération des tâches à traiter
  3. GET /api/issues/:id : récupération du contexte complet de la tâche
  4. Exécution du travail (code, appel API, génération de contenu)
  5. PATCH /api/issues/:id : mise à jour du statut avec un commentaire détaillé

L'intégration avec Apidog s'effectue au niveau de l'appel d'API : pendant le développement, les agents consomment le serveur de maquette Apidog. En production, ils basculent vers l'endpoint réel sans changer de code. Toute dérive de contrat est détectée par la validation Apidog avant qu'elle n'affecte la production.

Organigramme et Hiérarchie des Objectifs, Apidog comme couche API

La hiérarchie Paperclip s'étend de l'entreprise à l'équipe, à l'agent, à la tâche. Chaque agent, même junior, reçoit le contexte complet pour comprendre la finalité de sa tâche (ex : "améliorer le SEO" → "atteindre $1M MRR").

Dans ce schéma, Apidog agit comme la source de vérité API : définissez, publiez la maquette, référencez l'URL dans la tâche. Toute mise à jour côté Apidog est propagée automatiquement à tous les agents concernés.

Contrôle Budgétaire : Arrêt des Dépenses Incontrôlées dans Votre Flux de Travail Apidog

Chaque agent a un budgetMonthlyCents. À l'atteinte du plafond (spentMonthlyCents), l'agent ne prend plus de tâches. Aucun dépassement possible. Associez cela à Apidog mock : sprints de développement à coût nul, passage en production maîtrisé.

Mise en place de Paperclip comme framework d'entreprise individuelle avec Apidog {#setup}

Démarrage Local Zéro Configuration, Apidog se Connecte Immédiatement

Démarrez Paperclip avec :

npx paperclipai onboard --yes

Cette commande initialise une base PostgreSQL embarquée, génère une clé de chiffrement, applique toutes les migrations et lance le serveur sur http://localhost:3100.

Ensuite :

  1. Ouvrez l'UI, créez une entreprise, définissez un objectif :
"Build the #1 AI-powered API monitoring tool to $1M MRR."
  1. Ajoutez un agent, par exemple un "Ingénieur Backend" avec l'adaptateur claude_local :
{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

Dans la description de tâche, insérez l'URL de collection Apidog :

## Task: Add pagination to the /users endpoint

**Apidog Mock Base:** http://localhost:4523/m1/123456/users
**Acceptance criteria:**
- Endpoint accepts `page` and `limit` query params
- Returns `{ data: [], total: 0, page: 1 }` envelope
- Unit test coverage for edge cases (page=0, limit>100)

L'agent lit la tâche, appelle la maquette Apidog, code, puis rend compte.

Connecter les Maquettes Apidog aux Tâches d'Agent

Les descriptions de tâches Paperclip (markdown enrichi) peuvent inclure l'URL de la maquette Apidog. Cela garantit que l'agent développe toujours selon le contrat API valide.

Exécution des Agents, Tâches et Pulsations dans Paperclip avec Apidog

Gérer les Problèmes via le Pipeline Paperclip Apidog

La CLI Paperclip permet de piloter les tâches directement :

# Créer une tâche pour implémenter un endpoint selon la spec Apidog
pnpm paperclipai issue create \
  --company-id <id> \
  --title "Implement POST /webhooks endpoint per Apidog spec" \
  --description "See Apidog collection: http://localhost:4523/..."

# Vérifier le statut des tâches
pnpm paperclipai issue list --company-id <id> --status in_progress

# Libérer une tâche si un agent bloque
pnpm paperclipai issue release <issue-id>

Toutes les transitions sont journalisées : vous gardez la traçabilité de chaque action d’agent.

Gouvernance et Approbations dans le Framework d'Entreprise Individuelle Intégré à Apidog

Avant chaque embauche ou décision majeure, Paperclip peut exiger votre validation :

# Lister les approbations en attente
pnpm paperclipai approval list --company-id <id>

# Approuver une embauche d'agent
pnpm paperclipai approval approve <approval-id> \
  --decision-note "Approved. Use Apidog mock for first sprint."

Vous gardez le dernier mot : les agents proposent, vous décidez.

Tests, Gouvernance et Contrôle des Coûts dans votre pile Paperclip + Apidog

Exécuter la Suite de Tests Unitaires Paperclip Apidog

Paperclip inclut des tests unitaires (Vitest) et E2E (Playwright) :

# Exécuter tous les tests unitaires
pnpm test:run

# Tests de bout en bout
pnpm test:e2e

# Vérification de santé serveur + Apidog mock
curl http://localhost:3100/api/health

La couverture inclut transitions de tâches, budget, cycle de vie pulsation, auth agent. Un adaptateur IA personnalisé ? Vérifiez la suite avant prod.

En solo, la fiabilité dépend des tests. Les tests unitaires Paperclip et les tests de contrat Apidog sont votre filet de sécurité.

La Pile Qualité à Trois Couches : Paperclip + Apidog + Tests Unitaires

  1. Apidog : définit le contrat API et exécute des tests automatisés à chaque push
  2. Paperclip : tâches avec critères d'acceptation référencés Apidog
  3. Tests unitaires (Vitest) : valident la conformité implémentation/contrat

Ce modèle apporte l'assurance qualité d'une équipe, même en solo.

Conclusion

Paperclip transforme un fondateur solo en une entreprise orchestrée : organigramme, budget, gouvernance, alignement, planification, audit – le tout auto-hébergé et open source.

Pour les développeurs qui utilisent Apidog pour designer et tester leurs API, Paperclip vient compléter la pile. Apidog gère le contrat, Paperclip gère l'orchestration, la gouvernance et le budget. Vos serveurs de maquette Apidog alimentent les agents, vos tests de contrat valident leur sortie, la gouvernance Paperclip garantit aucun mouvement non approuvé.

Mise en place rapide :

  • Démarrage local : npx paperclipai onboard --yes
  • Ouvrez http://localhost:3100, créez votre entreprise, définissez un objectif
  • Ajoutez un agent (20 $/mois), référencez votre serveur de maquette Apidog
  • Exécutez pnpm test:run pour valider avant production
  • Approuvez la première tâche, observez l’agent, vérifiez le journal d’audit

L'entreprise individuelle devient architecture grâce à Paperclip et Apidog.

FAQ

Qu'est-ce que Paperclip ? Paperclip est un framework open source pour entreprise individuelle – un serveur Node.js et une interface utilisateur React qui orchestre les agents IA avec des organigrammes, budgets, pulsations et gouvernance. C'est le plan de contrôle pour gérer une entreprise logicielle avec des agents IA.

Comment Paperclip s'intègre-t-il à Apidog ? Apidog définit les contrats API sur lesquels vos agents travaillent. Intégrez les URL de maquette Apidog dans les tâches Paperclip, les agents appellent ces maquettes pendant le développement, et les tests de contrat Apidog valident l'implémentation finale. Paperclip orchestre, Apidog spécifie.

Paperclip convient-il à une véritable entreprise individuelle ? Oui. La configuration locale (npx paperclipai onboard --yes) ne nécessite aucune infrastructure. Les budgets évitent les dérapages. Le système de pulsation gère le récurrent. L'intégration Tailscale vous permet de piloter vos agents à distance. Scalabilité du local au cloud.

Comment exécuter les tests unitaires ? pnpm test:run pour Vitest, pnpm test:e2e pour Playwright. Vérification de santé via http://localhost:3100/api/health.

Quels agents IA Paperclip prend-il en charge ? Claude (local, via OpenClaw), Codex, Cursor, Gemini, OpenCode, tout agent HTTP ou process local. Système d'adaptateur ouvert.

Paperclip est-il open source ? Oui, licence MIT. Code sur github.com/paperclipai/paperclip. Plugins/adaptateurs/skills disponibles via @paperclipai/* sur npm.

Top comments (0)