Documentação

A Orkestra é uma suíte de onze módulos que compartilham um núcleo: a task, a decisão e o contexto são os mesmos em todos. Esta documentação começa pelo que você está tentando fazer, não pelo organograma dos módulos.

Três formas de usar

Elas não competem: a maioria dos times usa as três, com o mesmo login e o mesmo board.

• Pelo seu agente — Claude Code, Cursor ou qualquer cliente MCP fala com a suíte pelo Core. É o caminho para automação. ver
• Pela extensão de IDE — o board e a task dentro do editor, para quem escreve o código. ver
• Pelos apps web — Plan, Docs, Vivo e Ops, para quem não vive no editor. ver

Conectar um agente pelo Core

O Core é um servidor MCP. Qualquer cliente que fale o protocolo — Claude Code, Cursor, Windsurf — acessa a suíte inteira por ele, com OAuth: o token nunca vai em query string, e as permissões são as do seu usuário no Padlock.

# Claude Code — adicionar o servidor
$ claude mcp add --transport http orkestra https://mcp.orkestraai.com.br/mcp

# O login abre no browser (OAuth PKCE, pelo Padlock).
# Verifique o contexto ativo:
> suite_context()

As 47 ferramentas

Dez famílias. O prefixo diz qual módulo responde — e quando um módulo não está disponível, a ferramenta declara ausência em vez de inventar resposta.

Agent Flow (A0–A4)

O fluxo que conduz uma implementação do requisito ao merge. A diferença para um script encadeado é que cada etapa declara qual evidência prova que aconteceu — e o guard rail reprova o que não prova.

workflow_context(taskRef)
  // contexto antes de pensar em solução

workflow_start(taskRef, 'full')
  // devolve a etapa atual e o contrato: o que fazer,
  // guard rails, evidência esperada

workflow_report_step(evidência)
  // guard rail valida → escreve no card → avança a FSM
  // evidência rejeitada = corrigir e reportar de novo

workflow_checkpoint(decisão)
  // quando a escolha é do dono do produto, o fluxo PARA aqui

Extensão de IDE

Põe o board e a task dentro do editor. É um cliente da suíte entre outros — o quadro continua vivendo no Plan. Página do produto

$ code --install-extension djalexdee.orkestra-ai
$ cursor --install-extension djalexdee.orkestra-ai

Hosts suportados: VS Code, Cursor, Windsurf, Google Antigravity e Kiro.

Os módulos

Cada um resolve sozinho e é vendido à parte. O que muda quando dividem o mesmo núcleo é que a task do board, a decisão no Brain e a página no Docs são o mesmo objeto.

• Plan — board, sprints, projetos. Em produção.
• Docs — documentação viva, escrita também por agente. Em produção.
• Core — o servidor MCP e o Agent Flow. Em produção.
• Vivo — reuniões, gravação e transcrição. Em produção.
• Ops — deploys, incidentes, linha do tempo operacional. Em produção.
• Padlock — identidade, organizações e papéis. Em produção.
• Extensão — a suíte dentro da IDE. Em produção.
• Voice · Twin · Pulse · App — em construção. Não prometemos data aqui.

Integrações de board

Jira, GitHub Issues, Azure DevOps e ClickUp. A task continua morando na sua ferramenta; a Orkestra lê e escreve nela, em vez de pedir que o time migre.

Repositórios

GitHub, Bitbucket e GitLab. A branch carrega o id da task, os commits ficam ligados ao card e o PR abre com a spec no corpo.

Webhooks

Entrada e saída. Na entrada, eventos do seu board e do seu SCM chegam assinados. Na saída, cada avanço do fluxo pode notificar o seu sistema — com entrega registrada, para dar para responder “chegou?” sem adivinhar.

Autenticação

Toda a suíte autentica pelo Padlock, que é o emissor de identidade. Os produtos são clientes OAuth first-party (PKCE) — não há senha guardada em cada app, e revogar acesso num lugar revoga em todos.

Planos e módulos

A cobrança é por assento, não por uso. Um assento dá acesso aos módulos do plano, sem cota para acompanhar. Módulos avulsos podem ser assinados à parte quando o plano não os cobre. Ver preços

Self-host · BYOK

A chave de IA é sua: a conta do provedor também, e não há markup nosso sobre token. Para requisitos de soberania há VPC dedicado com os dados na região da sua escolha. Falar com vendas