SCAFFOLD — Ciclo del proyecto¶

En breve. Esta página recorre un proyecto de software de principio a fin en siete momentos: arrancar, planificar, organizar personas y agentes, construir, integrar, entregar, y operar y aprender. Para cada momento indica qué se hace, qué queda como salida revisable, qué requisitos de SCAFFOLD 0.1 aplican y quién decide. También explica por dónde entrar si el proyecto no empieza de cero. La página explica; la norma está en los requisitos.

Nivel de certeza (MILPA): lo que describe cada requisito es norma aceptada; el orden de los momentos, los ejemplos y la analogía son presentación editorial. No hay evidencia medida de que este recorrido reduzca errores o plazos (hipótesis, sin fuente).

Para quién es y primer paso¶

Para quien coordina un proyecto de software en el que trabajan personas, asistentes de IA o ambos (ver alcance de IA). Primer paso: decidir desde dónde se entra (sección «Desde dónde empezar») y leer el momento que corresponde. Los términos de lote, nota de traspaso y zona de escritura están en la presentación de SCAFFOLD y en el vocabulario.

La analogía de la obra¶

SCAFFOLD ya se explica con un andamio. Este ciclo extiende esa imagen a toda la obra; es una correspondencia editorial.

Imagen de la obra	Correspondencia editorial	Práctica observable
Encargo de obra: qué se construye, para quién, quién responde.	Carta de proyecto.	Documento con objetivo, alcance, responsables y criterio de éxito.
Levantamiento de lo construido: medir lo que ya existe antes de intervenir.	Levantamiento del proyecto existente.	Inventario fechado, con cada dato marcado como hecho con fuente o como hipótesis.
Cuadrillas, cada una con un jefe de cuadrilla.	Cuadrillas de personas, de agentes o mixtas, con persona responsable.	Ficha de cuadrilla con integrantes, zonas y supervisor de cada agente.
Tramo de andamio asignado a cada cuadrilla.	Zona de escritura.	Mapa de rutas con dueño.
Recepción de obra: quien encargó comprueba y acepta lo construido.	Aceptación de lo terminado y autorización de la entrega.	Registro de la persona que aceptó y de las comprobaciones hechas.
Retirada del andamio antes de entregar el edificio.	Exclusión de la capa de ingeniería del artefacto desplegado.	Comprobación sobre el artefacto construido (R-011).

Límite (DOC-AX-005). Una obra civil tiene permisos, normas de seguridad y responsabilidades legales que esta analogía no describe ni sustituye. Una cuadrilla de agentes no es una cuadrilla de obreros: un agente no ocupa ningún rol de responsabilidad y la persona responsable sigue respondiendo (R-030). La imagen no demuestra que un control funcione, que haya ahorro de tiempo o que el proyecto sea seguro; esos resultados necesitan medición propia.

Diagrama¶

flowchart LR
  accTitle: Ciclo del proyecto en SCAFFOLD
  accDescr: Siete momentos en secuencia, de arrancar a operar y aprender. Tres flechas discontinuas devuelven el trabajo: del integrar al construir, de operar y aprender a planificar y de operar y aprender a la carta.
  M1["1 Arrancar: carta o levantamiento"] --> M2["2 Planificar: lista de trabajo"]
  M2 --> M3["3 Organizar: cuadrillas y asignación"]
  M3 --> M4["4 Construir: lotes y traspasos"]
  M4 --> M5["5 Integrar: ramas y solicitudes"]
  M5 --> M6["6 Entregar: entornos y versiones"]
  M6 --> M7["7 Operar y aprender: medición e incidentes"]
  M5 -.->|"comprobación fallida o cambio pedido"| M4
  M7 -.->|"acciones como elementos de trabajo"| M2
  M7 -.->|"cambio de objetivo o alcance"| M1

Fuente editable Mermaid.

Cómo leerlo. Cada recuadro es un momento. Una flecha continua indica secuencia habitual: lo que sale de un momento es la entrada del siguiente. Una flecha discontinua indica retorno: el trabajo vuelve a un momento anterior por la causa escrita en la flecha. Los momentos pueden solaparse y repetirse: mientras un elemento se entrega, otro se construye. El diagrama no impone un orden obligatorio ni representa un control implementado. No hay leyenda de color: la información está en el texto de recuadros y flechas.

