description: SCAFFOLD gestiona proyectos de software construidos por personas y asistentes de IA, del planteamiento a la entrega: trabajo, ramas, entornos, versiones y cuadrillas.¶
SCAFFOLD — Proyectos de software con personas y asistentes de IA¶
SCAFFOLD es una metodología aprobada para gestionar proyectos de software que construyen personas y asistentes de inteligencia artificial (IA): una persona con un asistente, un equipo con varios asistentes o varias cuadrillas de personas y de agentes. Cubre el proyecto completo, desde el planteamiento —desde cero o desde el punto en que esté— hasta la entrega y el aprendizaje: carta de proyecto, trabajo planificado, cadencia, cuadrillas, zonas de escritura, lotes y traspasos, ramas, entornos, despliegue y versiones.
Responde a preguntas prácticas: qué se construye y quién lo decide, quién hace cada tarea, quién cambia cada ruta, cómo se vincula una tarea con sus cambios y su versión, cómo llega algo a producción y cómo se vuelve atrás, y qué se aprendió.
Edición aceptada: SCAFFOLD 0.2 — 16-oct-2026. La decisión de aceptación identifica 36 requisitos: los 31 de 0.1, conservados por referencia, y R-033 a R-037. R-017 sigue pendiente fuera de ambas ediciones. ASILO 0.1 y MILPA 0.1 conservan sus propios textos y autoridad.
SCAFFOLD 0.2 no añade principios propios. Cada requisito declara su base; las fichas nuevas formalizan impacto, ejecución e infraestructura, migraciones, estructura y conexiones remotas. El español es normativo y las traducciones son informativas.
La analogía del andamio¶
Un andamio sostiene a quien construye mientras la obra avanza y se retira cuando termina. Marca por dónde se sube, qué tramo trabaja cada cuadrilla y dónde se deja el material para el turno siguiente. El edificio terminado no depende del andamio.
Antes de levantar el andamio hay un encargo de obra y, si el edificio ya existe, un levantamiento de lo construido. En software, la carta de proyecto es el encargo; el levantamiento registra lo que ya hay; las cuadrillas son los equipos de personas y de agentes; las zonas de escritura dicen qué tramo trabaja cada una; la nota de traspaso deja el material para el turno siguiente; el lote dice qué obra se está haciendo y cuándo terminó; la entrega a producción es la recepción de obra, que autoriza una persona. Según SCAFFOLD-R-011, nada de eso viaja al sistema que se despliega. La analogía explica; no demuestra que un control funcione.
Alcance y límites¶
- ASILO delimita datos, permisos y efectos. Cuando un asistente actúa como agente con acceso a herramientas o datos, se conservan identidad y alcance de ASILO-R-004. SCAFFOLD organiza la construcción con uno o varios asistentes de IA; cada control conserva su condición. Usar IA sin construir software queda fuera del alcance de SCAFFOLD.
- No sustituye la revisión humana de efectos críticos de ASILO-R-005 ni la separación de hechos e hipótesis de MILPA-R-002; las usa.
- No sustituye a Scrum, Kanban ni a un gestor de tareas: define qué registrar y quién decide; cada equipo elige cadencia y herramienta (trabajo y cadencia).
- No promete menos consumo, menos errores ni ausencia de colisiones. Ordena y hace visible; lo que se afirme sobre ahorro o estabilidad exige medición.
Cómo se relaciona con los otros métodos¶
| Método | Pregunta | Qué toma SCAFFOLD de él |
|---|---|---|
| MILPA | ¿Qué sabemos, de dónde viene y quién responde? | Manifiesto del proyecto, zonas restringidas, vínculos con contrato y versión, hechos separados de hipótesis. |
| ASILO | ¿Qué puede hacer un sistema con IA y cómo se comprueba? | Alcance de cada agente, presupuesto de contexto por tarea, datos y secretos, revisión de efectos críticos. |
| SCAFFOLD | ¿Cómo se planifica, construye y entrega software con personas y asistentes? | Añade carta y levantamiento, trabajo planificado y cadencia, cuadrillas, zonas de escritura, traspasos, lotes, ramas, entornos, versiones, exclusión del despliegue y proyectos compuestos. |
Gestionar cambios por jurisdicción¶
Incorporar o actualizar una localización se gestiona como trabajo del proyecto: alcance, elemento de trabajo, contratos afectados, criterios de aceptación, comprobaciones e integración. El cambio conserva trazabilidad hasta la versión entregada y el plan de reversión pertinente. Son ejemplos de aplicación de R-006, R-010, R-021, R-023 y R-025, con sus condiciones; no añaden requisitos ni principios a SCAFFOLD 0.1.
La guía jurisdiccional común conserva una sola matriz y un ejemplo para los tres métodos. Entrega de cambios regionales explica versiones, pruebas y artefactos. La aceptación del trabajo no sustituye aceptación metodológica del perfil, revisión jurídica ni autorización de una operación.
Piezas del método¶
| Pieza | Qué es | Comprobación posible |
|---|---|---|
| Carta de proyecto | Objetivo, alcance, responsables, efectos críticos y criterio de éxito, con versión. | Que exista antes del primer lote de función y que sus cambios tengan decisión registrada. |
| Elemento de trabajo | Trabajo planificado con identificador, criterios de aceptación, responsable y estado. | Que cada lote de función o corrección cite uno y que nada se termine sin aceptación humana. |
| Cuadrilla | Equipo de personas, de agentes o mixto, con responsable humano, zonas y perfiles. | Que cada agente tenga alcance, presupuesto y supervisor. |
| Zona de escritura | Rutas que un asistente cambia; rutas compartidas con regla de turno; rutas restringidas que ninguno cambia. | Cambios fuera de zona marcados antes de confirmar. |
| Nota de traspaso | Objetivo, referencias, límites vigentes, resultados, hechos e hipótesis, decisiones y siguiente acción; con estado. | Quién la tomó, si cambió después de tomarse, si caducó, de qué otra depende. |
| Lote de trabajo | Una función, una corrección, una reestructuración o una investigación, con responsable, zonas, asistentes, intervalo y resultado. | Un lote no se cierra antes que aquel del que depende ni con notas pendientes. |
| Contexto de arranque | Lista corta de artefactos vigentes que un asistente lee primero. | Que lo citado exista y esté vigente. |
| Rama y solicitud de integración | Rama de vida corta por lote; solicitud que cita el trabajo y sus comprobaciones. | Que la rama principal esté protegida y que la trazabilidad trabajo–cambio–versión funcione en ambos sentidos. |
| Entorno y versión | Entornos declarados; mismo artefacto promovido por huella; versión con etiqueta y notas. | Registro de despliegue con autorización y plan de reversión. |
| Raíz compuesta | Carpeta que coordina varios repositorios por sus manifiestos y contratos. | Que desde la raíz se lean manifiestos, contratos, mapas y notas, no código, y que una herencia declarada no se presente como efectiva. |
stateDiagram-v2
accTitle: SCAFFOLD: estados de notas y lotes
accDescr: Dos máquinas de estados: una nota de traspaso empieza abierta, pasa a tomada cuando la toma quien recibe y a cerrada al terminar el trabajo, queda bloqueada mientras espera otra nota y vuelve a abierta cuando esa se cierra, y se cancela con motivo desde abierta o tomada, o al devolverse. Un lote de trabajo empieza abierto y termina cerrado, con resultado escrito y nada pendiente, o descartado con motivo.
direction LR
state "Nota de traspaso" as nota {
[*] --> abierta
abierta --> tomada: la toma quien recibe
abierta --> bloqueada_por: espera otra nota
bloqueada_por --> abierta: la otra se cerró
tomada --> cerrada: trabajo terminado
abierta --> cancelada: con motivo
tomada --> cancelada: con motivo o devuelta
}
state "Lote de trabajo" as lote {
[*] --> abierto
abierto --> cerrado: resultado escrito y nada pendiente
abierto --> descartado: con motivo
}Diagrama SVG (gráfico vectorial escalable): SCAFFOLD: estados de notas y lotes · Fuente editable Mermaid.
En SCAFFOLD 0.1, la nota nace abierta y la toma sólo quien la recibe. Una nota tomada no se edita: si el objetivo cambia, se cancela con motivo y se abre otra. Quien recibe puede devolverla a quien la emitió con el motivo, y las dos quedan enlazadas. Un lote termina cerrado, con un resultado escrito, o descartado, con un motivo. Cerrar no aprueba ni acepta el contenido: registra que el trabajo terminó.
Un ejemplo pequeño¶
Un equipo ficticio trabaja con dos asistentes sobre una tienda en línea. El primero escribe en
src/; el segundo, en tests/. El archivo README.md es compartido y la carpeta de políticas está
restringida. Se abre un lote de tipo función: «exportar pedidos a CSV» (valores separados por comas), con responsable Ana. El
primer asistente termina el código y deja una nota de traspaso al segundo con lo que cambió y lo
que no comprobó. El segundo la toma, escribe las pruebas, la cierra y Ana cierra el lote con el
resultado. Si el segundo hubiera descubierto que el contrato de pedidos no admite el campo nuevo,
habría devuelto la nota en lugar de forzar el cambio.
El ciclo del proyecto¶
| Momento | Qué se decide | Página |
|---|---|---|
| Arrancar | Objetivo, alcance, responsables; levantamiento si ya hay trabajo. | Ciclo del proyecto |
| Planificar | Qué trabajo, en qué orden, cuándo está listo y cuándo terminado. | Trabajo y cadencia |
| Organizar | Qué cuadrilla hace qué y con qué capacidad. | Cuadrillas |
| Construir | Zonas, lotes y traspasos. | Esta página y los requisitos |
| Integrar y entregar | Ramas, solicitudes de integración, entornos, despliegue y versiones. | Ramas, entornos y versiones |
| Operar y aprender | Indicadores, incidentes y mejora. | Ciclo del proyecto |
Las plantillas muestran cada formato con un ejemplo ficticio.
Aplicar por etapas¶
| Etapa | Salida revisable |
|---|---|
| Escribir la carta o el levantamiento | Carta de proyecto con versión; levantamiento si el proyecto ya existe. |
| Registrar el trabajo | Lista de trabajo con elementos, definición de terminado y cadencia. |
| Declarar zonas | Archivo de zonas con dueño por ruta, compartidas y restringidas. |
| Pasar trabajo con notas | Notas con estado y enlace al lote. |
| Registrar lotes | Un lote por unidad de trabajo, con resultado y costo o «desconocido». |
| Mantener la sincronía | Contrato, mapa de arquitectura y código con versión y comprobación. |
| Ordenar ramas y entregas | Modelo de ramas, entornos declarados, registro de despliegue y versiones. |
| Separar lo que se despliega | Lista de exclusión comprobada sobre el artefacto construido. |
| Coordinar varios repositorios | Declaración de la raíz y lectura por manifiesto. |
Las etapas no son niveles de madurez ni orden obligatorio. Cada equipo adopta lo que necesita (adoptar por partes).
Siguiente lectura: ciclo del proyecto, requisitos de la edición 0.1 y vocabulario.
Una persona con un asistente también aplica SCAFFOLD¶
Una persona encarga a un asistente de IA corregir una función. Declara las rutas permitidas, abre un lote de corrección, prepara el contexto de esa tarea y registra el resultado y las comprobaciones antes de integrarlo. Ocupa todos los roles: su carta cabe en un párrafo y su lista de trabajo en un archivo. No necesita crear otros agentes para aplicar el método. Una nota de traspaso se exige al cambiar de asistente dentro del lote; la coordinación entre dueños y las dependencias entre lotes aplican cuando esas situaciones existen.
ASILO delimita datos, permisos y efectos según sus requisitos; MILPA conserva procedencia y autoridad. SCAFFOLD organiza cómo se construye. Consulta el alcance de IA.
Ingeniería y evidencia de artefactos¶
Perfil de ingeniería propuesto y guía de verificación de artefactos: aplicación agnóstica, criterios, evidencia y límites; sin nuevas obligaciones universales.