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

# Mejores prácticas

> Cómo estructurar el trabajo con Devin para maximizar la eficiencia y el ROI

Identificar el caso de uso adecuado para Devin es clave para maximizar la eficiencia y el retorno de la inversión (ROI). A continuación, se describen las mejores prácticas para seleccionar un caso de uso que se alinee con las fortalezas de Devin.

<div id="best-enterprise-use-cases">
  ## Mejores casos de uso para Enterprise
</div>

| **Criterios del caso de uso ideal**                                                                             |
| :-------------------------------------------------------------------------------------------------------------- |
| Proyectos grandes y de alto valor para el negocio que puedan dividirse en **subtareas aisladas y repetitivas**. |
| Tareas que requieran **menos de 90 minutos** de tiempo de ingeniería manual.                                    |
| **Tareas compatibles con versiones anteriores** que puedan validarse y fusionarse de forma independiente.       |

<div id="devins-ideal-requirements">
  ## Requisitos ideales para Devin
</div>

| **Requisito**                                                    |
| :--------------------------------------------------------------- |
| Alto volumen de **subtareas repetitivas** (slices)               |
| Tareas con complejidad de **ingeniero junior**                   |
| Tareas **aisladas e incrementales**                              |
| Subtareas **objetivas y verificables**                           |
| **(Recomendado)** Mínimas dependencias con el resto del proyecto |

Si tu tarea cumple la mayoría o la totalidad de estos requisitos, es una candidata ideal para Devin.

<div id="crafting-devins-work">
  ## Diseñar el trabajo de Devin
</div>

Seleccionar el **tipo de tarea** adecuado es clave para maximizar la fiabilidad de Devin.

| **Escenario**                                                                                             | **Consideración sobre la fiabilidad** | **Tipo de tarea**  |
| --------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------ |
| Pedir a Devin que desarrolle **funcionalidades complejas completamente nuevas** (aunque sean repetitivas) | Menor fiabilidad a escala             | **Tall & Deep**    |
| Asignar a Devin **tareas simples y bien definidas**                                                       | Muy fiable y eficaz                   | **Wide & Shallow** |

<div id="tall-deep-vs-wide-shallow">
  ### Estrecho y profundo vs. ancho y superficial
</div>

<div style={{ width: '100%' }}>
  <img src="https://mintcdn.com/cognitionai-enterprise/A1NrXl_1--Cgx5nh/images/use-cases/narrow-deep-vs-shallow.png?fit=max&auto=format&n=A1NrXl_1--Cgx5nh&q=85&s=31e8a4ed3215dda3a3bb7a530dbdc75a" alt="Comparación entre estrecho-profundo y superficial-amplio" width="50%" style={{ marginLeft: 'auto', marginRight: 'auto' }} data-path="images/use-cases/narrow-deep-vs-shallow.png" />
</div>

Un **gran backlog** de tareas simples, **escalables horizontalmente** (por ejemplo, resolver incidencias de SonarQube) puede generar un **ROI** significativo cuando se aplica a lo largo de miles de iteraciones.

<img src="https://mintcdn.com/cognitionai-enterprise/A1NrXl_1--Cgx5nh/images/use-cases/horizontal-changes.png?fit=max&auto=format&n=A1NrXl_1--Cgx5nh&q=85&s=573767f3f77f9a58c0781b8e02bebc31" alt="Diagrama de cambios horizontales" width="1916" height="322" data-path="images/use-cases/horizontal-changes.png" />

<Note>
  Cuanto más simple sea el segmento, más **fiable** será el proyecto en su conjunto.
</Note>

<div id="what-to-slice">
  ## Qué dividir
</div>

**Excelentes candidatos para Devin:**

* **Migraciones**
* **Refactors**
* **Modernizaciones**
* **Backlogs de deuda técnica**

Por ejemplo, al trabajar en una **migración de código**, debe dividirse en **segmentos independientes**, cada uno gestionado por una sesión individual de Devin.

<img src="https://mintcdn.com/cognitionai-enterprise/A1NrXl_1--Cgx5nh/images/use-cases/slicing-use-cases.png?fit=max&auto=format&n=A1NrXl_1--Cgx5nh&q=85&s=6aa284d1718ffdbee6c34bc5941c6f0f" alt="Slicing use cases illustration" width="2000" height="581" data-path="images/use-cases/slicing-use-cases.png" />

<div id="verification">
  ## Verificación
</div>

Una *slice* debe ser la **unidad atómica más pequeña** del proyecto.

