Cómo un Desarrollador de YADRO Configura Claude Code con Spec-Driven Development

El programador y arquitecto de YADRO Daniil Podolskiy trabaja con la metodología Spec-Driven Development desde hace nueve meses y gestiona agentes de IA que escriben código en su lugar. Él se llama a sí mismo no un vibe coder, sino un ingeniero — y explica por qué. Este es el primer artículo de su serie sobre la organización del espacio de trabajo de un desarrollador SDD: un examen de la configuración básica de Claude Code para cambiar rápidamente entre modelos sin recargar.

SDD vs. Vibe Coding

Vibe coding es cuando un desarrollador describe una tarea a la IA, ve lo que resultó e itera "por intuición". El enfoque es popular precisamente porque funciona rápido y no requiere preparación previa. Spec-Driven Development es fundamentalmente diferente.

Primero, se crea una especificación completa: requisitos, arquitectura, comportamiento del sistema, casos límite. Solo entonces el agente de IA comienza a trabajar a partir del documento como una especificación técnica. El desarrollador moldea la estructura y toma decisiones arquitectónicas, mientras que la IA implementa los detalles y completa el código.

Podolskiy insiste en que su enfoque es "más complejo que simplemente hablar con IA". SDD restaura la disciplina de ingeniería en un área donde comenzó a desaparecer debido a la velocidad de las herramientas de IA — requisitos, diseño, implementación, verificación. El ejecutor cambió, pero el proceso en sí sigue siendo de ingeniería.

Esto es lo que distingue SDD del vibe coding: no la herramienta, sino la metodología.

Configuración de Claude Code para Múltiples Proyectos

La tarea central del artículo es cómo cambiar modelos en Claude Code sin recargar, individualmente para cada proyecto. A primera vista un detalle, en la práctica — un serio cuello de botella para quienes manejan múltiples repositorios simultáneamente. La configuración global estándar de modelo no es adecuada en esta situación. Diferentes proyectos imponen diferentes requisitos: un servicio de producción necesita Opus con razonamiento profundo y adherencia estricta a instrucciones, un prototipo o tarea rutinaria funciona bien con Sonnet o Haiku. Si cada transición entre proyectos requiere reconfiguración manual y reinicio del agente, el desarrollador gradualmente comienza a evitar cambiar modelos — y elige uno "universal" en lugar del óptimo.

Principios clave de configuración:

• `CLAUDE.md` en la raíz del proyecto — modelo y contexto están completamente aislados a nivel de repositorio
• El comando `/model` cambia modelos sobre la marcha sin reiniciar la sesión actual
• `settings.json` a nivel de proyecto almacena perfiles de agentes, permisos y conjuntos de herramientas
• Los archivos de override locales distinguen configuraciones de dev y prod
• Las variables de entorno permiten controlar modelos a través de CI/CD sin editar archivos de configuración

Por Qué la Velocidad de Cambio Afecta la Calidad

Con Spec-Driven Development, un único proyecto utiliza secuencialmente varios modelos en diferentes etapas. Crear una especificación requiere un modelo poderoso con razonamiento fuerte y respuestas detalladas. Implementar a partir de una especificación lista necesita un modelo rápido y predecible — menor probabilidad de desviación de la tarea. Para revisión final, se necesita otro perfil nuevamente. Si el cambio toma treinta segundos y requiere manipulación manual, el desarrollador gradualmente comienza a evitar cambios de modelo. Esto empeora tanto la velocidad como la calidad — especialmente en la etapa de escribir la especificación, donde el razonamiento es crítico.

"Mi enfoque del trabajo es más complejo que simplemente hablar con IA", —

Daniil Podolskiy, YADRO.

La serie continuará. Los siguientes artículos cubrirán orquestación de múltiples agentes en paralelo, gestión de contexto y la estructura de las propias especificaciones.

Lo Que Esto Significa

Spec-Driven Development gradualmente se está convirtiendo en una disciplina de ingeniería separada. Mientras que la mayoría de los desarrolladores están aprendiendo vibe coding, algunos están haciendo la transición a metodologías rigurosas: documentación, especificación, agente, verificación. Un análisis de la configuración de Claude Code de un arquitecto de YADRO es uno de los primeros materiales sistemáticos en lengua rusa sobre este tema. La serie merece la pena seguirla para quienes aún trabajan con herramientas de IA intuitivamente.