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

# Inicio rápido

> Configura tu primer workspace, conecta un repositorio y ejecuta tu primera revisión en Acrity.

Esta guía muestra el camino mínimo para empezar a usar Acrity en un workspace.

## Antes de empezar

Necesitas:

* Acceso a la Consola de Acrity.
* Un usuario con permiso de Admin de workspace en el workspace.
* Permiso para instalar o autorizar el proveedor de código usado por el equipo.
* Al menos un repositorio con pull requests o merge requests activos.
* Opcionalmente, acceso administrativo a una herramienta de gestión de trabajo como Jira, Linear o ClickUp.

## Flujo recomendado

```mermaid theme={null}
flowchart TD
  A[Selecciona el workspace] --> B[Conecta el proveedor]
  B --> C[Conecta repositorios]
  C --> D[Bootstrap de ARCHITECTURE.md]
  D --> E[Ajusta la política de revisión]
  E --> F[Valida el primer PR/MR]
```

<Note>
  Aplicaciones conectadas, Credenciales, Conectores, Repositorios y Policy Engine requieren un Admin de workspace (los admins de plataforma también tienen acceso).
</Note>

<Steps>
  <Step title="Selecciona tu workspace">
    Entra en la Consola y elige el workspace desde el selector superior.
  </Step>

  <Step title="Revisa idioma y miembros">
    En el selector de workspace y en la configuración del workspace, confirma el idioma predeterminado, los Admins de workspace y los usuarios que necesitan dar seguimiento a las revisiones.
  </Step>

  <Step title="Conecta el proveedor de código">
    Ve a `Consola > Aplicaciones conectadas` cuando puedas usar OAuth o una GitHub App. Usa `Consola > Credenciales` para credenciales manuales. Usa `Consola > Conectores` cuando el VCS sea privado, self-hosted o esté en una red restringida.
  </Step>

  <Step title="Conecta repositorios">
    En `Consola > Repositorios`, selecciona `Conectar repositorio`, elige el origen de autenticación y confirma los repositorios que deben recibir revisiones.
  </Step>

  <Step title="Bootstrap de ARCHITECTURE.md">
    Abre el repositorio en `Consola > Repositorios > Detalle del repositorio` e inicia el Bootstrap de ARCHITECTURE.md. Esto da a las revisiones el contexto del proyecto del que dependen. Un repositorio no está listo para revisiones hasta que tiene un ARCHITECTURE.md generado con Bootstrap, así que completa este paso para cada repositorio que conectes.
  </Step>

  <Step title="Ajusta la política de revisión">
    Usa `Consola > Policy Engine` para las reglas del workspace y, cuando sea necesario, ajusta configuraciones específicas en `Consola > Repositorios > Detalle del repositorio`.
  </Step>

  <Step title="Valida el primer PR o MR">
    Abre o actualiza un PR/MR en el proveedor de código y sigue la revisión en el [dashboard Ops](/en/guides/ops-dashboard) — donde aparecen las revisiones — y en la salida del proveedor. Usa `Consola > Audit Trail` solo para detalles técnicos del evento y diagnóstico.
  </Step>
</Steps>

## Decisión rápida: ¿qué tipo de conexión usar?

| Escenario                                                              | Usa                     |
| ---------------------------------------------------------------------- | ----------------------- |
| GitHub Cloud con instalación administrada                              | GitHub App conectada    |
| GitLab, Bitbucket, Azure DevOps, Jira, Linear o ClickUp mediante OAuth | Aplicaciones conectadas |
| Token personal, token de proyecto o credencial técnica                 | Credenciales            |
| VCS privado, VCS self-hosted o sin acceso entrante hacia la cloud      | Conectores              |

<Tip>
  Prefiere las aplicaciones conectadas cuando el proveedor las admita. Simplifican la autorización, la reautorización y el descubrimiento de repositorios.
</Tip>

## Checklist de preparación para producción

* El workspace tiene al menos dos Admins de workspace.
* Los repositorios importantes aparecen como listos en `Consola > Repositorios`, cada uno con un ARCHITECTURE.md generado con Bootstrap.
* Los idiomas del workspace y de los repositorios son correctos.
* La política de autores bloquea las cuentas que no deben generar costo ni actividad de revisión.
* Las API keys tienen el alcance mínimo, expiración y allowlist de IP cuando corresponde.
* Los webhooks salientes usan HMAC cuando el destino admite verificación.
* Los Admins de workspace revisaron las páginas de seguridad antes de configurar credenciales de producción.