| **Slices de ejemplo** |
| :-------------------- |
| **Archivo**           |
| **Notebook**          |
| **Módulo**            |

| **Requisito**        | **Detalles**                                                                                                                                                                                                   |
| :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Límite de tiempo** | Cada slice debe requerir **menos de 90 minutos** de trabajo de ingeniería manual.                                                                                                                              |
| **Verificación**     | Debe incluir una forma de **validar los cambios de código**, por ejemplo: <br /> - Ejecutar pruebas <br /> - Compilar el código <br /> - Verificaciones de CI <br /> - Un script de verificación personalizado |

<Warning>
  Devin debe tener un mecanismo de verificación de **éxito o fallo** claro.
</Warning>

<Tip>
  Evita tareas con **dependencias** excesivas o sistemas externos. Devin destaca en **tareas de programación**.
</Tip>

<img src="https://mintcdn.com/cognitionai-enterprise/A1NrXl_1--Cgx5nh/images/use-cases/backwards-compatibility.png?fit=max&auto=format&n=A1NrXl_1--Cgx5nh&q=85&s=af04cf632b6147d00d0a7b8770ea7565" alt="Diagrama de retrocompatibilidad" width="1746" height="1332" data-path="images/use-cases/backwards-compatibility.png" />

<div id="parallel-execution">
  ## Ejecución en paralelo
</div>

| **Requisito**             | **Descripción**                                                                                           |
| ------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Aislamiento**           | Cada segmento debe ser **independiente** y **compatible con versiones anteriores**.                       |
| **Ejecución en paralelo** | Usa **el paralelismo de Devin** para ejecutar los segmentos **simultáneamente**.                          |
| **Revisión humana**       | Después de completar cada segmento, debe pasar por una **revisión humana** antes de fusionarse en `main`. |

<img src="https://mintcdn.com/cognitionai-enterprise/A1NrXl_1--Cgx5nh/images/use-cases/parallel-execution.png?fit=max&auto=format&n=A1NrXl_1--Cgx5nh&q=85&s=a433d54e210090f0684cc52fe1dc9721" alt="Visualización de ejecución en paralelo" width="2576" height="872" data-path="images/use-cases/parallel-execution.png" />

<div id="scaling-considerations">
  ## Consideraciones de escalado
</div>

<img src="https://mintcdn.com/cognitionai-enterprise/A1NrXl_1--Cgx5nh/images/use-cases/overall-model.png?fit=max&auto=format&n=A1NrXl_1--Cgx5nh&q=85&s=19606bc8be5371a190001df9daf3d2cf" alt="Diagrama general del modelo" width="2216" height="1510" data-path="images/use-cases/overall-model.png" />

| **Principio**                      | **Descripción**                                                                                      |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Confiabilidad a nivel de slice** | Devin está optimizado para ofrecer **la máxima confiabilidad** a nivel de **cada slice individual**. |
| **Consideración de escalado**      | Al escalar a **miles de slices**, mantener una **alta confiabilidad** es fundamental.                |
| **Impacto de errores**             | Incluso una tasa de error pequeña puede multiplicarse cuando se ejecuta a gran escala.               |

<div id="best-practices-for-task-definition">
  ## Mejores prácticas para la definición de tareas
</div>

| **Requisito**                       | **Descripción**                                                                     |
| ----------------------------------- | ----------------------------------------------------------------------------------- |
| **Detalles claros de los pasos**    | Proporciona **instrucciones explícitas** para cada subtarea.                        |
| **Referencia de extremo a extremo** | Una **guía o video detallado** ayuda a garantizar la consistencia.                  |
| **Ejemplos de antes/después**       | Ofrece múltiples **ejemplos de código de antes/después** (pares de entrada/salida). |
| **Acceso a dependencias**           | Asegúrate de que Devin tenga **todas las dependencias necesarias** para la tarea.   |

Devin sobresale en tareas continuas relacionadas con la **deuda técnica** (por ejemplo, **revisiones de PR, automatización de QA**) cuando están correctamente **segmentadas y estructuradas**.

<Note>
  Las migraciones, modernizaciones y refactorizaciones son casos de uso sólidos **si se pueden abordar de forma incremental**.
  Por ejemplo, una migración de todo el repositorio que requiera **todos los cambios a la vez** **no es recomendable**.
</Note>

**Caso de estudio:** [Caso de estudio de migración de Nubank](https://devin.ai/customers/nubank)