Começando com o Forge-SDD
O Forge-SDD é um orquestrador de desenvolvimento que conecta você e sua IA num fluxo de trabalho claro: você decide, a IA implementa, você aprova.
1. Instalação e setup
O forge init faz perguntas interativas sobre o projeto (nome, stack, banco). Se a sua IA faz o setup por você, use o prompt abaixo — ele coleta essas respostas antes de rodar o comando, sem travar em prompts interativos.
Quero instalar o forge-sdd aqui. Me ajude a configurar. Primeira pergunta: o que você está construindo? Descreva com suas palavras — pode ser simples, ex: "um app de agendamentos", "uma API para meu e-commerce", "um script que lê planilhas". Com base no que você me contar, vou sugerir a melhor configuração seguindo boas práticas de mercado e confirmar com você antes de rodar. Depois da confirmação, instale assim: npm install -g @nathanramorim/forge-sdd forge init --yes --name "[nome]" --stack [stack] --db [db] --agent [agente] Se preferir instalar agora com configuração padrão e ajustar depois, responda apenas: padrão
2. Defina as regras do projeto (/constitution)
Antes da primeira feature, você precisa registrar as decisões invioláveis do projeto: qual banco usar, como nomear branches, se usa ORM ou SQL direto, qualquer escolha que a IA não deve questionar. Essas regras formam a Constitution — um arquivo que todos os agentes leem antes de trabalhar.
Sem a Constitution, a IA toma decisões arbitrárias que você vai reverter mais tarde. Com ela, cada feature nasce alinhada com o que você decidiu.
Exemplo de instrução para a Constitution:
Nunca use ORM; acesso a banco sempre via SQL direto com prepared statements.
Branches de feature seguem o padrão feat/[número]-[nome-curto].
Vamos definir as regras do projeto com /constitution. Execute /constitution e me ajude a cadastrar as primeiras decisões arquiteturais. Comece me fazendo as 3 perguntas mais importantes para este tipo de projeto: quais são as decisões que mais causam atrito se não forem definidas logo no início?
3. Primeira feature
Com o setup e a Constitution no lugar, peça à IA para criar a primeira feature. Ela vai rodar o discovery, montar um plano e aguardar sua aprovação antes de escrever uma linha de código.
Vamos criar a primeira feature com o forge-sdd. Execute /discovery [descreva aqui o que você quer construir]. Me mostre o plano antes de implementar.
Jornada ideal
O Forge-SDD organiza o trabalho em três papéis simples. Você não precisa saber programar — só precisa tomar decisões.
Discovery
Você descreve o que quer. A IA analisa o projeto, levanta riscos e monta um plano detalhado. Você lê e decide se faz sentido.
Builder implementa
Depois da sua aprovação, a IA segue exatamente o plano: escreve o código, cria os testes e prepara tudo para você conferir.
Você aprova
As mudanças chegam sem surpresas. Você confere o que foi feito e aprova. Se não estiver bom, a IA corrige até ficar.
Exemplos práticos
Veja como adicionar uma feature real do início ao fim.
Adicionar comando forge greet
Neste exemplo, vamos adicionar um comando que imprime "Olá, mundo!" no terminal.
-
Inicie o discovery.
Mande o prompt abaixo para sua IA:
Prompt para IAInicie o discovery para: adicionar comando forge greet Execute /discovery e me mostre o plano antes de implementar.
-
Aprove o plano.
A IA vai mostrar o que pretende criar. Se estiver certo, diga "aprovado" ou "pode implementar".
-
Revise o PR no GitHub.
Quando a IA terminar, ela abre um PR com o código. Você revisa o diff e faz o merge.
Hub mode — um forge para vários repos
Em vez de rodar forge init em cada repo separado, você elege um repo como hub e os outros como satélites. O hub rastreia o status de todos os projetos do time em um único lugar.
Passo a passo
-
Inicialize o repo hub.
No repositório que será o hub central, rode:
forge init
-
Vincule os repos satélites.
Para cada repo do time que você quer rastrear:
forge init --link ../outro-repo
-
Veja o status de todos.
No repo hub, rode
forge pipelinepara ver o estado de cada repo vinculado:forge pipeline
Configure o forge-sdd como hub neste workspace. O repo atual é o hub. Para cada repo satélite, rode: forge init --link <caminho-do-repo> Me diga quando terminar e mostre os repos vinculados.
Liste todos os repos vinculados ao hub e o status de cada um: forge pipeline Mostre quais têm features abertas e quais estão sem atividade.