- Inicio
- Plantillas
- Funcionalidad full-stack: de los requisitos a la documentación de usuario en una sesión
Funcionalidad full-stack: de los requisitos a la documentación de usuario en una sesión
Última actualización
Feature SDLC ejecuta ocho agentes: requisitos, diseño, backend y frontend, después tus pruebas, y luego escenarios E2E, revisión de seguridad y documentación de usuario sobre el resultado.
Feature SDLC es el flujo de trabajo integrado más largo. Úsalo para una funcionalidad que atraviesa toda la pila y que quieres diseñada, desarrollada y documentada de una sola pasada, con un único cambio que revisar al final.
Qué agentes se ejecutan
| Paso | Agente |
|---|---|
| Requirements | Product Analyst |
| Delivery plan | Project Planner |
| Technical design | Architect |
| Backend | Backend Engineer |
| Frontend | Frontend Engineer |
| E2E tests | E2E Tester |
| Security review | Security Auditor |
| User docs | Technical Writer |
Los cinco primeros pasos se ejecutan antes de que se escriba el código. Después del paso Frontend, la pasada de código escribe el cambio a partir de lo que escribieron, y el comando de pruebas de tu proyecto se ejecuta sobre él en un sandbox. Los tres últimos pasos (E2E tests, Security review y User docs) se ejecutan después, sobre el cambio escrito y su resultado de pruebas. Luego, la revisión con IA registra hallazgos sobre el diff real. El paso Delivery plan también añade sus elementos al tablero Plan.
El paso User docs se ejecuta después de que se escriba el código, así que su borrador es texto en la página de la sesión. La guía acaba en el diff porque la tarea la pide, y la escribe la pasada de código.
Controles antes del pull request
- Pruebas sobre la versión actual. Las pruebas fallidas bloquean. Si alguien edita el cambio después de ejecutarse sus pruebas, el resultado anterior deja de contar y el cambio aparece como no probado.
- Hallazgos. Los hallazgos abiertos de gravedad alta o crítica bloquean hasta que se pasan por triaje. Si la revisión no puede terminar, el cambio queda retenido hasta que vuelvas a ejecutarla.
- Aprobación. Aprueba alguien distinto de la persona que empezó la sesión, siempre que el espacio de trabajo tenga otro aprobador.
Retenla para una persona antes de que empiece
Ocho pasos cuestan más que cuatro. Esta regla de política hace que cada sesión de Feature SDLC espere una aprobación antes de gastar nada:
{
"id": "approve-feature-sdlc",
"action": "workflow.dispatch",
"resource": "feature-sdlc",
"decision": "ask",
"description": "A person approves before an eight-step feature session starts"
}
La sesión espera retenida en Review & Gate → Approvals. Un inicio retenido caduca a los 3 días, y un rechazo lo cancela. Combina la regla con un límite por flujo de trabajo en control de costos.
Mantén el alcance en un solo pull request
La pasada de código escribe como máximo 25 archivos en un cambio y lee una cantidad fija de lo que escribieron los cinco pasos anteriores, así que lo que escribieron los últimos puede quedar fuera de lo que ve. Elige una funcionalidad que quepa en un pull request: un endpoint, una pantalla, una guía. Para un trabajo más grande, especifícalo primero con la plantilla de especificación de funcionalidad y después desarróllalo fase a fase con sesiones de seguimiento, cada una partiendo del cambio sin fusionar de la anterior.
Preguntas frecuentes
¿Los pasos de backend y frontend se ejecutan en paralelo?
No. Los ocho pasos se ejecutan uno tras otro, y cada uno lee lo que escribieron los pasos anteriores.
¿El E2E Tester maneja un navegador?
No. Escribe escenarios de extremo a extremo. El único código que se ejecuta es el comando de pruebas de tu proyecto, en un sandbox sin conexión.
Relacionado
- Agentes de IA que escriben cambios de código sobre tu repositorio real
- Flujos de trabajo
- Aprobaciones y políticas
- Especificación de funcionalidad: requisitos y un plan de entrega por fases
- Decisión de arquitectura: dos diseños, un crítico y un ADR
- Plantilla de postmortem de incidente para un cambio escrito por IA
- Todas las plantillas