Documentação

Onde o Coroid se encaixa

Como o Coroid difere de ferramentas de autocompletar, assistentes IDE, sessões de agente e ferramentas de prototipagem — e quando você deve optar por outra solução.

"Ferramenta de codificação AI" abrange diversos produtos realmente distintos. Eles não competem pelo mesmo objetivo, e escolher a categoria errada é um erro mais custoso do que selecionar o produto incorreto dentro de uma mesma categoria.

Quatro categorias

CategoriaExemplosDestinado a
AutocompletarGitHub CopilotFinalizar a linha que você está digitando
Assistentes IDEClaude Code, CursorUm desenvolvedor trabalhando em uma tarefa, com suporte
Sessões de agenteCodex, Claude Code na web, agente de codificação GitHub Copilot, DevinEntregar uma tarefa a um agente e depois verificar e orientar o resultado
Ferramentas de prototipagemLovable, v0, Bolt, Replit AgentTransformar uma ideia em algo visualizável
Entrega em produçãoCoroidModificar um código existente para atender a um padrão definido previamente

Os dois primeiros colocam um modelo ao lado do desenvolvedor. Sessões de agente transferem o trabalho da máquina do desenvolvedor, mas uma pessoa ainda seleciona cada tarefa, orienta o processo, testa o resultado e decide se está pronto. Ferramentas de prototipagem criam algo novo com rapidez. O Coroid não faz nada disso: ele executa um processo configurado uma vez em cada alteração feita em um código já em uso, independentemente de quem solicitou.

Começa do zeroComeça a partir do seu código
Uma pessoa guia cada tarefa

Ferramentas de prototipagem

Uma ideia transformada em algo que você possa ver

Autocompletar

Finalizar a linha que você está digitando

Assistentes do IDE

Um desenvolvedor trabalhando em uma tarefa

Sessões de agentes

Uma tarefa é entregue, depois verificada e acompanhada por quem a iniciou.

Seu processo executa cada tarefa

Coroid

Um padrão único para todas as alterações, independentemente de quem as solicitou.

Duas perguntas separam as categorias: o trabalho parte de um ponto zero ou do seu código existente, e uma pessoa guia cada tarefa ou o processo faz isso automaticamente?

Uma sessão e uma fábrica resolvem problemas diferentes

Sessões de agente são a comparação mais próxima, pois também resultam em pull requests. A diferença está no elemento que conduz o processo.

Uma sessão depende da pessoa que a gerencia. Alguém decide o que trabalhar, escreve o prompt, abre a pré-visualização, identifica falhas, cria instruções complementares e decide quando está concluído. O resultado depende da atenção dessa pessoa naquele dia, e apenas quem consegue realizar todas essas etapas pode gerenciar uma sessão: na prática, um engenheiro.

Uma fábrica opera com base em um processo configurado uma vez. O Coroid mantém as etapas no sistema — o especificação, a verificação de qualidade conforme os critérios de aceitação, a Revisão, as políticas de qualidade e as regras de aprovação — e as aplica a todas as alterações. Como o processo não depende de quem solicita, qualquer pessoa pode utilizá-lo.

Sessão de agenteCoroid
Quem pode solicitar trabalhoQuem conseguir operar a ferramenta e avaliar o diffQualquer pessoa na empresa, em linguagem simples
O que inicia o processoUma pessoa, uma tarefa por vezUma fila alimentada por pessoas, sistemas de rastreamento de issues e automações
Quem testa o resultadoA pessoa que iniciou o processoUm agente de QA, verificando os critérios de aceitação
O que determina que está prontoQuem ler o diffSuas políticas de qualidade e, em seguida, a aprovação de uma pessoa
A mesma tarefa no mês seguinteTão bom quanto a pessoa que gerenciar o processo naquele momentoO mesmo processo e as mesmas verificações
O que é mantidoUma transcriçãoProcedência: quem solicitou, o que foi decidido, cada execução e cada aprovação

