SDD - Spec-Driven Development
Consola de trabajo para Spec-Driven Development dentro de VS Code: gestiona un agente de contexto, crea y evalúa prompts estructurados con IA, y lleva registro de actividades.
Características
| Funcionalidad |
Descripción |
Estructura .sdd |
Inicializa automáticamente la carpeta .sdd/ con agent.md, control.md y prompts/ en tu workspace. |
| Agente de contexto |
Formulario visual para definir stack tecnológico, descripción del proyecto, funcionalidades principales, objetivos, público objetivo, boilerplate, restricciones y comandos personalizados. |
| Editor de prompts |
Crea y edita prompts estructurados en Markdown con secciones: descripción, qué hacer, pasos, archivos involucrados y consideraciones. |
| Evaluación global con IA |
Envía el prompt completo a DeepSeek y recibe una puntuación de calidad (0-100) con un gráfico gauge visual. |
| Evaluación por sección |
Cada sección del prompt se evalúa individualmente mostrando puntaje y sugerencias de mejora. |
| Contador de tokens |
Muestra en tiempo real la cantidad estimada de tokens del prompt y del agente. |
| Sidebar dedicada |
Panel en la barra de actividad con listado de prompts, búsqueda/filtrado y accesos directos. |
| Copia rápida |
Botón para copiar el prompt completo formateado al portapapeles. |
Requisitos
Instalación
Desde archivo VSIX (local)
code --install-extension sdd-yusepe-1.0.0.vsix
Desde el Marketplace (próximamente)
Busca "SDD - Spec-Driven Development" en la pestaña de extensiones de VS Code.
Configuración
Abre Settings (Cmd+,) y busca SDD YUSEPE:
| Setting |
Tipo |
Descripción |
sddYusepe.deepseekApiKey |
string |
Tu API key de DeepSeek para evaluación de prompts. |
Nota: La API key se almacena en la configuración local de VS Code y nunca se incluye en el código fuente de la extensión.
Uso
1. Crear la estructura SDD
Abre la paleta de comandos (Cmd+Shift+P) y ejecuta:
SDD: Crear estructura .sdd
Esto creará la carpeta .sdd/ con los archivos base en tu workspace.
2. Configurar el agente
Desde el panel lateral SDD o con el comando:
SDD: Configurar agente
Completa la información de tu proyecto: stack, descripción, objetivos, restricciones, comandos, etc. Esta info se usará como contexto automáticamente en cada prompt.
3. Crear y editar prompts
Haz clic en "Nuevo Prompt" en el panel lateral o abre un prompt existente. Cada prompt tiene:
- Descripción general — qué necesitas lograr
- Qué hacer — instrucciones específicas
- Pasos — secuencia paso a paso
- Archivos involucrados — archivos relevantes del proyecto
- Consideraciones — restricciones o notas importantes
4. Evaluar calidad
Presiona "Evaluar Prompt" para obtener:
- Un puntaje global (0-100) visualizado en un gauge
- Evaluaciones individuales por cada sección con sugerencias de mejora
5. Copiar y usar
Usa el botón de copiar para llevar el prompt formateado directamente al portapapeles y pegarlo en tu herramienta de IA preferida.
Comandos
| Comando |
Descripción |
SDD: Crear estructura .sdd |
Inicializa la carpeta .sdd en el workspace |
SDD: Configurar agente |
Abre el formulario del agente de contexto |
SDD: Abrir editor de prompt |
Abre el editor visual de un prompt |
Stack técnico
- TypeScript + Webpack (bundling)
- VS Code Extension API (webviews, commands, sidebar)
- DeepSeek Chat API (evaluación de prompts)
- SVG (gráfico gauge)
Desarrollo local
# Clonar e instalar
git clone https://github.com/yusepe/sdd-yusepe.git
cd sdd-yusepe
npm install
# Compilar en modo watch
npm run watch
# Ejecutar extensión (F5 en VS Code)
# Se abrirá una ventana Extension Development Host
# Empaquetar
npx @vscode/vsce package
Licencia
MIT
