Dilis Forge

Harness leve para estruturação inicial de projetos de software, mantido por Dilis Game Studio.

O Forge transforma uma ideia ainda pouco estruturada em documentação clara e versionável. A V0.2 cobre o caminho ideia → intenção → requisitos → especificação. Não gera código, não escolhe stack e não depende de IA.

Instalação

npm install --global @dilisgs/forge

Ou execute sem instalar:

npx @dilisgs/forge init

Requer Node.js 20 ou superior.

Uso

Tenho uma ideia
      ↓
forge init
      ↓
Tenho a intenção documentada
      ↓
forge requirement add
      ↓
Tenho requisitos estruturados
      ↓
forge spec
      ↓
Tenho a especificação com critérios de aceitação
      ↓
forge validate
      ↓
Tenho uma base consistente para continuar o projeto

Inicializar a intenção

forge init

O Forge pergunta:

• o que está sendo construído;
• qual problema será resolvido;
• quem possui esse problema;
• qual resultado é esperado;
• o que está no escopo;
• o que está fora do escopo.

Ao concluir, cria:

.forge/intent.md

Se o arquivo já existir, o Forge não o sobrescreve.

Adicionar requisitos

forge requirement add

Tipos suportados:

| Identificador | Apresentação | | ------------- | ----------------------- | | FR | Requisito Funcional | | NFR | Requisito Não Funcional | | BR | Regra de Negócio |

Prioridades: Obrigatório, Importante e Desejável.

O primeiro requisito cria .forge/requirements.md. Os identificadores são sequenciais e independentes por tipo (FR-001, NFR-001, BR-001).

Listar requisitos

forge requirement list

Gerar a especificação

forge spec

Para cada requisito, o Forge pede os critérios de aceitação (separe vários com ;). O resultado descreve o quê o sistema deve fazer, não como será implementado.

Cria:

.forge/spec.md

Se o arquivo já existir, o Forge não o sobrescreve.

Validar o projeto

forge validate

Verifica se a intenção está completa, se cada requisito está bem formado e, quando spec.md existir, se cada requisito possui comportamento e critérios de aceitação.

• projeto válido: código de saída 0
• projeto com erros: código de saída diferente de 0

Ajuda e versão

forge --help
forge --version

Arquivos gerados

.forge/
├── intent.md
├── requirements.md
└── spec.md

Os artefatos são Markdown, em português, e podem ser versionados com Git. A CLI não é necessária para ler o projeto.

Princípios

• intenção antes da implementação
• requisitos antes da arquitetura
• especificação antes do design técnico
• funciona completamente offline
• sem APIs de LLM
• requisitos e especificação descrevem o quê, não como

Desenvolvimento

npm install
npm run build
npm test
npm run lint

node ./bin/forge.js --help
node ./bin/forge.js --version

Repositório

Código-fonte: Dilis-Game-Studio/dilis-harness

Licença

MIT © Dilis Game Studio