Coordinación de paquetes de trabajo
Cómo las unidades de trabajo planificadas pasan del plan de arquitectura a una implementación integrada, sin que los agentes se pisen entre sí.
El contrato
Un paquete de trabajo es una unidad de ejecución creada por el planificador de arquitectura: define qué hacer. La skill asignada define cómo se ejecuta esa clase de trabajo. Esta separación es lo que permite que varios agentes trabajen a la vez.
- 01
Planificar
El planificador de arquitectura emite un archivo Markdown por paquete más un índice.
- 02
Verificar dependencias
Confirmar que los prerrequisitos están completos y que los archivos propios no están reclamados por otro paquete.
- 03
Asignar skill y agente
Emparejar el paquete con la skill de esa clase de trabajo y registrar el agente o sesión.
- 04
Implementar
Trabajar solo dentro de los archivos que el paquete posee.
- 05
Validar
Ejecutar las comprobaciones del paquete contra sus criterios de aceptación.
- 06
Actualizar registros
Sincronizar el archivo del paquete y el índice con estado y notas.
- 07
Integrar dependientes
Desbloquear los paquetes que declaraban este como dependencia.
Vuelta atrás
¿Criterios de aceptación sin cumplir? Se registran los bloqueos o el trabajo pendiente y se retoma la implementación. Ningún paquete se completa antes de tiempo.
Qué declara cada paquete
Dependencias
Qué paquetes deben completarse primero. Un paquete solo es elegible cuando sus dependencias están hechas.
Propiedad de archivos
Los archivos exactos que el paquete puede cambiar. La propiedad exclusiva es lo que hace seguro el trabajo en paralelo.
Contratos de integración
Las interfaces de las que dependen otros paquetes: props, exports, rutas y expectativas de markup.
Criterios de aceptación
Las comprobaciones que deben pasar antes de que el paquete pueda marcarse como Completed.
Skill y agente asignados
Qué skill ejecuta el trabajo y qué agente o sesión lo posee.
Estado
Sincronizado entre el archivo del paquete y el índice, para que la coordinación siga siendo precisa.
Estados
- PlannedDefinido e indexado, aún sin asignar ni empezar.
- In progressAsignado a una skill y un agente, con la implementación en curso.
- BlockedNo puede avanzar; el bloqueo queda registrado en el paquete y el índice.
- CompletedCriterios de aceptación cumplidos y comprobaciones requeridas superadas. Nada menos cuenta.
- Needs reviewImplementación terminada, pendiente de verificación contra el contrato.
Del plan a la ejecución
La skill3.2-work-package-orchestrator, invocada conprompts/3.2-work-package-orchestrator.md, convierte el índice de paquetes, el grafo de dependencias y la matriz de conflictos en un runbook de ejecución: olas de paquetes, prerrequisitos exactos, checkpoints de integración y un prompt por lote listo para pegar. Solo planifica por defecto: no implementa ni cambia estados salvo que se le pida explícitamente.
Cómo luce un paquete
Ejemplo ilustrativo, no es un paquete real
- Paquete
- WP-XX-short-name
- Skill asignada
- 5-astro-react-component-builder
- Archivos que posee
- src/components/shared/Example.astro
- Depende de
- WP-shell-package
- Estado
- Planned