# FullSpec: Marco de Desarrollo Impulsado por IA con Claude Code
El desarrollo asistido por IA suele convertirse en un caos sin documentación arquitectónica unificada. FullSpec lo soluciona formalizando todo el ciclo de vida, desde la idea hasta el lanzamiento, mediante una cadena de especificaciones que generan y mantienen agentes de IA.
El Problema: La IA sin Memoria Arquitectónica
El principal desafío con modelos de lenguaje grandes como Claude Code es la falta de contexto para las decisiones arquitectónicas. La IA genera código rápidamente, pero olvida por qué se construyó el sistema de esa manera. En un proyecto con 25 microservicios, esto genera conflictos graves:
- Algoritmos de encriptación inconsistentes entre servicios vecinos
- Contratos de API incompatibles
- Decisiones contradictorias de sesiones paralelas
La documentación tradicional falla: está desactualizada o enterrada en burocracia. La IA necesita especificaciones frescas, completas y sin contradicciones, y FullSpec proporciona exactamente ese entorno.
Arquitectura de FullSpec: 23 Agentes y 8 Fases
El marco estructura el desarrollo mediante documentos formales que generan y validan agentes de IA. Los usuarios activan /chain con una descripción de la tarea, como "implementar autenticación OAuth2", iniciando una secuencia de 8 fases.
Niveles de Especificaciones
La cadena produce cuatro niveles de documentos con revisiones obligatorias en cada uno:
- Discusión — requisitos, criterios de éxito, alcance y riesgos
- Diseño — cambios en el sistema: servicios, contratos de API, modelos de datos
- Plan de Pruebas — escenarios de prueba escritos antes de cualquier código
- Plan de Desarrollo — tareas, dependencias y bloques de ejecución
Una vez aprobadas las especificaciones, el sistema genera automáticamente documentos, crea Issues en GitHub, escribe código y pruebas, realiza revisiones de código y construye PRs.
Mecanismos Clave del Marco
Flujos de Trabajo Paralelos de Agentes
En lugar de un solo Claude manejando tareas secuencialmente, FullSpec despliega 23 agentes de IA especializados:
- Generador de diseños
- Planificador de pruebas
- Codificadores para varios lenguajes
- Revisores en cada nivel
- Agentes de sincronización de documentos
Durante las sincronizaciones, activa N agentes en paralelo, uno por servicio.
Validación Automática y Reglas
El sistema incluye más de 80 scripts de validación y 30 hooks pre-commit que verifican:
- Formatos de documentos
- Consistencia estructural
- Ausencia de secretos en el código
- Estándares de mensajes de commit
16 reglas contextuales se cargan automáticamente por tipo de archivo: .ts → estándares de TypeScript, .py → estándares de FastAPI. Las reglas residen en .claude/rules/ y se aplican sin prompts adicionales.
Especificaciones Vivas y Detección de Conflictos
Lo que lo diferencia de la competencia: el sistema detecta y corrige discrepancias entre código y especificaciones. Tras el commit, se ejecuta CONFLICT-CHECK:
- Detiene en contradicciones
- Identifica el nivel del conflicto (Diseño, Plan de Desarrollo, etc.)
- Propaga actualizaciones de especificaciones de arriba hacia abajo
- Mantiene los documentos actualizados en todas las etapas de desarrollo
Comparación con Alternativas
| Criterio | FullSpec | Spec Kit (GitHub) | Kiro (AWS) | OpenSpec (Fission AI) |
|----------|----------|-------------------|------------|-----------------------|
| Tipo | Marco de procesos | Kit CLI | IDE (fork de VS Code) | Marco CLI |
| Formalización de Requisitos | Discusión con criterios | Constitución + Spec | Requisitos (EARS) | Propuesta |
| Diseño Arquitectónico | Diseño con contratos de API | Plan | Diseño (markdown) | Diseño |
| Planificación de Pruebas Pre-Código | Plan de Pruebas con numeración TC-N | No | No | No |
| Detección de Conflictos | Automática + actualizaciones en cascada | No | No | No |
| Documentos Vivos | Autosincronización desde specs | No | No | No |
| Automatización de GitHub | Issues, PRs, Revisiones, Releases | No | No | No |
| Agentes de IA | 23 en paralelo | 0 | 1 (integrado) | 0 |
| Validación | 80+ scripts, 30 hooks pre-commit | 0 | 0 | ~5 |
| Soporte para Brownfield | Aún no | Sí | Sí | Sí (enfoque) |
FullSpec cubre el ciclo completo de desarrollo, pero está ligado a Claude Code y aún no integra brownfield.
Especificaciones Técnicas
- 71 habilidades — comandos slash para cada paso del proceso
- 23 agentes de IA — trabajadores paralelos con especialidades
- 80+ scripts de validación — verificaciones en todas las etapas
- 30 hooks pre-commit — control de calidad automatizado
- 16 reglas contextuales — se expanden con nuevas tecnologías
- 8 fases de proceso — desde la idea hasta el lanzamiento en producción
- Estandarización recursiva — se auto-construye con sus propias reglas
Lecciones Clave
- Baja barrera de entrada — complejo por dentro, pero los usuarios solo usan
/chainy confirman por chat - Solo Claude Code — diseñado para esta IA; otras no probadas
- Documentos en ruso — instrucciones y specs en ruso, pero Claude los maneja bien
- Solo greenfield — funciona como plantilla para proyectos nuevos; brownfield en desarrollo
- Código abierto — con licencia MIT en GitHub
Este proyecto da vida a un enfoque donde la IA no solo genera código: prospera en un proceso formalizado con documentos vivos. Reduce riesgos arquitectónicos y aumenta la predictibilidad para equipos que usan IA.
— Editorial Team
Aún no hay comentarios.