Documentação

Glossário

Todos os termos utilizados na interface do Coroid são definidos uma única vez.

Os termos são definidos aqui uma única vez e vinculados de todos os outros lugares.

Critérios de aceitação

As declarações verificáveis em uma especificação que determinam se o trabalho foi bem-sucedido. Os testes de verificação são feitos com base nelas.

Porta de orientação

Uma porta de qualidade cuja falha é registrada como um achado, mas não interrompe a tarefa. Diferencia-se de uma porta bloqueante.

Agente

Um trabalhador especializado que executa uma etapa de uma tarefa. Cada agente tem uma função fixa e um conjunto restrito de ferramentas. Veja Funções de agente.

Hora de agente

Uma unidade de tempo de execução medida. É contabilizada enquanto o agente trabalha ativamente em uma tarefa, não enquanto ela aguarda na fila.

Slot de agente

A unidade de paralelismo. Um slot executa uma tarefa por vez. Veja Capacidade e slots de agente.

AI profile

Uma configuração nomeada de modelo atribuída a um agente, equilibrando custo, velocidade, capacidade e restrições como residência de dados. Veja AI profiles.

Automação

Trabalho que começa sem que alguém precise solicitá-lo a cada vez: uma programação ou um gatilho que é acionado quando algo acontece. As automações estão listadas na fábrica. Veja Automações.

Linha de base

O commit do ramo base a partir do qual um plano é iniciado. Antes de as pull request do plano serem mescladas, o Coroid verifica se o ramo base não foi alterado desde então. Se houver mudanças, uma pessoa deve aceitar o novo estado ou o Coroid fará a mesclagem e reverterá a verificação. Veja Quando o ramo base é atualizado.

Porta bloqueante

Uma porta de qualidade cuja falha interrompe a tarefa até que seja aprovada ou substituída.

BYOK

"Traga sua própria chave" — fornecer suas próprias credenciais do provedor de modelo para que o uso seja cobrado pelo seu provedor, segundo suas tarifas, em vez de através do Coroid.

Verificação

Uma única verificação realizada contra uma alteração. As verificações são agrupadas em políticas e executadas como portas.

Canário

Uma verificação do Quality Graph executada após uma implantação confirmada para avaliar a saúde do ambiente. Sua falha não apaga o registro da implantação bem-sucedida. Veja Lançamentos.

Coordenador

O agente que conduz uma tarefa no modo coordenador. Ele é o Arquiteto, mantido na tarefa depois do planejamento: dá instruções ao desenvolvedor, à equipe de QA e ao revisor, uma de cada vez, responde às perguntas deles e decide o que acontece após cada relatório. Ele não pode se sobrepor a um veredito nem concluir uma tarefa que não tenha sido aprovada pelo QA. Consulte Funções dos agentes.

Tentativa de implantação

Uma solicitação ou execução observada para um commit de release em um ambiente específico. As tentativas de repetição criam outra tentativa; o release mantém o resultado anterior. Consulte Lançamentos.

Descoberta

Algum item que o Coroid encontrou no seu código-fonte durante a análise, podendo se tornar uma sugestão de trabalho.

Achado

Um problema registrado em relação a uma alteração — seja por um agente revisor, um scanner ou uma Automação de aconselhamento. Os Achados são corrigidos como retrabalho ou anexados ao pull request.

Globalização

Preparar um produto para todos os mercados: código que funciona em qualquer idioma e cultura (internacionalização) e suas traduções (localização). Essa é também a página principal para ambos, além da Verificação de qualidade que garante que todas as alterações estejam prontas para o mundo todo. Veja Globalização.

Hook

Uma Automação no nível da organização que reage a um evento da plataforma. Veja Hooks.

Ingestão

A etapa em que uma solicitação se torna trabalho rastreável. Uma pessoa a registra por meio do Novo trabalho, de importação de issues ou do chat Preparar trabalho; outro sistema a registra por meio da ingestão de trabalho API ou de uma automação de eventos, como a que monitora o Slack ou o Telegram. Essas solicitações passam pela qualificação de trabalho antes que qualquer tarefa seja criada. No modo Assistente, o assistente de chat cria o trabalho diretamente, assim como o servidor MCP e a própria automação do Coroid. Veja Qualificação de trabalho e Formas de iniciar o trabalho.

Faixa

