> ## Documentation Index
> Fetch the complete documentation index at: https://docs.puente.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Conceptos

> Puente OS: Workspace, Teams, Projects, Tasks y Builds.

Antes de profundizar en cada componente, conviene entender cómo está organizado todo. Puente OS combina **dos capas integradas** en una sola plataforma:

<CardGroup cols={2}>
  <Card title="Capa de gestión" icon="list-check">
    Workspace, Teams, Projects, Tasks, Cycles e Initiatives.
  </Card>

  <Card title="Capa de construcción" icon="hammer">
    Apps, Databases, Workflows y Agents dentro de cada Project.
  </Card>
</CardGroup>

Mismo workspace, mismos equipos, sin cambio de herramienta entre planificar y construir.

## Jerarquía completa

```text theme={null}
WORKSPACE (la organización completa)
├── TEAMS (Ops, Finance, HR, RevOps — equipos del cliente)
│   ├── PROJECTS (iniciativas operativas concretas)
│   │   ├── TASKS (gestión operativa, Kanban)
│   │   │   └── SUB-TASKS
│   │   ├── DOCS (specs, contexto, decisiones)
│   │   └── BUILDS (los 4 módulos):
│   │       ├── APPS         (interfaces)
│   │       ├── AGENTS       (agentes IA)
│   │       ├── WORKFLOWS    (automatizaciones)
│   │       └── DATABASES    (datos persistentes)
│   
│   
└── INITIATIVES (objetivos estratégicos cross-team)
```

***

## Workspace

El **Workspace** es el contenedor principal: representa a toda tu organización. Cada empresa tiene **un solo workspace** donde viven todos sus equipos, proyectos y artefactos.

<Note>
  Los datos de un workspace son privados y nunca son legibles desde otro workspace. Multi-tenancy estricto.
</Note>

***

## Teams

Un **Team** es un sub-grupo dentro del workspace — típicamente representa un departamento (Operaciones, Finanzas, RevOps) o un squad.

Cada Team tiene:

* Su propia lista de **Projects**
* Su propio **Cycle** opcional (cadencia semanal, quincenal, etc.)
* Sus propios miembros y permisos

<Tip>
  Si tu organización es pequeña, basta con un Team. Crear varios Teams tiene sentido cuando distintos grupos trabajan con cadencias o procesos diferentes.
</Tip>

***

## Projects

Un **Project** es una iniciativa operativa concreta — el contenedor donde **gestión** (tasks) y **construcción** (apps, databases, workflows, agents) conviven.

Ejemplos:

* "Conciliación bancaria mensual"
* "Onboarding de nuevos clientes"
* "Forecast de inventario Q3"

Dentro de un Project encuentras:

| Item       | Para qué sirve                                                     |
| ---------- | ------------------------------------------------------------------ |
| **Tasks**  | Unidades atómicas de trabajo operativo (Kanban o lista)            |
| **Docs**   | Specs, decisiones, contexto                                        |
| **Builds** | Los 4 módulos de construcción (Apps, Databases, Workflows, Agents) |

***

## Builds — los 4 módulos de construcción

Cada Project puede contener cualquier cantidad de **Builds**. Son los artefactos que realmente entregan valor.

<CardGroup cols={2}>
  <Card title="Apps" icon="window" href="/componentes/app-builder">
    Interfaces web construidas con IA. La capa donde tus usuarios interactúan.
  </Card>

  <Card title="Databases" icon="table" href="/componentes/databases">
    Datos persistentes con schema, validación e historial.
  </Card>

  <Card title="Workflows" icon="diagram-project" href="/componentes/workflows">
    Automatizaciones con triggers, condiciones, código Python y agentes.
  </Card>

  <Card title="Agents" icon="robot" href="/componentes/agents">
    Agentes IA conversacionales embebibles donde necesites.
  </Card>
</CardGroup>

<Tip>
  Los 4 módulos se conectan entre sí. Una **App** puede leer y escribir una **Database**. Un **Workflow** puede dispararse cuando cambia una fila. Un **Agent** puede usar Databases como contexto y Workflows como herramientas.
</Tip>

***

## Tasks

Las **Tasks** son unidades atómicas de trabajo operativo. Cada Task tiene:

* **Estado** (Backlog, Todo, In Progress, Done, Cancelled)
* **Prioridad** (Urgent, High, Medium, Low)
* **Asignado** y **Fecha límite**
* Comentarios, sub-tasks y referencias a Builds

Las Tasks viven dentro de un Project. Se visualizan en **Kanban** (tarjetas) o **Lista** (tabla).

<Note>
  El vocabulario es **Task** y no "Issue": en Puente OS el lente es el del operador, no el del bug tracker. La mecánica es la misma, el nombre encarna la opinión.
</Note>

***

## Cycles

Un **Cycle** es un período de tiempo recurrente (1-8 semanas) donde el equipo enfoca su trabajo. Es opcional pero recomendado para equipos que quieran ritmo predecible.

Cada Cycle se mide por:

* **Tasks completadas** vs planificadas
* **Carry-over** (lo que no alcanzó)
* **Velocity** (tasks/cycle)

<Note>
  Los Cycles son por Team. Distintos teams pueden tener distintas cadencias.
</Note>

***

## Initiatives

Las **Initiatives** son objetivos estratégicos que **cruzan teams**. Una Initiative agrupa múltiples Projects de distintos teams que apuntan al mismo norte.

Ejemplo: "Subir NPS de 40 a 65" puede involucrar Projects de Ops, Producto y Soporte.

***

## Cómo se relaciona todo

<Steps>
  <Step title="Estrategia">
    El liderazgo define **Initiatives** — el norte.
  </Step>

  <Step title="Equipos">
    Cada **Team** crea **Projects** que aportan a una o más Initiatives.
  </Step>

  <Step title="Trabajo operativo">
    Dentro de cada Project, los miembros crean **Tasks** y las mueven por estados.
  </Step>

  <Step title="Construcción">
    Cuando una Task requiere software, se construye un **Build** (App, Database, Workflow o Agent) en el mismo Project.
  </Step>

  <Step title="Ritmo">
    Si el Team usa **Cycles**, las Tasks se planifican por ciclo y se mide velocidad.
  </Step>
</Steps>

***

## Siguiente paso

Ahora que tienes el modelo mental:

<CardGroup cols={2}>
  <Card title="Glosario" icon="book" href="/essentials/glosario">
    Diccionario rápido de todos los términos.
  </Card>

  <Card title="Empieza por Workspace" icon="bars" href="/componentes/workspace">
    La navegación central del workspace.
  </Card>
</CardGroup>