Tudo no Orkestral fica na sua máquina em
~/.orkestral (um banco de dados SQLite local mais os modelos empacotados). Nenhum servidor é necessário e nenhuma telemetria é enviada.Como os termos se encaixam
Antes da lista alfabética, aqui está o formato do sistema para que as definições façam sentido no contexto.Pessoas (agentes)
O CEO coordena especialistas como o Tech Lead e o Code Reviewer. Você conversa com eles no chat.
Trabalho (issues)
Solicitações viram issues, agrupadas em epics, com status, prioridade e responsável.
Motor (Forge)
Providers premium planejam; o modelo local Forge executa as edições por meio do Fast Apply.
De A a Z
Use a tabela para uma consulta rápida e depois leia as entradas detalhadas abaixo para os termos que têm mais peso.| Termo | Definição em uma linha |
|---|---|
| Adapter | O conector que permite ao Orkestral conversar com um backend de modelo específico (Claude, Codex, Forge e outros). |
| Agent | Uma persona de IA com um papel, instruções e um lugar na hierarquia do time. |
| CEO | O agente orquestrador no topo, que lê seus repositórios, planeja e delega ao restante do time. |
| Code Reviewer | Um agente especialista que faz revisões de nível sênior nos seus pull requests. |
| Epic | Uma unidade maior de trabalho que agrupa issues relacionadas. |
| Fast Apply | O motor determinístico de SEARCH/REPLACE que aplica edições de código sem reescrever arquivos inteiros. |
| Forge | O modelo de código local empacotado que executa edições na sua máquina com custo de API de $0. |
| Issue | Uma unidade de trabalho rastreável criada a partir de uma solicitação, com status, prioridade e responsável. |
| Knowledge base | Um cérebro em estilo wiki por workspace, construído automaticamente a partir dos seus repositórios com busca local. |
| MCP | Model Context Protocol, o padrão que o Orkestral usa para conectar ferramentas e servidores externos. |
| Provider | Um fornecedor ou backend de modelo (premium ou local) ao qual um adapter se conecta. |
| Skill | Uma capacidade reutilizável ou conjunto de instruções focado que um agente pode aplicar a uma tarefa. |
| Source | Um repositório ou pasta que você adiciona a um workspace para que os agentes possam lê-lo. |
| Specialist | Um agente focado em um papel (Frontend, Backend, DevOps, QA, Designer) que faz o trabalho prático. |
| Tech Lead | O especialista que coordena os outros especialistas sob o CEO. |
| Workspace | O contêiner que reúne seus sources, issues, agentes, chat e base de conhecimento. |
Entradas detalhadas
Adapter
Adapter
Um adapter é a camada de conexão que permite ao Orkestral controlar um backend de modelo específico. Cada provider (Claude, Codex, Forge e outros) tem o seu próprio adapter, que sabe como enviar prompts e receber respostas. Adapters premium como o Claude Code e o Codex dependem de suas CLIs estarem instaladas e autenticadas, enquanto o adapter do Forge não precisa de nada a mais porque o seu modelo já vem empacotado.
Agent
Agent
Um agente é uma persona de IA com um papel definido, instruções e uma posição no time. Os agentes se reportam uns aos outros por meio de uma hierarquia real: o CEO se reporta a você, o Tech Lead e o Code Reviewer se reportam ao CEO, e os especialistas se reportam ao Tech Lead. Você menciona um agente com
@agent no chat para direcionar um turno a ele.CEO
CEO
O CEO é o orquestrador no topo do time. Ele lê seus repositórios, identifica a stack, planeja o trabalho e delega aos especialistas. O CEO se reporta a você e transforma suas solicitações em linguagem natural em trabalho rastreável, em vez de texto descartável.
Code Reviewer
Code Reviewer
O Code Reviewer é um agente especialista focado em qualidade. Ele faz revisões de nível sênior nos seus pull requests do GitHub, produzindo achados estruturados e comentários inline. Ele se reporta ao CEO junto com o Tech Lead.
Epic
Epic
Um epic é um contêiner maior que agrupa issues relacionadas. Quando várias issues pertencem ao mesmo esforço, o Orkestral as agrupa automaticamente sob um epic para que você possa acompanhar uma feature ou iniciativa como um todo, em vez de tarefas espalhadas.
Fast Apply
Fast Apply
O Fast Apply é o motor determinístico de edições do Orkestral. Ele recebe blocos de edição SEARCH/REPLACE e os aplica primeiro por correspondência exata, depois por correspondência com espaços em branco normalizados e, por fim, por uma passada fuzzy segura de correspondência única. Se uma edição for ambígua, ele rejeita a alteração em vez de escrever o conteúdo errado, então nunca corrompe um arquivo. É isso que permite ao modelo local mesclar edições sem reescrever arquivos inteiros.
Forge
Forge
O Forge é o modelo de código local empacotado (Qwen2.5-Coder, executado via
node-llama-cpp) que aplica alterações de código inteiramente na sua máquina com custo de API de $0. O fluxo é: um modelo premium planeja a alteração, o Forge emite as edições e o Fast Apply as aplica de forma determinística. O Forge só escala para um modelo premium quando não consegue aplicar uma edição, e uma visão de custo mostra quantas execuções foram resolvidas localmente versus escaladas.Issue
Issue
Uma issue é uma unidade de trabalho rastreável criada a partir de uma solicitação. Cada issue tem um status, prioridade, responsável e links de pai/filho, e pode ser agrupada sob um epic. Uma etapa de aprovação fica na frente de qualquer alteração de código, então nada toca no seu repositório até você dar o sinal. A deduplicação no lado do servidor evita que você receba issues duplicadas.
Knowledge base
Knowledge base
A base de conhecimento é um cérebro em estilo wiki para cada workspace, com páginas, wikilinks e uma visão em grafo. Ela é construída automaticamente a partir dos seus repositórios usando busca lexical BM25 mais busca semântica local (embeddings e RAG), tudo rodando no dispositivo e sem nuvem. Aprendizados do chat e das issues podem ser gravados de volta nela.
MCP
MCP
MCP significa Model Context Protocol. O Orkestral o usa para conectar ferramentas e servidores externos, como a integração com o GitHub ou as ferramentas de navegador do Playwright, para que os agentes possam agir além do seu código. Você configura os servidores MCP nas configurações.
Provider
Provider
Um provider é o fornecedor ou backend de modelo ao qual um adapter se conecta. Os providers se dividem entre os premium, que planejam (por exemplo Claude e Codex), e o Forge local, que executa. Você pode conectar vários providers e direcionar o trabalho entre eles.
Skill
Skill
Uma skill é uma capacidade reutilizável ou conjunto de instruções focado que um agente aplica a uma tarefa. As skills permitem que um agente especialize o seu comportamento para um tipo específico de trabalho sem mudar o seu papel central.
Source
Source
Um source é um repositório ou pasta que você adiciona a um workspace. Os sources dão aos agentes o código e o contexto de que precisam para planejar, executar e revisar. Um workspace pode conter vários sources.
Specialist
Specialist
Um especialista é um agente focado em um papel que faz o trabalho prático: Frontend, Backend, DevOps, QA ou Designer. Os especialistas se reportam ao Tech Lead, dividem o trabalho, executam e revisam uns aos outros antes de reportar de volta no chat.
Tech Lead
Tech Lead
O Tech Lead é o especialista que coordena os outros especialistas. Ele fica sob o CEO e direciona os agentes de Frontend, Backend, DevOps, QA e Designer para transformar um plano em trabalho implementado e revisado.
Workspace
Workspace
Um workspace é o contêiner que reúne tudo de um projeto: seus sources, issues e epics, agentes, histórico de chat e base de conhecimento. Cada workspace tem a sua própria cor de destaque, e trocar de workspace troca todo o contexto em que os agentes trabalham.
Como os papéis premium e local se dividem
Uma distinção recorrente que vale fixar: os modelos premium planejam e o modelo local executa.O que fazer a seguir
Crie um workspace e adicione um source
Configure um workspace e adicione ao menos um source para que os agentes tenham uma base de código para ler.
Converse com o CEO
Abra o chat e descreva o que você quer. O CEO planeja e transforma isso em issues e epics.
Deixe o Forge executar
Aprove o trabalho e deixe o Forge mais o Fast Apply fazerem as alterações localmente, escalando apenas quando necessário.
Se um termo no app não estiver listado aqui, ele geralmente corresponde a uma das entradas acima (por exemplo, um papel específico de especialista é um tipo de especialista, e um servidor de ferramenta específico é acessado via MCP).