A faixa é o branch onde as tarefas de um plano são integradas. As tarefas direcionam-se à faixa em vez do seu branch base, e o resultado montado é promovido como um único pull request. Veja Tarefas, planos, sprints e faixas.

Atestação manual

É o registro feito por um Proprietário ou Administrador de que um pipeline externo implantou o commit fixado, com horário e motivo ou evidência de apoio. Esse registro documenta uma implantação observada; ele não executa CI nem aprova uma porta de forma retroativa.

MCP

Model Context Protocol. O Coroid conecta a servidores MCP externos e pode ser utilizado como um. Consulte o Visão geral das integrações.

Assistentes como Hermes, Codex e Claude Code utilizam o servidor MCP do Coroid para trabalhar com o Coroid. Veja Coroid como servidor MCP.

Planejar

Um conjunto ordenado de tarefas agrupadas em fases, aprovado antes da escrita do código.

Política

Um conjunto nomeado e versionado de portas de qualidade vinculadas a projetos.

Projeto

Um repositório mais sua configuração, contexto e definições. É o contêiner onde o trabalho é executado.

Promover

Abrir o pull request que leva o trabalho integrado de uma ramificação para a sua ramificação base, após a aprovação.

Chave do provedor

Uma credencial fornecida por você para um provedor de modelo. Ela é criptografada em repouso, nunca é retornada pelo API e nunca é incluída nas exportações de configurações.

Pseudolocalização

Renderizar o produto com uma tradução falsa, acentuada, mais longa e invertida para idiomas de direita para esquerda, a fim de identificar textos ausentes no catálogo, rótulos cortados e layouts que não são espelhados. Veja Pseudolocalização.

Porta de qualidade

Uma verificação que o trabalho deve passar antes de avançar. Veja Portas de qualidade.

Lançamento

Um commit fixado de projeto que passa por seus ambientes, com registros de verificações, aprovações, implantações e integridade em cada etapa. Um lançamento pode não ter versão. Veja Lançamentos.

Snapshot da porta de lançamento

Um resultado de prontidão imutável vinculado a um commit de lançamento, revisão de escopo, ambiente e versão da política. As Aprovações referem-se a esse resultado e tornam-se obsoletas quando o candidato ou a política mudam.

Sequência de lançamentos

Uma visualização ordenada de lançamentos de vários projetos. Pode mostrar progresso parcial, mas não garante uma implantação atômica entre repositórios.

Evidências de revisão

Artefatos anexados a um pull request como prova de verificação — implantações de pré-visualização, resultados de varredura, relatórios de cobertura e execuções de teste. Veja Evidências de revisão.

Regra de revisão

Uma instrução definida pela organização que orienta o que o agente revisor deve procurar.

Retrabalho

Enviar uma tarefa de volta ao agente desenvolvedor com as descobertas, mantendo seu contexto, em vez de recomeçar do zero.

Sentinela

Um nome antigo para automações que monitoram uma condição. Não existe um recurso Sentinela separado. Veja Automações.

Conta de serviço

Uma identidade não humana para acesso programático, com suas próprias credenciais delimitadas.

Outros sistemas usam uma conta de serviço para enviar solicitações através do fluxo de trabalho API. Veja Dos seus próprios sistemas.

Uma tarefa qualificada de uma conta de serviço aguarda que alguém a inicie, a menos que o proprietário ou administrador configure a conta para iniciar automaticamente o trabalho qualificado.

Especificação

A descrição de escopo, exclusões e critérios de aceitação elaborada antes da construção do trabalho.

Sprint

Um contêiner de trabalho com prazo limitado, com suas próprias métricas e cronograma.

Tarefa

Uma unidade de trabalho que resulta em um único pull request. A unidade que realmente é executada.

Qualificação do trabalho

As verificações que uma solicitação deve passar antes que qualquer trabalho seja criado. A qualificação analisa a solicitação em busca de valores sensíveis, a compara com o lançamento atual, procura por duplicatas, verifica ou reproduz o que puder e decide se ela se tornará uma tarefa, um plano, um relatório ou um cronograma. As solicitações que aguardam decisão estão listadas em Factory → Revisão.

Área de trabalho

O ambiente isolado e descartável onde um agente clona seu repositório e trabalha. Um por tarefa.

Prontidão global

O que o código na ramificação padrão de um projeto ainda presume sobre um idioma ou cultura específica, com tarefas de correção para isso. Veja Prontidão global e Cultura.