Configuración

SpecForge se configura mediante variables de entorno. Toda la configuración es opcional — se proporcionan valores por defecto razonables.

Variables de Entorno

Variable	Descripción	Valor por defecto
SDD_DATA_DIR	Ruta donde se almacenan todos los datos de specs (proyectos, templates, conocimiento)	./data
SDD_HOURLY_RATE	Tarifa horaria del desarrollador en USD, usada para estimación de costos	50
SDD_LOCALE	Idioma por defecto para el contenido generado (en, es, pt)	en

Claude Desktop

Pasa las variables de entorno en la sección env de tu configuración del servidor MCP:

// claude_desktop_config.json
{
  "mcpServers": {
    "specforge": {
      "command": "npx",
      "args": ["-y", "specforge-mcp@latest"],
      "env": {
        "SDD_DATA_DIR": "/Users/me/specforge-data",
        "SDD_HOURLY_RATE": "120",
        "SDD_LOCALE": "es"
      }
    }
  }
}

Directorio de datos compartido

Si trabajas con múltiples proyectos, apunta SDD_DATA_DIR a un directorio estable fuera de tus carpetas de proyecto. SpecForge almacena los datos por proyecto en {SDD_DATA_DIR}/projects/{hash}/ — sin colisiones.

Claude Code

Configura las variables de entorno antes de agregar el servidor MCP, o expórtalas en el perfil de tu shell:

# Opción 1: inline al agregar
SDD_HOURLY_RATE=120 claude mcp add specforge npx -y specforge-mcp@latest

# Opción 2: en el perfil de tu shell
export SDD_HOURLY_RATE=120
export SDD_LOCALE=es

Locale

SpecForge soporta tres locales para el contenido generado de specs y mensajes:

Código	Idioma
en	Inglés
es	Español
pt	Portugués

También puedes cambiar el locale en tiempo de ejecución sin reiniciar:

Prompt: "Set locale to es"

Esto llama a set_locale y cambia inmediatamente todo el contenido generado subsiguiente al español.

Almacenamiento de Datos

Todos los datos se almacenan como archivos JSON localmente — sin nube, sin cuentas, sin telemetría.

{SDD_DATA_DIR}/
├── projects/
│   └── {hash}/          # Un directorio por proyecto (hash de la ruta del proyecto)
│       ├── specs/        # Todas las specs de este proyecto
│       ├── metrics/      # Métricas de estimación y calidad
│       ├── patterns/     # Patrones aprendidos
│       └── knowledge/    # Contexto aportado y documentación
└── global/
    ├── templates/        # Templates de specs y PLAN.md
    └── pricing/          # Datos de estimación de costos

Gitignore

Agrega tu SDD_DATA_DIR al .gitignore si está dentro de tu proyecto. El directorio ./data por defecto es típicamente específico del proyecto y no debería commitearse.

Tarifa Horaria para Estimaciones

SDD_HOURLY_RATE es usada por estimate para convertir estimaciones en story points a rangos de costo en dólares. Configúralo a la tarifa promedio ponderada de tu equipo para obtener las estimaciones más precisas.

# Desarrollador individual
SDD_HOURLY_RATE=80

# Tarifa de agencia
SDD_HOURLY_RATE=150

# Tarifa ponderada del equipo
SDD_HOURLY_RATE=95