Saltar para o conteúdo principal
Uma fonte é um repositório ou pasta que você conecta a um workspace. Quando você adiciona uma fonte, o Orkestral lê e mapeia o código, entendendo a stack, a estrutura e as convenções, antes de qualquer agente agir. Isso garante que o time trabalhe com contexto real do seu projeto, não com suposições.

Contexto completo

Os agentes leem seu código de verdade antes de planejar qualquer mudança.

Várias fontes

Adicione quantos repositórios quiser a um único workspace.

Git nativo

Status e diffs disponíveis pro time enxergar suas mudanças locais.

100% local

Tudo fica na sua máquina, em ~/.orkestral. Sem servidor, sem telemetria.

​
Adicionar uma fonte

1

Abra o workspace

Selecione o workspace onde você quer conectar o código. Cada workspace tem suas próprias fontes.
2

Clique em Adicionar fonte

Aponte pra um repositório Git ou uma pasta no seu disco. O Orkestral aceita qualquer diretório de projeto.
3

Aguarde o mapeamento

O Orkestral varre a fonte e monta o mapa do projeto. Em projetos grandes isso leva alguns instantes.
A fonte aponta pros arquivos no lugar onde eles já estão. O Orkestral não copia nem move seu código.

​
O que o mapeamento faz

Antes de qualquer agente atuar, o Orkestral indexa a fonte pra responder três perguntas:
Detecta linguagens, frameworks, gerenciadores de pacotes e ferramentas de build a partir dos arquivos do projeto.
Mapeia a árvore de diretórios, módulos e os pontos de entrada principais, pro time saber onde cada coisa vive.
Identifica padrões de nomenclatura, estilo e estrutura pra que as mudanças combinem com o resto do projeto.
Esse mapa é o que faz o time delegar com precisão. O CEO orquestrador usa ele pra planejar e direcionar os especialistas certos.

​
Usar várias fontes

Um workspace pode conter mais de uma fonte, por exemplo, um frontend e um backend separados, ou um monorepo dividido em pacotes. Os agentes leem todas as fontes em conjunto. Eles entendem como o front conversa com o back e mantêm a coerência entre os repositórios numa mesma tarefa.
Conecte só as fontes relevantes pro workspace. Repositórios extras aumentam o ruído de contexto e diluem o foco do time.

​
Consciência de Git

Quando a fonte é um repositório Git, o Orkestral expõe o estado do versionamento pros agentes:

Status

O time vê quais arquivos foram modificados, adicionados ou removidos desde o último commit.

Diffs

Os agentes leem as suas mudanças locais linha a linha antes de propor as próprias.
Assim os agentes trabalham sobre o seu estado atual, não sobre uma versão antiga do main, e evitam desfazer alterações que você ainda está fazendo.

​
Próximos passos

Workspaces

Organize fontes, agentes e tarefas por projeto.

O time de agentes

Veja como o CEO orquestra os especialistas a partir do mapa da fonte.