Descripción
Spec-first Agentic Development introduce un enfoque estructurado para trabajar con agentes de codificación de IA, asegurando que cada cambio sea iniciado por una especificación claramente definida y revisada. Esta metodología tiene como objetivo mejorar la fiabilidad y mantenibilidad del código desarrollado por agentes de IA al integrar supervisión humana y verificaciones automatizadas a lo largo del ciclo de vida del desarrollo.
Leer más
El principio fundamental implica comenzar cada tarea de desarrollo con una especificación escrita almacenada en el repositorio. Esta especificación describe el objetivo, hechos relevantes (incluidas referencias de archivo y línea), pasos a seguir y criterios precisos de 'hecho'. Antes de que se escriba cualquier código, un revisor nuevo examina la especificación contra la base de código existente para verificar su precisión y viabilidad. Una vez aprobada, un agente de IA procede a construir la característica en su propia rama aislada y espacio de trabajo. La confirmación final solo se permite en el repositorio principal después de que todas las verificaciones y pruebas predefinidas pasen, asegurando la calidad del código y la adherencia a la especificación.
Este sistema difiere significativamente de la codificación tradicional 'vibe' al reemplazar los prompts ad-hoc con una especificación revisada y persistente. Registra cada decisión tomada por el agente con su razonamiento, proporcionando una clara pista de auditoría y reduciendo la necesidad de documentación posterior al desarrollo. Las especificaciones están diseñadas para definir la intención y la arquitectura en lugar de ser generadores de código excesivamente precisos, con pruebas y puertas de confirmación que suministran la precisión necesaria. Las especificaciones antiguas se tratan como registros de cambios inmutables, similares a las confirmaciones, y no se actualizan, previniendo la obsolescencia.
Spec-first Agentic Development admite el desarrollo paralelo, permitiendo que múltiples agentes trabajen en diferentes especificaciones simultáneamente utilizando identificadores únicos de rama y espacio de trabajo. El proceso es ininterrumpido, ya que las especificaciones revisadas responden previamente a preguntas abiertas, permitiendo a los agentes construir directamente según los criterios de 'hecho'. Todo el flujo de trabajo está estructurado, con una especificación correspondiente a una rama y una confirmación, simplificando las solicitudes de extracción y asegurando consistencia. El estado se mantiene en `context.yaml`, haciendo que el trabajo sea reanudable incluso después de reinicios.
El método, las plantillas y el plugin Claude Code están todos licenciados bajo MIT, lo que lo convierte en una solución sin costo. Mientras que el plugin Claude Code automatiza la contabilidad y las funciones de puerta, la metodología también puede ser adoptada con otros agentes como Codex, Cursor o Copilot siguiendo `AGENTS.md` e instalando un gancho de commit-msg de git para la puerta. Este enfoque fue desarrollado y refinado a través de la creación de Agent Smith, una fábrica de software agencial de código abierto, demostrando su aplicación práctica y efectividad.
- CategoríaAsistentes de programación con IA
- Modelo de preciosGratis
- ImplementaciónNube
- PlataformasWeb
Características principales de Spec-first Agentic Development
Desarrollo impulsado por especificaciones para agentes de codificación de IA
Especificaciones revisadas verificadas contra el código antes de construir
Espacios de trabajo aislados para cada tarea de desarrollo
Confirmaciones condicionadas que requieren que todas las verificaciones pasen
Especificaciones persistentes almacenadas en el repositorio
Registro de decisiones con razonamiento para trazabilidad
Soporte para desarrollo paralelo con identificadores de rama únicos
Flujos de trabajo reanudables con estado almacenado en context.yaml
Método, plantillas y plugin Claude Code licenciados bajo MIT
Compatibilidad con Codex, Cursor, Copilot y terminal
Gancho de commit-msg de git para hacer cumplir las puertas de confirmación
Verificación automatizada de evidencia para citas de especificaciones
Solicitudes de extracción estructuradas para una o varias especificaciones
Contextos y reglas generados a partir de la base de código existente
No se requiere código escrito a mano para el proceso de construcción de Agent Smith
¿Cómo usar Spec-first Agentic Development?
Instalar Plugin/Gancho: Instala el plugin Claude Code o el gancho de commit-msg de git en tu clon del proyecto.
Iniciar Proyecto: Ejecuta /spec-first:bootstrap-project para generar contextos y reglas a partir de tu código existente.
Crear Especificación: Define una nueva tarea con un objetivo, pasos, hechos y criterios de hecho utilizando la habilidad create-spec.
Revisar Especificación: Haz que un revisor nuevo verifique la especificación contra el código para asegurar precisión y viabilidad.
Aplicar Especificación: El agente construye la especificación en su propia rama y espacio de trabajo, siguiendo las reglas del proyecto.
Entregar Especificación: Confirma los cambios a través de la puerta, asegurando que todas las verificaciones pasen, y abre una solicitud de extracción.
Entregar Serie: Para cambios más grandes, utiliza /spec-first:deliver-series para gestionar y entregar múltiples especificaciones interdependientes.
Casos de uso de Spec-first Agentic Development
- Desarrollo de Código con Agentes de IA
- Asegurando la Calidad del Código
- Gestionando Proyectos Complejos
- Mejorando la Trazabilidad del Código
- Facilitando Revisiones de Código
- Automatizando Flujos de Trabajo de Desarrollo
- Integrando Nuevos Desarrolladores
- Integrándose con Herramientas Existentes
