Su cometido
Crear un plan de implementación que respete el repositorio que ya tienes delante.
Planifica la arquitectura, la estructura del repositorio, las entregas incrementales, la infraestructura, las pruebas y la preparación para el despliegue.
El agente técnico registra arquitectura, responsables, flujos de datos, alternativas, pruebas, observabilidad, migraciones, despliegue y reversión. Prefiere bloques verticales y convenciones existentes a una arquitectura diseñada de forma aislada.
Información que necesitas aportar
Aporta el repositorio, los límites actuales, las restricciones y un hito verificable.
El agente necesita suficiente contexto técnico para distinguir una verdadera limitación de una preferencia y una migración necesaria de la infraestructura especulativa.
- 01
Se está planificando el producto, el repositorio, el servicio o el límite técnico.
- 02
Lenguajes, frameworks, almacenes de datos, infraestructura y convenciones del repositorio.
- 03
Límites actuales, flujos de datos, responsables, deuda conocida y registros de decisiones pertinentes.
- 04
Entrega, fiabilidad, seguridad, migración, presupuesto, compatibilidad y limitaciones operativas.
- 05
El resultado técnico verificable de forma independiente y el lanzamiento objetivo.
Lo que recibes
Decisiones de arquitectura vinculadas directamente a una ruta de entrega que empiece por las pruebas.
Los registros de decisiones, los bloques de entrega y el manual de lanzamiento se mantienen conectados para que la implementación, la verificación, el despliegue y la reversión sean coherentes.
- 01
Registros de arquitectura y decisiones
tech/architecture.mdCriterio de aceptación
Se registran los límites, la titularidad de los datos, las ventajas e inconvenientes y las opciones descartadas.
- 02
Plan de entrega con pruebas primero
tech/delivery-plan.jsonCriterio de aceptación
Las entregas, las dependencias, las pruebas, los responsables y los criterios de aceptación son explícitos.
- 03
Guía operativa de publicación y reversión
tech/release-runbook.mdCriterio de aceptación
Una compilación puede observarse, verificarse, desplegarse y revertirse de forma segura.
El método
Inspeccionar primero, decidir de forma visible y entregar en bloques reversibles.
El plan se basa en el espacio de trabajo vinculado al código fuente y convierte cada efecto relevante sobre el host en una solicitud explícita.
- 1
Inspeccionar
Leer las convenciones del repositorio, los límites, los responsables de los datos, el comportamiento del despliegue y las restricciones conocidas.
- 2
Decidir
Registrar alternativas, ventajas e inconvenientes, responsables, interfaces y opciones rechazadas.
- 3
Dividir
Crear entregas verticales que empiecen por las pruebas, con migraciones, observabilidad y pruebas de aceptación.
- 4
Lanzamiento
Definir solicitudes de compilación, secretos, despliegue, verificación, recuperación y reversión, con sus aprobaciones.
Indicadores y límites de seguridad
Una arquitectura elegante es un fracaso si supera el producto validado.
Los scripts ocultos, los datos sin responsable, la falta de pruebas de reversión, el acceso amplio a secretos o el despliegue antes de la revisión de seguridad detienen el plan de entrega.
Indicadores de utilidad
- Tiempo hasta una versión verificada
- Tasa de fallos de cambios
- Fiabilidad del flujo de trabajo principal
Motivos para detenerse
- La arquitectura supera las necesidades de productos validados
- El despliegue continúa sin cumplir los requisitos de seguridad y reversión
Límite de aprobación
Modificación del repositorio · Despliegue · Acceso a secretos
Anexo técnico
El contrato técnico que define este agente.
Para quienes necesitan revisar la versión inmutable del Kit, sus entradas y salidas tipadas y los controles de verificación.
- Kit
- company-suite@0.1.0
- Punto de entrada
- plan-tech
- Función
- plan-tech
- Entorno de ejecución
- python@3.12
- Entrada
- specialist-brief.schema.json
- Salida
- specialist-plan.schema.json
Verificación
specialist-plan-quality · tech-readiness
Sistemas conectados
Adios Git · Adios Workspace · Adios Deployments · Adios Secrets