Skip to content
← Todos los capítulos

Capítulo 05

Arquetipos de repositorio

Antes de cambiar una sola línea, un agente toma una decisión que lo condiciona todo: ¿qué tipo de repositorio es este? El arquetipo que infiere establece el límite dentro del cual razonará durante el resto del trabajo: cómo se incorpora, hasta dónde llega un plan y dónde vive el estado. Equivocarse significa acotar el trabajo a la superficie equivocada, que es la causa más frecuente de deriva en tareas de largo alcance. Acertar, en cambio, permite al agente trabajar de forma autónoma durante horas, porque planes, incorporación y estado se alinean con la forma real del código.

DWP reconoce dos arquetipos. La mayoría de los repositorios son del primero; el segundo existe para los equipos que coordinan muchos.

Repositorio individual

El caso habitual: una base de código autónoma — una aplicación, una biblioteca o un servicio. Hay una única superficie coherente sobre la que razonar, de modo que los planes operan directamente sobre el código del repositorio y la incorporación lee la propia estructura y convenciones del repositorio. El agente mantiene toda la base de código como contexto y trabaja en ella de principio a fin.

Características:

  • Una única base de código coherente.
  • Los planes modifican archivos de este repositorio.
  • El espacio de trabajo .dwp/ vive en la raíz del repositorio.

Centro orquestador

El caso de coordinación: un repositorio cuyo trabajo consiste en gestionar otros repositorios. Aquí la unidad de trabajo no es un archivo sino un repositorio hijo, de modo que los planes pueden generar planes hijos en subrepositorios, y la incorporación lee el registro de repositorios gestionados del centro en lugar de una sola base de código. El agente razona sobre límites y transferencias: qué repositorio es responsable de qué trabajo y cómo se mantiene coherente su estado.

Características:

  • Coordina varios subrepositorios.
  • Los planes pueden delegar en planes hijos.
  • Mantiene un registro de repositorios gestionados.
  • El espacio de trabajo .dwp/ en la raíz del centro rastrea el estado entre repositorios.

Heurística de clasificación

Los dos arquetipos se ven distintos en disco, y el agente decide entre ellos a partir de señales que puede verificar, no de una etiqueta que se le indica. El árbol de decisión siguiente muestra el camino; en resumen, trate un repositorio como centro orquestador solo cuando la evidencia lo exija, y como repositorio individual en caso contrario.

Un agente debería clasificar un repositorio como centro orquestador cuando encuentra varios repositorios git anidados o submódulos, un registro o manifiesto de repositorios gestionados, o configuración que apunta a repositorios externos. En ausencia de esas señales, lo trata como un repositorio individual — el comportamiento seguro por defecto, pues ampliar un plan más allá de límites que no existen es peor que trabajar dentro de uno que sí existe.

Cómo difiere la incorporación

El arquetipo no es una etiqueta cosmética; cambia lo que el agente lee, lo que un plan puede tocar y dónde se registra el estado.

Aspecto Individual Orquestador
Alcance Este repositorio Varios repositorios
Incorporación Estructura del repositorio Registro del centro
Objetivo del plan Archivos locales Planes hijos
Estado .dwp/ local .dwp/ entre repositorios

El efecto práctico es que un agente de repositorio individual razona sobre una base de código de principio a fin, mientras que un agente orquestador razona sobre la coordinación: qué repositorio hijo es responsable de qué trabajo y cómo se mantiene coherente el estado entre repositorios.

Acertar el arquetipo es lo que permite a un agente trabajar de forma autónoma durante horas sin supervisión: acota los planes, la incorporación y el estado al límite correcto, de modo que el agente opera sobre la superficie adecuada desde la primera tarea hasta la última.