Skip to main content

​
¿Qué problema resuelve?

Un solo founder no puede estar en todos lados al mismo tiempo. Hay tareas operativas —armar un hiring plan, definir roles, crear estructura organizacional— que consumen tiempo de ejecución que podría estar en otra parte. Paperclip propone algo concreto: un plano de control humano para trabajo delegado a agentes de IA, donde cada agente tiene un rol, un modelo asignado y opera sobre un issue tracker propio. La pregunta no es si los agentes pueden hacer estas cosas. La pregunta es si existe una interfaz que haga ese trabajo auditable y controlable sin que tengas que escribir infraestructura custom. Paperclip es esa interfaz.

​
Antes de empezar

  • Tener Node.js instalado (para correr npx)
  • Acceso a un modelo compatible — en este playbook se usa gpt-5.4 vía el adapter Codex
  • Tener claro el nombre de tu empresa y su misión (se piden en el onboarding)
  • Paperclip es open source — podés revisar el repo antes de correr nada

​
Pasos

1

Inicializar Paperclip con npx

Desde tu terminal, corré el comando de onboarding. El flag --yes acepta los defaults sin prompts interactivos.
$ npx paperclipai onboard --yes
Esto levanta la app localmente. Una vez que termina, abrí la URL de onboarding que Paperclip imprime al final del comando.
2

Configurar tu empresa y misión

El onboarding te pide dos cosas básicas:
  • Company name: el nombre de tu proyecto o empresa (ej: Dante id)
  • Mission: una frase que define el foco (ej: how to build ai startups in a post-ai era)
Esto no es cosmético — la misión se usa como contexto para los agentes que creés después.
3

Crear tu primer agente

Dentro del onboarding, configurás el primer agente con:
  • Agent name: el rol que va a cumplir (ej: CEO)
  • Adapter: el proveedor del modelo (ej: Codex)
  • Model: el modelo específico (ej: gpt-5.4)
Cada agente tiene un adapter y modelo asignado de forma explícita. Esto te permite mezclar modelos por rol si lo necesitás más adelante.
4

Asignar la primera tarea y abrir el issue

Con el agente configurado, escribís la tarea inicial en lenguaje natural y hacés click en Create & Open Issue.Ejemplo de tarea usada en este playbook:
Hire your first engineer and create a hiring plan
Paperclip convierte esa tarea en un issue dentro de su tracker interno (formato DAN-1, DAN-2, etc.) y el agente empieza a ejecutar de forma autónoma.
5

Observar la ejecución en tiempo real

El dashboard muestra el agente con status RUNNING y va comentando sus acciones en el issue, igual que haría un colaborador humano en GitHub Issues o Linear.En el caso del agente CEO ALPHA, antes de crear cualquier artefacto, el agente verificó el estado actual de la empresa, revisó el payload de contratación disponible y planificó crear el rol de CTO junto con las tareas derivadas — todo documentado en el issue con el tag Worked - ran 3 commands.
El agente no ejecuta a ciegas. Primero inspecciona el contexto disponible, luego actúa. Eso hace que los comentarios en el issue sean útiles para auditar qué hizo y por qué.

​
Errores comunes

No asumas que el agente va a ejecutar todo en un solo paso. En el ejemplo de este playbook, el CEO verificó primero que no había otros roles configurados antes de proponer contratar un CTO. Si le das una tarea ambigua o sin contexto suficiente, el agente puede quedarse en un loop de verificación sin producir artefactos concretos. Sé específico en la tarea inicial.

​
Lo que aprendimos

  • El issue tracker es el contrato. Paperclip no es solo un runner de agentes — es un sistema donde cada tarea tiene trazabilidad completa. Cada comando ejecutado, cada decisión tomada, queda registrada en el issue. Para un solo founder, eso reemplaza la necesidad de supervisar en tiempo real.
  • El onboarding tarda menos de 5 minutos. Desde npx paperclipai onboard --yes hasta tener un agente corriendo una tarea real, el tiempo efectivo es menor a lo que tarda en arrancar la mayoría de los setups de infraestructura de agentes.
  • La misión de la empresa importa como contexto. No es un campo decorativo. El agente usa ese contexto para tomar decisiones coherentes con el foco del proyecto. Vale la pena escribirla con precisión desde el inicio.