← Voltar ao blog
Aicerca de 6 min de leitura

No SoduWork, um pedido termina quando quem pediu assina, não quando o chat para

Publicado 21 de nov. de 2026
No SoduWork, um pedido termina quando quem pediu assina, não quando o chat para

O README abre com uma frase que também é a especificação do produto: um chat termina com uma resposta, um pedido no SoduWork termina quando a pessoa que pediu assina.

É uma reformulação pequena, com consequências grandes. Se um pedido só fecha na assinatura, então «pronto» precisa estar definido antes do trabalho começar, alguém além do autor precisa conferir, e tudo isso precisa deixar registro. O SoduWork, da mdiri-ai, coloca esses três requisitos num mesmo pool compartilhado de pedidos. Chegou a 6.170 estrelas depois do lançamento em 29 de outubro de 2026 e está em beta pública.

Como é um pedido

Você abre um pedido com um objetivo, as entradas e os critérios de aceite. Uma passada de IA pode refinar o texto e acrescentar critérios que você esqueceu. Aí você atribui, a si mesmo, a um colega ou a um agent, e o harness de quem recebeu executa.

Quando o trabalho volta, uma revisão de IA separada confere cada critério. Se algo falha, o trabalho volta com os motivos anexados. Se passa, quem executou confirma e quem pediu assina. Só então o pedido é fechado.

O diagrama no repositório tem seis caixas e uma linha pontilhada: abrir, refinar, atribuir, executar, revisar, assinar e salvar como plugin. A linha pontilhada volta de salvar para executar, porque o plugin é reutilizado.

Um harness executa, outro revisa

O harness é o runtime do agent, não o modelo. O SoduWork conecta nove deles por uma única interface de adaptador: Pi, OpenCode, DeepSeek Harness, Qwen Code, Kimi Code, Codex Harness, Codex e mais dois atrás de declarações de catalog. Programas que falam Agent Client Protocol entram só descrevendo.

A consequência de projeto é que quem revisa não precisa ser quem escreveu. Coloque o Pi com um modelo para fazer o trabalho e depois faça o OpenCode, com outro modelo, revisar contra os critérios. Dois harnesses diferentes, dois jeitos diferentes de errar, e uma revisão que não é o modelo corrigindo a própria lição de casa.

Dá também para trocar de harness no meio da conversa mantendo o histórico e a pasta de trabalho. Parece um conforto até você passar uma semana com três ferramentas e uma gaveta cheia de assinaturas; aí vira o motivo de usar um workbench só.

De uma boa execução a um ativo do time

A segunda metade do ciclo é a parte que os times costumam pular. Quando você e a IA acertam uma tarefa, você salva a conversa como plugin. O plugin passa por revisão, é concedido a um time ou a uma pessoa e pode ser revogado. Qualquer um do time pode executar e contribuir com melhorias.

O discurso é que o conhecimento para de morrer dentro de um thread de chat. A versão realista: um plugin é um método salvo, e um método vale o que vale a sua revisão. O SoduWork transforma a revisão em porteira, não em sugestão, o que é mais do que a maioria dos sistemas de plugin faz.

Por baixo de tudo fica a governança: papéis, uso, custo e log de auditoria, tudo auto-hospedado. Quem pediu, quem fez, qual plugin rodou, quem aprovou. Se você é a pessoa que precisa responder «por que o agent mandou aquele e-mail», essa é a tabela que você quer.

Como rodar

A partir do código, os pré-requisitos são Python 3.12.x e Node 22.x (22.19.0 ou mais novo nessa série), além do Git. Clone o repositório e suba:

sh start.sh --desktop          # macOS / Linux
.\start.cmd --desktop          # Windows PowerShell

A primeira execução instala dependências e sobe o Hub, o console de administração e o cliente desktop na mesma máquina. Você define uma senha para a conta admin, de 12 a 128 caracteres, e depois adiciona um provedor de modelo em Model catalog.

É o passo em que as pessoas erram, e o README aponta isso: salvar uma credencial de serviço não cria um modelo. Você precisa abrir o serviço conectado, escolher Add model, colar o model ID exato do provedor e marcar como chat model. O Pi usa o catalog do SoduWork; o Codex usa a própria conta, precisa do próprio login e não herda a API key que você acabou de adicionar.

Para um time, o Docker sobe a pilha inteira:

python3 ops/self-host/deploy.py up
python3 ops/self-host/deploy.py credentials

Isso levanta Hub, console de administração e PostgreSQL num único servidor. Ponha um proxy reverso HTTPS na frente e distribua o endereço. Os clientes desktop para Windows, macOS e Linux estão nas Releases, e a tela de login tem um campo Connection onde você cola a URL do Hub.

Tem uma demo hospedada em service.soduwork.ai se quiser olhar antes de instalar. O README deixa claro que é só para avaliação e que você não deve subir dados reais de negócio.

Onde vai apertar

Quatro coisas para pesar.

A revisão continua sendo um modelo de linguagem. «Uma revisão de IA separada confere cada critério» é um avanço real sobre a autoavaliação, e não é verificação. Um critério como «a exportação contém todas as 47 linhas» dá para checar; um como «o tom bate com a nossa marca» é a opinião de um modelo com um checklist colado em cima. A qualidade do ciclo inteiro é a qualidade dos seus critérios de aceite, e isso é habilidade de escrita, não funcionalidade de produto.

Nove harnesses são nove vezes a manutenção. Adaptadores apodrecem. O que lança versão mais rápido quebra primeiro, e as partes que dependem dele (plugins, revisão, histórico) quebram junto. Um time pequeno consegue manter dois ou três adaptadores em dia e vai parar de testar o resto sem perceber.

Tem também um problema de categoria. O SoduWork compete ao mesmo tempo com trackers de projeto, orquestradores de agentes e clientes de chat, e cada um carrega dez anos de expectativa. Abrir um pedido no SoduWork significa não abrir no Linear, e o agent pode ser o único participante que prefere a ferramenta nova.

Beta quer dizer beta. Beta pública, avalie antes de produção, nenhuma certificação de compliance citada. Auto-hospedar é a resposta certa para times que se importam com onde os dados ficam, e também significa que as atualizações são suas.

A adoção é o portão de verdade. Um pool de pedidos só funciona se as pessoas abrirem pedidos nele. Dez engenheiros com dez janelas de chat privadas contornam qualquer workbench, e o log de auditoria fica vazio e correto.

A ideia que vale copiar

Defina a régua antes de começar. Faça outra pessoa conferir. Faça uma pessoa assinar. Guarde o que funcionou.

Nenhuma das quatro é nova. É assim que agências, editoras e áreas de QA sempre trabalharam, e é exatamente o que as interfaces de chat tiraram. O SoduWork devolve isso e deixa você escolher qual runtime de agent digita.

Se você toca um time pequeno e a reclamação recorrente é «o agent disse que estava pronto e não estava», o campo de critérios de aceite é a parte mais barata de copiar, com ou sem o software.

Artigos relacionados