Glossário
Uma referência rápida para os termos que você vai encontrar no SpecForge — escrita para pessoas, não só para desenvolvedores.
Spec
Uma spec (abreviação de specification, especificação) é um plano curto para uma funcionalidade ou mudança que você quer construir. Pense nela como um contrato entre você e sua IA: ela descreve o que construir, como deve funcionar e o que significa estar pronto.
Exemplo: Uma spec para "login com Google" incluiria: configurar as credenciais OAuth, adicionar o botão de login, salvar a sessão do usuário, redirecionar após o login. Sua IA lê isso e segue passo a passo.
Lista de verificação de "pronto"
Cada spec tem uma lista de verificação — uma lista de condições que precisam ser verdadeiras antes de a funcionalidade ser considerada terminada. Ela elimina a ambiguidade: em vez de "mais ou menos funcionando", você sabe exatamente quais caixas estão marcadas e quais ainda faltam.
Desvio (Drift)
O desvio (drift) acontece quando o código que você construiu não corresponde mais à spec original. Isso é normal — os requisitos mudam, atalhos são tomados, as ideias evoluem. O SpecForge detecta o desvio e te diz exatamente o que divergiu do plano.
Por que isso importa: Sem detecção de desvio, você pode achar que uma funcionalidade está pronta quando partes críticas estão faltando ou foram alteradas.
Servidor MCP
Um Servidor MCP é um plugin que estende sua ferramenta de IA (como Claude, Cursor ou Windsurf) com novas capacidades. O SpecForge roda como um Servidor MCP localmente na sua máquina — sua IA pode chamar suas ferramentas para criar specs, validar código, detectar desvios e muito mais.
Analogia: Pense nele como uma extensão de navegador, mas para o seu assistente de IA.
DGS (Desenvolvimento Guiado por Specs)
O DGS (SDD) é uma abordagem de desenvolvimento onde cada funcionalidade começa com uma spec clara antes de qualquer código ser escrito. A spec se torna a única fonte da verdade — sua IA a segue, e você valida contra ela quando termina.
Comparando com: O desenvolvimento ad-hoc, onde você descreve o que quer no chat e torce para a IA interpretar corretamente.
Projeto
No SpecForge, um projeto é uma pasta no seu computador que você inicializou com o SpecForge. Cada projeto recebe um ID único e armazena todas as suas specs, decisões e métricas localmente — sem necessidade de nuvem.
Stream
O SpecForge organiza suas 59 ferramentas em 8 Streams (A até H). Cada Stream agrupa ferramentas que fazem coisas parecidas: planejamento, análise, design, entrega, etc. Você não precisa conhecer todas as 59 — só o Stream relevante para o que está fazendo.
Validação
A validação é quando o SpecForge lê seu código e o compara com a lista de verificação de uma spec. Ele te diz quais itens estão completos, quais estão faltando e o que mudou em relação ao plano original.
Quando usar: Depois que você (ou sua IA) acham que uma funcionalidade está pronta.
Critérios de aceitação
Os critérios de aceitação são as condições específicas que precisam ser verdadeiras para uma spec ser considerada concluída. São os itens da lista de verificação. Cada critério é concreto e verificável — não "o login deve funcionar", mas "o usuário é redirecionado para /dashboard após um login bem-sucedido".
Inicializar
Inicializar um projeto significa apontar o SpecForge para a pasta do seu projeto para que ele escaneie seu código, detecte sua linguagem e framework, e configure o armazenamento local das specs. Leva alguns segundos e só precisa ser feito uma vez por projeto.
Padrão
Um padrão é uma solução recorrente que o SpecForge aprende com o seu projeto. Com o tempo, o SpecForge consegue reconhecer abordagens comuns no seu código e sugeri-las ao criar novas specs — para que sua IA construa de forma consistente.
Dívida técnica
A dívida técnica se refere a trabalho adiado ou atalhos tomados durante o desenvolvimento. No SpecForge, os itens de dívida técnica são registrados separadamente no arquivo de progresso de uma spec — eles não impedem que a spec seja considerada "pronta", mas ficam registrados para que nada seja esquecido.
Tem um termo que gostaria de ver aqui? Deixe um comentário abaixo ou nos contate no npm.