Você conhece Makefiles? Apenas arquivos, talvez?
Originalmente um Makefile foi criado para automatizar a compilação de programas. Em vez de redigitar todo o comando com os nomes de cada arquivo a ser compilado, você empilhou as referências nesse arquivo para que, no final, um make simples construísse seu aplicativo.
A partir desse princípio, você pode perfeitamente usar um Makefile para armazenar qualquer comando — builds, dev, testes e o resto — e executá-los de forma limpa através desse único arquivo. E isso, em qualquer pilha de tecnologia.
E o Justfile? O princípio é praticamente o mesmo: um arquivo, chamado "receitas", um comando curto para executá-las (just dev, just test…). Just é simplesmente mais moderno e mais legível do que Make para esse trabalho único de execução de tarefas.
O problema que ele resolve
Em um projeto real, os comandos diários são longos, difíceis de memorizar e diferentes de um repositório para outro. npm run dev aqui, cargo run --release ali, xcodebuild -scheme … -configuration … em outro lugar. Multiplique isso por dez projetos abertos em paralelo e você gastará seu tempo se perguntando "qual foi o comando para iniciar o servidor de desenvolvimento novamente?".
Um Makefile ou Justfile corrige isso definindo um vocabulário compartilhado por projeto: dev, test, build, lint, clean. O mesmo gesto, independentemente do que estiver por baixo.
Em Singularity: o arquivo se torna um lançador
É aqui que entra o Singularity. Nós integramos Makefiles e Justfiles para obter inicializadores de aplicativos com um clique, dentro do IDE. Sim… como no Visual Studio.
Concretamente, Singularity detecta o arquivo na raiz do seu projeto e fixa-o no topo da árvore, como uma linha própria — um "arquivo bloqueado" que permanece visível. Cada receita se torna clicável: um botão play, você pressiona, ele roda. Chega de abrir um terminal, procurar o comando certo e redigitá-lo sem erros de digitação.
Três botões de ação, suas receitas à mão
Nem todas as receitas são iguais. Aqueles que você executa vinte vezes por dia — dev, test, test-e2e — merecem mais do que uma viagem por um menu. Singularity permite configurar três botões de ação por arquivo: você atribui a cada um a receita de sua escolha e ela é executada com um único clique.
O restante das receitas (install, typecheck, lint, build, build-mac, clean, help…) permanece disponível no menu suspenso do arquivo. Nada está escondido, mas o essencial está à vista.
Sem Makefile? A IA escreve para você
O melhor para o final: você não precisa escrever esses arquivos você mesmo. Muitos desenvolvedores nunca tiveram tempo para aprender a sintaxe de Make ou Just — e isso é perfeitamente justo, não é a essência de seu trabalho.
No Singularity, você pergunta e a IA cuida disso: ela inspeciona seu projeto, entende sua pilha e gera o Justfile (ou Makefile) com as receitas certas — dev, test, build, lint — conectadas aos comandos certos. Você obtém um arquivo limpo e comentado, pronto para ser executado.
E como é apenas um arquivo de texto, você mantém o controle: você o revisa, o ajusta e o envia com o resto do projeto. A IA faz o primeiro rascunho, você é o dono do resultado.
Por que é mais que um atalho
Um botão play próximo a uma receita parece trivial. Não é.
Para você, é menos atrito: zero comandos para memorizar, zero erros de digitação, o mesmo gesto em todos os seus projetos.
Para sua equipe, é uma documentação executável: o Justfile diz, em preto e branco, como executar, testar e construir o projeto. Um recém-chegado não precisa mais perguntar: ele clica.
Para agentes de IA, finalmente — e esse é o objetivo de um Ambiente de Desenvolvimento Agente — essas receitas se tornam pontos de entrada confiáveis. Quando um comando tem um nome estável e um comportamento conhecido, um agente pode executá-lo, ler o resultado e seguir em frente. O Justfile não é apenas um conforto humano: é também o contrato que a IA segue para executar seu projeto.
Perguntas frequentes
Qual é a diferença entre um Makefile e um Justfile?
Ambos os comandos nomeados em grupo ("receitas") atrás de atalhos curtos. Make é a ferramenta histórica, projetada primeiro para compilação, com sintaxe às vezes complicada (guias, variáveis). Just é mais recente e serve apenas como executor de tarefas: sintaxe mais simples, leitura mais clara. No Singularity, ambos funcionam da mesma maneira que os inicializadores de um clique.
Singularity suporta ambos os formatos?
Sim. Singularity detecta um Makefile e um justfile na raiz do projeto, fixa-o no topo da árvore e expõe cada receita como um iniciador clicável, com até três botões de ação configuráveis.
Preciso conhecer a sintaxe Make ou Just para me beneficiar disso?
Não. Singularity pode gerar o arquivo para você via IA: ele analisa seu projeto, infere os comandos corretos (dev, test, build, lint) e escreve um Justfile ou Makefile limpo e comentado. Você revisa e ajusta se necessário, mas não precisa aprender nada para começar.
Funciona com alguma tecnologia?
Sim. Um executor de tarefas é independente de linguagem: ele apenas executa comandos shell. Node, Rust, Go, Swift, Python, um script caseiro… se rodar em um terminal, vai em um Makefile ou Justfile e, portanto, em um launcher Singularity.