← Volver al listado de tecnologías ← Índice de Paperclip

Tu primera compañía: configuración paso a paso

Por: Artiko
paperclipconfiguraciónempresaorg chart

El momento de crear algo real

Este capítulo es práctico de principio a fin. Vamos a crear una empresa de desarrollo de software completa: con goals, iniciativas, org chart, y configuración del Board. No es un ejemplo de juguete: al terminar tendrás una empresa que puedes usar como base real para agregar agentes en el capítulo siguiente.

La empresa que vamos a crear es DevCo: una empresa de software que construye una SaaS B2B. Sus objetivos son crecer el MRR, mejorar la calidad del código, y mantener el tiempo de respuesta del soporte por debajo de las 2 horas.

Abre el navegador en http://localhost:3100 y sigue los pasos.

Paso 1: Crear la empresa

Si acabas de instalar Paperclip, el onboarding wizard te habrá llevado a la pantalla de crear empresa. Si ya estás en el dashboard, ve a Settings → Companies → New Company.

Completa el formulario con:

La descripción es importante: se inyecta como contexto en todos los agentes de la empresa. Cuanto más precisa y útil sea, mejor entenderán los agentes qué tipo de empresa son y qué se espera de ellos.

Haz clic en Create Company. El sistema crea la entidad en la base de datos y te lleva a la vista de configuración de la empresa.

Paso 2: Definir los goals de la empresa

Los goals son las intenciones estratégicas de alto nivel. Son el norte que guía a todos los agentes, especialmente al CEO. Se accede desde Company → Goals.

Añade estos goals uno por uno usando el botón Add Goal:

Goal 1: Alcanzar $50,000 MRR antes del Q4 2026 mediante la adquisición de 200 nuevos clientes y la reducción del churn por debajo del 3% mensual.

Goal 2: Mantener la cobertura de tests por encima del 80% en todos los servicios críticos y tiempo de build por debajo de 5 minutos.

Goal 3: Responder el 95% de los tickets de soporte en menos de 2 horas durante horario laboral y el 100% en menos de 24 horas fuera de horario.

Goal 4: Hacer deploy a producción al menos 3 veces por semana con cero incidentes críticos.

Los goals tienen un campo opcional de fecha objetivo y KPI de éxito. Completarlos ayuda al CEO-agente a priorizar mejor:

Goal: Alcanzar $50,000 MRR
Fecha objetivo: 2026-12-31
KPI: monthly_recurring_revenue >= 50000
Fuente del KPI: dashboard interno, verificable en /admin/metrics

Paso 3: Crear las iniciativas

Las iniciativas son más concretas que los goals. Son proyectos o programas de trabajo que contribuyen a lograr uno o más goals. Se accede desde Company → Initiatives → New Initiative.

Crea estas cuatro iniciativas:

Initiative 1: Refactoring del módulo de facturación

Initiative 2: Chatbot de soporte de primera línea

Initiative 3: Pipeline de CI/CD automatizado

Initiative 4: Campaña de contenido técnico

Paso 4: Configurar el Board

El Board eres tú. La configuración del Board define cómo interactúas con la empresa: qué requiere tu aprobación, con qué frecuencia recibes notificaciones, y qué poderes ejerces activamente.

Ve a Company → Board Configuration.

Completa tu perfil de Board member:

Nombre: Tu nombre
Email: [email protected]
Nivel de supervisión: Supervisión activa (recomendado para empezar)

El nivel de supervisión controla el comportamiento por defecto del sistema:

Configuración de aprobaciones requeridas:

Activa estas opciones para empezar:

✓ Contratar nuevos agentes (Board approval required)
✓ Cambios de estrategia del CEO (aprobación antes de implementar)
✓ Gastos superiores a $50 en un solo task
✓ Deploy a producción (override de Board disponible)
✗ Creación de tareas de rutina (no requiere aprobación)
✗ Asignación de tareas entre agentes (no requiere aprobación)

Configuración de notificaciones:

✓ Email: resumen diario a las 18:00
✓ Email: alertas críticas inmediatas
✓ En la UI: todas las actividades (badge en el icono)

Paso 5: Construir el org chart

El org chart define la jerarquía de la empresa. En Paperclip, el org chart no es decorativo: define el flujo de trabajo, la delegación de tareas, y los paths de escalación.

Ve a Company → Org Chart → Edit.

La UI de org chart es visual: arrastras agentes a posiciones en la jerarquía. Pero antes de crear agentes reales (que veremos en el capítulo siguiente), puedes definir la estructura vacía con placeholder roles.

Para DevCo, la estructura es:

graph TD
    Board[Board - Tú]
    CEO[CEO - Felipe]
    CTO[CTO - Ana]
    Support[Head of Support - Carlos]
    Eng1[Ingeniero Senior - Rafa]
    Eng2[Ingeniero Jr - María]
    SupportAgent[Agente Soporte L1 - Bot24/7]
    
    Board -->|aprueba| CEO
    CEO --> CTO
    CEO --> Support
    CTO --> Eng1
    CTO --> Eng2
    Support --> SupportAgent

En la UI, puedes crear estos roles como Agent Placeholders (roles sin agente asignado todavía) o directamente crear los agentes. Por ahora, crea los placeholders:

  1. Haz clic en Add Role en el org chart
  2. Rellena: Título CEO, Descripción Responsable de la estrategia general, priorización de iniciativas, y coordinación del equipo directivo.
  3. Repite para: CTO, Head of Support, Ingeniero Senior (x2), Agente Soporte L1

La jerarquía queda definida arrastrando los roles a sus posiciones. El sistema automáticamente configura los campos managerId y reportIds de los agentes.