Los siete momentos¶

1. Arrancar¶

Qué se hace. Se acuerda por escrito qué se construye y quién responde. Desde cero, se redacta la carta de proyecto. Sobre trabajo existente, se hace primero el levantamiento. Se declara el contexto de arranque que leerán los asistentes y, si hay varios repositorios, la raíz que los coordina.
Salida revisable. Carta de proyecto con versión y fecha, o levantamiento fechado con hechos e hipótesis separados; catálogo de efectos críticos; contexto de arranque con referencias que existen.
Requisitos. R-019 carta, R-020 levantamiento, R-004 contexto de arranque, R-014 y R-015 proyectos compuestos.
Quién decide. El responsable de producto decide la carta y sus cambios; el responsable técnico responde del levantamiento.

2. Planificar¶

Qué se hace. El trabajo se registra como elementos de trabajo en una lista ordenada, con criterios de aceptación. Se declaran la condición de listo, la definición de terminado y la cadencia. Los detalles están en Trabajo y cadencia.
Salida revisable. Lista de trabajo con elementos completos; definiciones con versión; cadencia declarada.
Requisitos. R-021, R-022, R-023, R-024.
Quién decide. El responsable de producto ordena, acepta y descarta; el responsable de coordinación declara listo, terminado y cadencia. Un asistente puede proponer; no decide.

3. Organizar personas y agentes¶

Qué se hace. Se forman cuadrillas, se declaran las zonas de escritura de cada una y se asigna cada elemento a una persona responsable, aunque lo ejecute un agente. Se distingue la capacidad de las personas de la de los agentes. El detalle de cuadrillas está en Cuadrillas.
Salida revisable. Ficha de cada cuadrilla; mapa de zonas; asignaciones con responsable; capacidad declarada por tipo.
Requisitos. R-030, R-031, R-001, R-003.
Quién decide. El responsable de coordinación.

4. Construir¶

Qué se hace. Cada elemento se ejecuta en uno o más lotes, con zonas y asistentes declarados. Al cambiar de asistente se deja una nota de traspaso. Los contratos y las dependencias de terceros se revisan; un contrato obsoleto no se usa en lotes de tipo función. La exploración, si se habilita, se hace aparte y se descarta o entra en un lote formal.
Salida revisable. Lotes con objetivo, responsable, zonas, intervalo, estado, resultado y costo medido o «desconocido»; notas de traspaso con estado.
Requisitos. R-009, R-002, R-005, R-006, R-007, R-008, R-016, R-018, R-012.
Quién decide. El responsable de lote en su lote; el responsable técnico en contratos y dependencias.

5. Integrar¶

Qué se hace. El cambio llega a la rama principal por una solicitud de integración que cita el elemento o el lote, pasa las comprobaciones declaradas y recibe revisión de una persona. Un asistente no escribe directamente en la rama principal.
Salida revisable. Convención de ramas declarada; ramas y solicitudes con referencia al elemento o lote; resultado de comprobaciones; revisor humano.
Requisitos. R-025, R-026, R-010.
Quién decide. El responsable técnico define el modelo de ramas; una persona revisa e integra cada solicitud.

6. Entregar¶

Qué se hace. El artefacto que pasó las comprobaciones se promueve entre entornos sin reconstruirse; antes de producción existe un plan de reversión; cada versión lleva etiqueta, notas y autorización. Lo que sólo sirve a la ingeniería queda fuera del artefacto. Una vía de urgencia, si existe, se definió de antemano. El detalle está en Entrega.
Salida revisable. Declaración de entornos; registro de despliegue; plan de reversión; etiqueta y nota de versión; comprobación de exclusión sobre el artefacto.
Requisitos. R-027, R-028, R-029, R-011, R-013.
Quién decide. El responsable de entrega. Desplegar en producción se trata como efecto crítico: lo autoriza una persona, no un asistente (ASILO-R-005).

7. Operar y aprender¶

Qué se hace. Se miden los indicadores de entrega declarados. Cada incidente de producción y cada reversión se revisan con hechos, causas probables como hipótesis y acciones. Se hace la revisión periódica del trabajo terminado y la mejora del proceso.
Salida revisable. Indicadores con fuente; revisiones de incidentes; actas de revisión y mejora; elementos de trabajo creados desde las acciones.
Requisitos. R-032, R-024.
Quién decide. El responsable de coordinación, con el responsable de entrega para los incidentes.

