Configuração

O SpecForge é configurado por meio de variáveis de ambiente. Toda configuração é opcional — valores padrão sensatos são fornecidos.

Variáveis de Ambiente

Variável	Descrição	Padrão
SDD_DATA_DIR	Caminho onde todos os dados de spec são armazenados (projetos, templates, conhecimento)	./data
SDD_HOURLY_RATE	Taxa horária do desenvolvedor em USD, usada para estimativa de custo	50
SDD_LOCALE	Idioma padrão para o conteúdo gerado (en, es, pt)	en

Claude Desktop

Passe variáveis de ambiente na seção env da configuração do 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": "pt"
      }
    }
  }
}

Diretório de dados compartilhado

Se você trabalha em vários projetos, aponte SDD_DATA_DIR para um diretório estável fora das pastas do projeto. O SpecForge armazena dados por projeto em {SDD_DATA_DIR}/projects/{hash}/ — sem conflitos.

Claude Code

Defina variáveis de ambiente antes de adicionar o servidor MCP, ou exporte-as no perfil do seu shell:

# Opção 1: inline ao adicionar
SDD_HOURLY_RATE=120 claude mcp add specforge npx -y specforge-mcp@latest

# Opção 2: no perfil do seu shell
export SDD_HOURLY_RATE=120
export SDD_LOCALE=pt

Locale

O SpecForge suporta três locales para o conteúdo de specs e mensagens geradas:

Código	Idioma
en	Inglês
es	Espanhol
pt	Português

Você também pode mudar o locale em tempo de execução sem reiniciar:

Prompt: "Defina o locale para pt"

Isso chama set_locale e imediatamente altera todo o conteúdo gerado subsequentemente para português.

Armazenamento de Dados

Todos os dados são armazenados como arquivos JSON localmente — sem nuvem, sem contas, sem telemetria.

{SDD_DATA_DIR}/
├── projects/
│   └── {hash}/          # Um diretório por projeto (hash do caminho do projeto)
│       ├── specs/        # Todas as specs deste projeto
│       ├── metrics/      # Métricas de estimativa e qualidade
│       ├── patterns/     # Padrões aprendidos
│       └── knowledge/    # Contexto e documentação contribuídos
└── global/
    ├── templates/        # Templates de specs e PLAN.md
    └── pricing/          # Dados de estimativa de custo

Gitignore

Adicione seu SDD_DATA_DIR ao .gitignore se ele estiver dentro do seu projeto. O diretório padrão ./data normalmente é específico do projeto e não deve ser commitado.

Taxa Horária para Estimativa

SDD_HOURLY_RATE é usado pelo estimate para converter estimativas de story points em faixas de custo em dólares. Defina como a taxa média combinada da sua equipe para estimativas mais precisas.

# Desenvolvedor individual
SDD_HOURLY_RATE=80

# Taxa de agência
SDD_HOURLY_RATE=150

# Taxa combinada da equipe
SDD_HOURLY_RATE=95