description: Cuadrillas de personas, de agentes y mixtas en SCAFFOLD 0.1: roles, qué decide cada una, asignación, supervisión, presupuestos, identidad y traspasos.¶
Cuadrillas de personas y de agentes¶
Esta página explica cómo se organiza quién hace qué cuando un proyecto trabaja con personas y asistentes de IA. Es una explicación; la norma está en los requisitos y esta página no añade obligaciones. Los nombres y el proyecto son ficticios.
En breve¶
- Una cuadrilla es un grupo con una persona responsable: de personas, de agentes o mixta (R-030).
- Un agente no ocupa ningún rol; las responsabilidades siempre tienen una persona.
- Una cuadrilla formada sólo por agentes puede proponer y ejecutar dentro de su alcance; no acepta trabajo, no ordena la lista, no aprueba su propio resultado ni autoriza un despliegue.
- Cada elemento en curso tiene una persona responsable aunque lo ejecute un agente (R-031).
- Un proyecto de una persona con un asistente aplica estas ideas sin necesidad de formar una cuadrilla (ver «Una persona con un asistente»).
Estado: SCAFFOLD 0.1 es una edición aceptada. Qué tan bien funciona cada arreglo de cuadrillas en la práctica no está medido aquí (Hypothesis).
Roles¶
Los roles son responsabilidades, no puestos. Una misma persona puede ocupar varios; en un proyecto de una persona, los ocupa todos. Los define la sección «Roles que nombran las fichas» de los requisitos.
| Rol | Responde de |
|---|---|
| Responsable de producto | Objetivo, carta de proyecto, orden de la lista de trabajo y aceptación de lo terminado |
| Responsable de coordinación | Zonas, cadencia, cuadrillas, asignación y revisión periódica |
| Responsable técnico | Arquitectura, contratos, modelo de ramas, dependencias y levantamiento técnico |
| Responsable de entrega | Entornos, promoción de artefactos, despliegue, reversión y versiones |
| Responsable de lote | Un lote concreto: zonas, asistentes, traspasos y resultado |
| Responsable de cuadrilla | Una cuadrilla y la supervisión de sus agentes |
Tres formas de cuadrilla¶
| Forma | Quién la integra | Ejemplo ficticio (tienda en línea de Ana) |
|---|---|---|
| Humana | Sólo personas | Beto y Carla mantienen la interfaz de la tienda en src/web/ |
| De agentes | Sólo agentes, con una persona responsable de cuadrilla | Un asistente de código escribe en src/export/ y uno de pruebas en tests/, cada uno en su zona; Ana responde de la cuadrilla |
| Mixta | Personas y agentes | Beto revisa y los asistentes producen cambios en src/pedidos/ |
La ficha de cada cuadrilla declara su responsable, integrantes, zonas de escritura y tipos de trabajo que acepta; la de cada agente, su perfil con alcance, presupuesto y supervisor (formato en las plantillas). Las zonas de una cuadrilla siguen la regla de R-001: una ruta no tiene más de un dueño de escritura.
Qué puede y qué no puede una cuadrilla de agentes¶
La tabla resume las decisiones que los requisitos asignan. «Decide» indica quién registra la decisión; el agente puede aportar propuestas o ejecución dentro de su alcance.
| Acción | ¿Puede una cuadrilla de sólo agentes? | Quién decide | Requisito |
|---|---|---|---|
| Proponer elementos, criterios u orden | Sí | Persona con rol de producto, que registra la decisión | R-022 |
| Ejecutar un lote asignado | Sí, dentro de sus zonas, alcance y presupuesto | Responsable de coordinación asigna (R-031); el agente ejecuta | R-009, R-030 |
| Aceptar trabajo para la cuadrilla | No | Responsable de coordinación asigna | R-030, R-031 |
| Abrir una solicitud de integración | Sí, citando elemento o lote y declarando los asistentes que intervinieron | Responsable de lote responde de ella | R-025 |
| Escribir en la rama principal | No, salvo mediante una solicitud de integración revisada por una persona | Persona que revisa la solicitud; integrar lo catalogado como crítico lo decide una persona | R-026, R-010 |
| Aceptar un elemento como terminado | No | Persona con rol de producto | R-022, R-023 |
| Ordenar o descartar la lista de trabajo | No | Persona con rol de producto | R-022 |
| Aprobar su propio resultado | No | Una persona con rol para ello; la cuadrilla de agentes no | R-030 |
| Desplegar a producción | No por sí misma | Responsable de entrega, con confirmación informada | R-027, ASILO-R-005 |
La columna «¿Puede una cuadrilla de sólo agentes?» refleja la restricción que R-030 fija únicamente a las cuadrillas formadas sólo por agentes. En una cuadrilla mixta deciden sus personas, no sus agentes. Las acciones que otros requisitos reservan a una persona (por ejemplo ordenar, aceptar o descartar en R-022, o desplegar en producción) siguen requiriéndola. Que una persona aparezca en la cuadrilla no basta; la decisión queda registrada con su nombre (riesgo residual de R-022: una persona puede aceptar sin revisar).
Asignación y capacidad¶
R-031 pide que cada elemento en curso tenga una persona responsable. La planificación distingue dos capacidades que no se suman:
- Personas: tiempo disponible.
- Agentes: limitada por presupuesto y por la revisión humana que requieren sus resultados.
Ejemplo ficticio (las cifras son inventadas): un asistente puede producir cinco cambios en una tarde, pero Beto sólo puede revisar dos con cuidado. La capacidad útil de esa cuadrilla mixta depende de la revisión, y el proyecto registra esa estimación como estimación, separada del dato medido. Riesgo residual: la revisión humana puede volverse el cuello de botella sin que se mida; por eso conviene medir el tiempo que esperan los cambios por revisión (opción de indicador para R-032). Un límite de trabajo en curso por cuadrilla (R-024) es otra forma de hacerlo visible. La planificación y el ciclo de vida tratan esas decisiones con más detalle.
Supervisión¶
Cada agente de una cuadrilla tiene una persona que lo supervisa (R-030). R-030 no define el verbo «supervisar». Una lectura editorial posible, no normativa: la persona conoce el perfil y el presupuesto del agente y revisa sus resultados antes de integrarlos. Riesgo residual (R-030): la supervisión declarada puede no ejercerse; la evidencia es el historial de revisiones de las solicitudes de integración, no la declaración.
Presupuestos¶
ASILO-R-007 pide límites de costo, acciones y tiempo por ejecución automatizada. El perfil de cada agente cita su presupuesto; un lote no lo sustituye (R-009). El costo se registra como dato o como «desconocido», nunca como estimación disfrazada. Qué ocurre cuando un presupuesto se agota (por ejemplo, que la persona supervisora decida si lo amplía o cierra el lote) es una decisión que el proyecto declara; los requisitos no la fijan.
Identidad y alcance¶
ASILO-R-004 conserva la identidad y el alcance de cada agente que actúa con herramientas o datos. Para una cuadrilla, esto se traduce en que cada agente tiene una identidad propia en los registros (no una cuenta compartida) y que su alcance no es más amplio que el de quien lo invoca. Así los trailers de atribución de los cambios (véase ramas y versiones) distinguen a cada asistente. Cambiar de herramienta no concede permisos ni continuidad (R-005).
Traspasos¶
Dentro de un lote, cambiar de asistente exige una nota de traspaso con estado (R-005). Entre agentes de una misma cuadrilla, la nota nombra emisor y receptor; quien recibe la toma, y una nota tomada no se edita: si el objetivo cambia, se cancela con motivo y se abre otra. Entre personas, o de una persona a un agente y de vuelta, un proyecto puede usar la misma nota: la persona puede completarla con lo que sabe y no estaba escrito. R-005 se refiere al cambio de asistente; su uso entre personas es una opción editorial. El formato abierto está en los requisitos.
Una persona con un asistente¶
En un proyecto de una persona, Ana ocupa todos los roles. R-030 aplica cuando el proyecto trabaja con cuadrillas: un solo asistente no obliga a una ficha de cuadrilla, pero conserva su identidad y alcance (ASILO-R-004). Si Ana decide formar una cuadrilla, ella es la responsable. Lo que se conserva:
- Ana decide el orden, acepta lo terminado y autoriza los despliegues a producción; el asistente no.
- El asistente tiene identidad y alcance propios; con ficha de cuadrilla, también perfil con presupuesto y supervisor (Ana).
- Cada elemento en curso tiene a Ana como responsable aunque lo ejecute el asistente.
- Los cambios llevan atribución a Ana y al asistente.
Lo que se simplifica: no hay más personas con quien repartir roles, y la revisión humana de la solicitud de integración es una autorrevisión de Ana. Eso reduce la separación entre quien produce y quien revisa; conviene registrar ese riesgo aceptado, por ejemplo en la carta de proyecto, en lugar de presentarlo como control equivalente (Hypothesis sobre su suficiencia).
Hypothesis y qué las promovería¶
| Afirmación | Estado | Verificación que la promovería |
|---|---|---|
| La revisión humana es el cuello de botella típico de una cuadrilla mixta | Hypothesis | Medir tiempo de espera de revisión en proyectos reales, con fechas |
| La autorrevisión de una persona con un asistente es suficiente para su contexto | Hypothesis | Revisión de incidentes y reversiones del proyecto con la regla de R-032 |
| Una identidad por agente distingue la autoría en los registros del servicio | Hypothesis (depende del servicio) | Comprobar en un repositorio de prueba cómo muestra el servicio concreto cada identidad |
Siguiente lectura: ramas, entornos y versiones, plantillas y la página de SCAFFOLD.