--agent
O forge-sdd estrutura seu desenvolvimento orientado a IA com scaffolding inteligente, agentes especializados e ciclos incrementais que mantêm a consistência do projeto — sessão após sessão.
4 pilares que resolvem os maiores problemas de consistência e velocidade ao usar IA no dia a dia.
A IA atua sob papéis especializados (Orquestrador, Builder, Revisor), garantindo um ciclo de desenvolvimento estruturado, guiado e previsível do início ao fim.
As regras do projeto ficam em arquivos locais. A IA os lê a cada nova sessão e retoma de onde parou automaticamente.
Cada evolução é integrada de forma segura e acumulativa, respeitando as diretrizes de arquitetura e prevenindo regressões no código existente.
Abordagem Spec-First que inclui discovery para validação da ideia, especificações com critérios de conclusão objetivos e revisão automatizada de qualidade.
Como a estrutura gerada pelo init se conecta a cada etapa do ciclo de desenvolvimento
com IA.
init para gerar toda a estrutura sdd/ com memória, specs, agentes e prompts prontos para
uso.progress.md e constitution.md, define a
próxima ação e mantém o contexto entre sessões.feature ativa, implementa
seguindo os padrões da stack e atualiza o progresso ao terminar.Cada comando tem um propósito claro. Use o certo no momento certo.
| Comando | Quando usar | O que faz |
|---|---|---|
| /status | Início de sessão | Lê progress.md e reporta fases e bloqueios |
| /discovery | Ideia vaga | Sessão estruturada com personas PM + Engenheiro Sênior |
| /nova-feature | Ideia clara | Cria branch + spec + atualiza índice de features |
| /split-features | Feature grande (>7 tasks) | Quebra em sub-features desacopladas por domínio |
| /proxima-feature | Iniciar implementação | Retoma a próxima feature todo do backlog |
| /revisar | Antes do PR | Valida critério de conclusão, lint e memória |
| /constitution | Início ou mudança de arch. | Alinha constitution.md com o codebase real |
| /c4-architecture | Documentar arquitetura | Gera diagramas C4 em Mermaid |
| /doctor | Diagnóstico | Verifica integridade, MCPs e budgets |
| /archive | progress.md > 1KB | Move histórico antigo para o log |
| /upgrade-sdd | Nova versão SDD | Migra a estrutura para a versão mais recente |
Configure um ou múltiplos agentes simultaneamente com a flag --agent.
Use /
no chat do VS Code para
acionar os comandos diretamente. Ex: /status
Mencione o comando no chat do Claude para executar. Ex: /revisar
Peça pelo nome no chat do Antigravity para acionar. Ex: "rodar o status"
Projeto do zero ou adoção em projeto existente — o forge-sdd se adapta.
--agent
/constitution para definir arquitetura e regras
base/discovery "sua ideia" para explorar produto e
engenharia/nova-feature e inicie com
/proxima-feature
npx forge-sdd init . --yes no seu projeto
existente/constitution — o agente escaneia seu codebase e
aprende suas regras
/status/nova-feature~/.cache/forge-sdd/
Versões publicadas — stable e beta — atualizadas automaticamente a cada release.
Carregando releases...
Junte-se à comunidade. Use, adapte e contribua com o forge-sdd.