Desde dónde empezar¶

El ciclo no obliga a empezar en el primer momento. La entrada depende de lo que ya existe. Las etapas no son niveles de madurez; ver adoptar por partes.

Situación	Primer paso	Qué sigue
Desde cero	Redactar la carta de proyecto (R-019) antes de abrir el primer lote de tipo función.	Lista de trabajo, cuadrillas, primer ciclo.
Desde un repositorio existente	Registrar el levantamiento (R-020): repositorios, entornos, comprobaciones, versiones, dueños, deuda y trabajo en curso.	Carta de proyecto con lo que el levantamiento muestre; elementos de trabajo desde el levantamiento.
A mitad de un proyecto con trabajo en curso	Hacer el levantamiento y convertir cada trabajo en curso en elemento de trabajo, o descartarlo con motivo.	Ordenar la lista, declarar cadencia y definición de terminado; lo ya integrado no se rehace.
Una persona con un asistente (mínimo viable)	Un archivo breve con: carta de proyecto breve (R-019), lista de trabajo mínima (R-021), definición de terminado (R-023), cadencia declarada (R-024), modelo de ramas simple (R-026) y comprobaciones antes de integrar (R-010).	Un lote por tarea con zonas declaradas, y resultado y comprobaciones registrados antes de integrar.

Notas por situación:

Desde cero. La carta fija objetivo, alcance, exclusiones, responsables, catálogo de efectos críticos, restricciones de datos y criterio de éxito observable. Una carta completa puede describir un objetivo equivocado (riesgo residual de R-019).
Repositorio existente. El levantamiento separa lo que se comprobó de lo que se supone. Lo que nadie recuerda no aparece (riesgo residual de R-020): conviene tratarlo como hipótesis hasta verificarlo.
A mitad de proyecto. Es el caso más frecuente. Un elemento ya empezado entra en la lista en su estado real (por ejemplo en_curso) y no se reinicia. Ver los estados en Trabajo y cadencia.
Una persona con un asistente. En un proyecto de una persona, esa persona ocupa todos los roles de las fichas. Un solo asistente no obliga a crear cuadrillas (R-030 aplica cuando el proyecto trabaja con cuadrillas, y el asistente conserva identidad y alcance según ASILO-R-004) ni notas de traspaso: la nota aplica cuando se cambia de asistente dentro de un lote. Todo cabe en un solo archivo. Este mínimo es una lectura editorial de los requisitos; cada requisito conserva su condición de aplicación, y los que aplican a todo proyecto (por ejemplo R-019, R-021, R-023, R-024 y R-026) siguen vigentes. Un recorte que omita un requisito aplicable exige la excepción registrada que describen los campos comunes de requirements.md.

Ejemplo ficticio continuo¶

Ana mantiene una tienda en línea con dos asistentes: uno escribe en src/ y otro en tests/. Para el momento 1 redacta una carta (v1) cuyo criterio de éxito observable es que el equipo administrador descargue los pedidos del mes. En el momento 2 crea la iniciativa «exportaciones» y el elemento TIE-12, «exportar pedidos a CSV». En el 3 asigna TIE-12 a Ana como responsable aunque lo ejecuten los asistentes. En el 4 abre un lote de tipo función que cita TIE-12. En el 5 la rama y la solicitud de integración citan TIE-12 y Ana revisa antes de integrar. En el 6 autoriza el despliegue tras ver las comprobaciones. En el 7 el incidente de un CSV con codificación errónea genera una revisión y un elemento nuevo, TIE-19. Todos los datos son ficticios.

Límites¶

Esta página no añade requisitos ni modifica los aceptados. Cerrar un lote, terminar un elemento o desplegar registra un hecho; no aprueba por sí solo la calidad del resultado.
Los momentos describen un proyecto de software; usar IA sin construir software queda fuera de alcance de SCAFFOLD.
No hay evidencia en esta página de adopción, ahorro, seguridad ni cumplimiento.
Correspondencias y diferencias con otros marcos de trabajo (por ejemplo Scrum) están en Trabajo y cadencia.

Siguiente lectura: Trabajo y cadencia, Cuadrillas, Entrega, Plantillas. Volver a SCAFFOLD.