Sessões são ótimas para exploração: trabalhar em um problema desconhecido com um agente ou fazer alterações que você quer moldar durante o processo. Para o trabalho que precisa atender a um padrão sempre igual, utilize o Coroid. Os dois se encontram no pull request: com o aplicativo GitHub, o Coroid pode executar as mesmas verificações e Revisão nos pull requests abertos pelos seus desenvolvedores com seus próprios agentes. Veja Revisando pull requests.

Prototipagem e produção são problemas distintos

Essa distinção merece clareza, pois ferramentas de prototipagem são muito eficazes e é fácil supor que a mesma abordagem funcione para o trabalho em produção.

A prototipagem prioriza a velocidade para gerar algo visível. Você começa do zero; não há arquitetura existente a respeitar, nenhum conjunto de testes a manter, nenhuma convenção a seguir e ninguém depende do resultado ainda. As restrições só atrapalhariam — e, corretamente, essas ferramentas impõem poucas delas.

O trabalho em produção é quase inteiramente definido por restrições. O código já existe e contém decisões já tomadas. Outros elementos dependem dele. Existem testes que devem continuar passando, convenções a serem seguidas, requisitos de segurança e conformidade, além de um processo de Revisão que deve ser cumprido antes de qualquer lançamento.

O Coroid foi desenvolvido com base nessas restrições, em vez de tentar evitá-las:

PrototipagemCoroid
Ponto de partidaUma tela em brancoSeu repositório existente
DestinoUma demonstração em execuçãoUm pull request em um branch
VerificaçãoEstá correto?Sua suíte de testes, portas de qualidade, independente QA
GovernançaMínimo por designPolíticas, regras de revisão, trilha de auditoria
RevisãoVocê analisa issoSeus engenheiros revisam o diff, sob a proteção do seu branch
SucessoA ideia vale a pena ser desenvolvidaA alteração é segura para ser mesclada

Eles se complementam bem

Não se trata de uma escolha entre os dois. Eles se encaixam de maneira óbvia:

Prototipar para decidir o que construir. Validar uma ideia, explorar uma interface, colocar algo na frente de um stakeholder ainda esta semana — uma ferramenta de prototipagem supera o Coroid em todos esses aspectos, e você deve usá-la.

Depois, construa onde você irá mantê-lo. Assim que a ideia estiver definida, o trabalho passa para o código-fonte que você realmente executa, com suas convenções, seus testes e seu processo de revisão. Essa é a função do Coroid.

O protótipo responde devemos construir isso?. O Coroid responde construa corretamente no sistema que já temos.

Quando não usar o Coroid

Ser direto sobre isso é mais útil do que uma lista de recursos:

  • Você está validando uma ideia, não a lançando. Use uma ferramenta de prototipagem. O Coroid produz uma alteração revisada para um repositório real, o que é uma sobrecarga desnecessária para algo que você pode descartar amanhã.
  • Você quer ver algo visual em minutos. O Coroid gera pull requests, não demonstrações ao vivo.
  • Você quer um programador parceiro. Se você quer permanecer no seu editor e trabalhar lado a lado com um modelo linha por linha, isso é um assistente IDE. O Coroid opera em unidades completas de trabalho enquanto você faz outra coisa.
  • Você quer explorar um problema à medida que avança. Se a alteração tomar forma enquanto você trabalha nela, oriente uma sessão de agente. O Coroid trabalha a partir de uma especificação e mantém o resultado alinhado a ela.
  • Você ainda não tem um repositório. O Coroid precisa de um lugar para trabalhar — veja Conecte seu código.

O que decorre do foco na produção

Várias coisas no Coroid parecem sobrecarga até você enxergá-las como requisitos de produção:

  • O trabalho é especificado antes de ser construído, para que haja algo a ser verificado, e qualquer pessoa possa solicitá-lo sem saber como ele é desenvolvido.
  • A verificação é realizada por um agente que não escreveu o código.
  • Nada chega ao seu branch padrão sem um pull request.
  • Políticas e portas são aplicadas no caminho de execução, não apenas sugeridas.
  • Toda execução é registrada — custo, modelo, etapas e evidências.

Nada disso vale a pena pagar em um protótipo descartável. Tudo isso vale a pena pagar em um sistema que sua empresa utiliza.