Cómo un desarrollador de YADRO configura Claude Code con el método Spec-Driven Development

Daniil Podolsky, programador y arquitecto de YADRO, lleva nueve meses trabajando con la metodología Spec-Driven Development y dirige agentes de IA que escriben código en su lugar. Él no se considera un vibe coder, sino un ingeniero, y explica por qué. Es el primer artículo de su serie sobre cómo organizar el puesto de trabajo de un desarrollador SDD: un repaso de la configuración básica de Claude Code para cambiar de modelo rápidamente sin reiniciar.

SDD frente a vibe coding

El vibe coding consiste en que el desarrollador describe una tarea a la IA, mira el resultado e itera «a ojo». El enfoque es popular precisamente porque es rápido y no exige preparación previa.

Spec-Driven Development funciona con un principio radicalmente distinto. Primero se crea una especificación completa: requisitos, arquitectura, comportamiento del sistema, casos límite. Solo después el agente de IA empieza a trabajar con ese documento como si fuera un encargo técnico. El desarrollador define la estructura y toma las decisiones de arquitectura; la IA implementa los detalles y rellena el código.

Podolsky insiste en que su enfoque es «más complejo que simplemente conversar con una IA». SDD devuelve la disciplina de ingeniería a un terreno donde empezaba a desaparecer por la velocidad de las herramientas de IA: requisitos, diseño, implementación, verificación. Ha cambiado el ejecutor, pero el proceso sigue siendo de ingeniería. Eso es lo que distingue al SDD del vibe coding: es una metodología, no una herramienta.

Configurar Claude Code para varios proyectos

La tarea central del artículo es cómo cambiar de modelo en Claude Code sin reiniciar, de forma individual para cada proyecto. Parece un detalle menor, pero en la práctica frena mucho a quien lleva varios repositorios a la vez.

La configuración global estándar del modelo no sirve en esta situación. Cada proyecto tiene requisitos distintos: un servicio en producción necesita Opus, con razonamiento profundo y seguimiento estricto de instrucciones, mientras que un prototipo o una tarea rutinaria se las arregla bien con Sonnet o Haiku. Si cada paso de un proyecto a otro exige reconfigurar a mano y reiniciar el agente, el desarrollador empieza a evitar el cambio de modelo y elige uno «universal» en lugar del óptimo.

Principios clave de la configuración:

• `CLAUDE.md` en la raíz del proyecto: el modelo y el contexto quedan totalmente aislados a nivel de repositorio
• El comando `/model` cambia el modelo al vuelo sin reiniciar la sesión en curso
• El `settings.json` a nivel de proyecto guarda los perfiles de agentes, los permisos y el conjunto de herramientas
• Los archivos locales de override separan las configuraciones de dev y prod
• Las variables de entorno permiten controlar el modelo desde CI/CD sin editar archivos de configuración

Por qué la velocidad de cambio altera la calidad

En Spec-Driven Development, un mismo proyecto usa varios modelos de forma sucesiva en distintas etapas. Para crear la especificación hace falta un modelo potente, con buen razonamiento y respuestas extensas. Para implementar a partir de una especificación ya hecha basta uno rápido y predecible, que reduce la probabilidad de desviarse del encargo. Para la revisión final se necesita otro perfil distinto.

Si el cambio tarda medio minuto y requiere pasos manuales, el desarrollador acaba evitando cambiar de modelo. Eso perjudica tanto la velocidad como la calidad, sobre todo al redactar la especificación, donde el razonamiento es crítico.

«Mi enfoque de trabajo es más complejo que simplemente conversar con una IA», —

Daniil Podolsky, YADRO.

La serie continuará. Los próximos artículos tratarán la orquestación de varios agentes en paralelo, la gestión del contexto y la estructura de las propias especificaciones.

Qué significa

Spec-Driven Development va tomando forma como una disciplina de ingeniería propia. Mientras la mayoría de los desarrolladores aprenden vibe coding, una parte pasa a metodologías estrictas: documentación, especificación, agente, verificación. Este análisis de la configuración de Claude Code por parte de un arquitecto de YADRO es uno de los primeros materiales sistemáticos en ruso sobre el tema. También conviene seguir la serie si aún se trabaja con herramientas de IA de forma intuitiva.