Paso 6: Importar un org template vs crear desde cero

Si no quieres crear la estructura desde cero, Paperclip incluye org templates: plantillas predefinidas de estructuras organizativas comunes.

Ve a Company → Org Chart → Import Template.

Los templates disponibles incluyen:

- startup_dev_5:     CEO + CTO + 2 ingenieros + QA
- startup_dev_10:    CEO + CTO + CMO + 5 ingenieros + soporte
- agency_creative:   CEO + Directora Creativa + 3 diseñadores + PM
- ecommerce_ops:     CEO + COO + 2 operaciones + soporte + marketing
- saas_growth:       CEO + CTO + Head of Growth + 4 ICs mixtos

Si eliges un template, el sistema crea todos los placeholders de roles automáticamente con descripciones predefinidas. Puedes modificar cualquier descripción después de importar.

La diferencia entre template y snapshot:

Paso 7: Exportar la empresa

Antes de continuar, guarda un backup de la configuración de la empresa. Esto es útil para:

Ve a Company → Settings → Export.

Tienes dos opciones de export:

Export como template: Exporta solo la estructura (roles, goals, iniciativas vacías). No incluye tareas, historial, ni datos de agentes específicos. Útil para compartir tu estructura como punto de partida.

Export como snapshot: Exporta todo el estado actual. Incluye tareas, historial, configuraciones de agentes, y presupuestos. Útil para backups y migraciones.

El export genera un archivo JSON que puedes guardar localmente o versionar en git:

{
  "version": "1.0",
  "exportType": "template",
  "company": {
    "name": "DevCo",
    "description": "Empresa de software B2B...",
    "industry": "Software / SaaS",
    "goals": [
      "Alcanzar $50,000 MRR antes del Q4 2026...",
      "Mantener la cobertura de tests por encima del 80%..."
    ]
  },
  "orgStructure": {
    "roles": [
      {
        "title": "CEO",
        "description": "Responsable de la estrategia general...",
        "level": 1,
        "reportsTo": null
      },
      {
        "title": "CTO",
        "description": "Responsable de la estrategia técnica...",
        "level": 2,
        "reportsTo": "CEO"
      }
    ]
  },
  "initiatives": [
    {
      "title": "Refactoring módulo facturación",
      "description": "...",
      "status": "planned"
    }
  ]
}

Para importar este template en otro deployment:

# Via CLI
npx paperclipai import --file devco-template.json --company-name "DevCo Clone"

# Via UI
Company → Settings → Import → seleccionar archivo JSON

Paso 8: Configurar los presupuestos iniciales

Antes de añadir agentes reales, es buena práctica configurar el presupuesto mensual de la empresa. Este presupuesto es el techo global: ningún agente puede gastar más que su cuota individual, y la suma de todas las cuotas no debería exceder el presupuesto de empresa.

Ve a Company → Budget.

Configura un presupuesto mensual de empresa:

Presupuesto mensual total: $200
Distribución sugerida:
  CEO:                $20  (análisis estratégico, poco intensivo)
  CTO:                $40  (revisiones de código, diseño técnico)
  Head of Support:    $20  (coordinación del equipo de soporte)
  Ingeniero Senior:   $50  (implementación intensa)
  Ingeniero Jr:       $30  (implementación, menor volumen)
  Agente Soporte L1:  $40  (24/7, muchas interacciones)
  
  Total asignado:    $200  ✓

El sistema alerta si los presupuestos individuales suman más que el presupuesto de empresa. No bloquea, pero muestra un warning.

Configura también los umbrales de alerta:

Verificación: el estado de la empresa antes de añadir agentes

Antes de pasar al siguiente capítulo, verifica que la empresa está bien configurada. Ve a Company → Overview y confirma:

graph LR
    A{Company creada} -->|✓| B{Goals definidos}
    B -->|✓| C{Iniciativas creadas}
    C -->|✓| D{Board configurado}
    D -->|✓| E{Org chart definido}
    E -->|✓| F{Presupuestos configurados}
    F -->|✓| G[Lista para agentes]

Si el overview muestra:

Entonces la empresa está lista. En el próximo capítulo, poblaremos el org chart con agentes reales: configuraremos sus adapters, les asignaremos skills, y haremos el primer test de ejecución.

Tips para una buena configuración de empresa

Sé específico en las descripciones. Una descripción vaga como “empresa de tecnología” no ayuda a los agentes. Una descripción que incluye el stack técnico, el tipo de clientes, los valores de la empresa, y las decisiones arquitectónicas recientes hace que los agentes trabajen con mucho más contexto relevante.

Los goals deben ser medibles. “Mejorar la calidad” es un goal débil. “Mantener la cobertura de tests por encima del 80%, medida en cada PR” es un goal que un agente puede usar para tomar decisiones concretas.

Empieza con estructura simple. Es tentador crear un org chart de 15 personas desde el primer día. Empieza con 3-5 agentes bien configurados y expande conforme entiendes cómo trabaja el sistema.

Versiona tu configuración. Exporta la empresa regularmente y guarda los snapshots en git. Si algo sale mal con una configuración, puedes restaurar a un estado conocido.

Las iniciativas dan contexto de largo plazo. Cuando un agente toma una tarea, ve la iniciativa a la que pertenece. Una tarea “Añadir validación de email” tiene mucho más contexto si el agente sabe que es parte de la iniciativa “Refactoring módulo de registro”.

Con la empresa configurada, el siguiente capítulo cubre la pieza central: qué son los agentes en Paperclip, cómo funciona cada tipo de adapter, y cómo contratar tu primer agente con aprobación del Board.

← Volver al listado de tecnologías ← Índice de Paperclip