Desarrollo guiado por especificaciones
Convierte requisitos en especificaciones, planes, código y registros de cambios trazables.
Ofrece a personas y Coding Agents un contrato compartido antes de empezar la implementación. FiboCode y Fibo Skills transforman una petición inicial en criterios de aceptación explícitos, un diseño vinculado, un plan ordenado, código revisado y un registro de cambios que permanece en el repositorio.
Código rápido no significa código alineado.
Un Coding Agent puede pasar rápidamente de una petición breve a la implementación, pero las suposiciones que faltan suelen aparecer cuando los archivos ya han cambiado. Si el requisito, el límite y la prueba de finalización siguen implícitos, quienes revisan deben reconstruir el comportamiento previsto al mismo tiempo que juzgan el código.
El desarrollo guiado por especificaciones crea una ruta explícita antes de ejecutar. El requisito se convierte en criterios de aceptación comprobables; las decisiones de diseño indican cómo se cumplirán; el plan enumera tareas, archivos y verificaciones en orden. La implementación dispone de un contrato visible y el registro final del diff explica qué cambió realmente.
Observa cómo el flujo permanece conectado con el trabajo real.
Estas demostraciones muestran registros trazables que crecen con el código mientras el Agent CLI permanece en el flujo de terminal existente.
Observa la cadena de documentos que conecta un requisito inicial con decisiones, tareas, pruebas de implementación y comprensión posterior.
Mantén el Agent CLI en el terminal mientras le proporcionas archivos, símbolos, capturas de pantalla y rutas de salida navegables.
Pasa de la intención a las pruebas en cuatro etapas.
Cada etapa tiene un propósito distinto, para resolver las preguntas antes de que se conviertan en decisiones de implementación ocultas.
Aclara el requisito y los criterios de aceptación.
Convierte la petición inicial en resultados explícitos y comprobables y define qué queda fuera del cambio. La persona responsable aprueba el contrato antes de empezar el código de producción.
Diseña el enfoque a partir de los criterios.
Describe cómo cumplirá el sistema cada criterio, incluidos límites, interfaces y decisiones importantes. Los enlaces mantienen cada decisión vinculada al comportamiento al que sirve.
Crea y ejecuta un plan ordenado.
Divide el diseño en tareas acotadas con archivos implicados y métodos de aceptación. El Coding Agent recorre la secuencia con el contexto acordado disponible.
Revisa el código y registra el cambio real.
Inspecciona el diff resultante, verifica los criterios de aceptación y conserva para el futuro una explicación por hunks de qué cambió y por qué.
Un contrato trazable en torno a la ejecución del Agent.
Criterios de aceptación antes de implementar.
Una especificación convierte una intención difusa en resultados observables y da al desarrollador y al Agent una definición compartida de finalización.
Decisiones de diseño vinculadas al comportamiento.
El diseño explica cómo debería funcionar el cambio y mantiene cada decisión importante conectada con el criterio que la exige.
Ejecución acotada y ordenada.
Los planes nombran tareas, archivos implicados y métodos de verificación para que la implementación avance en unidades revisables y no en un salto opaco.
Historial de cambios basado en el diff.
Después de ejecutar, un registro del diff real explica los hunks de implementación y los conecta con la lógica circundante y la intención del proyecto.
Caso de uso: cambiar el comportamiento en varios módulos.
Una petición parece sencilla, pero afecta al enrutamiento, al estado, a la UI y a la validación. Primero se acuerdan resultados observables y exclusiones. El diseño asigna esos resultados a los límites afectados y el plan separa el trabajo en tareas por archivos, cada una con su método de verificación.
El Agent CLI ejecuta entonces con menos decisiones ocultas. Quienes revisan pueden comparar el resultado con los criterios aprobados, inspeccionar los cambios reales y conservar un registro del diff que explique cómo conecta la implementación con el requisito original.
Una capa de flujo, no un sustituto de tu Agent ni de las pruebas.
Fibo Skills guía las etapas de aclaración, especificación, diseño, planificación, ejecución y registro de cambios. El Agent CLI que elijas sigue realizando la programación, y las pruebas y métodos de aceptación reales del proyecto siguen determinando si el resultado es correcto.
El valor reside en la alineación compartida y la trazabilidad. Un flujo centrado en el prompt puede empezar a programar con la intención aún sin resolver; la ruta guiada por especificaciones hace revisable esa intención antes del cambio y mantiene disponibles sus pruebas después.
Preguntas sobre el desarrollo guiado por especificaciones
¿Necesito una especificación para cada pequeña edición?
Utiliza el flujo cuando el comportamiento, los límites o la aceptación requieran alineación. Un cambio mecánico pequeño puede no necesitar la misma profundidad que una funcionalidad que abarca varios módulos.
¿Qué son Fibo Skills?
Fibo Skills son instrucciones de flujo utilizadas con entornos Agent CLI compatibles para guiar la aclaración, especificación, diseño, planificación, ejecución y registro de cambios.
¿Puede el Agent empezar a programar antes de la aprobación?
El flujo previsto pide que la persona responsable apruebe primero la especificación, para que el código de producción se base en un contrato de comportamiento explícito y no en suposiciones sin resolver.
¿Cómo se mantiene la trazabilidad del diseño y el plan?
Las decisiones de diseño enlazan con los criterios de aceptación, mientras las tareas del plan nombran los criterios, archivos y métodos de aceptación implicados.
¿Qué ocurre después de implementar?
El resultado se revisa frente a la especificación y el diff real. Después, un registro de cambios puede explicar los hunks de implementación y conservar por qué existen.