Sobre / Visao geral

Visao geral

Um sistema de trabalho ao redor do agente para uma engenharia duravel e supervisionada.

OpenSymphony e uma implementacao greenfield em Rust do desenho OpenAI Symphony . Ele combina um control plane em Rust com uma app desktop para visualizar task graphs com dependencias, inspecionar execucoes, arquivos alterados e memoria do projeto em grafos. Cada issue preserva seu proprio workspace, enquanto OpenHands e a rota local Codex app-server oferecem escolhas explicitas de harness.

Criado por

Duas camadas

O que OpenAI Symphony define e o que OpenSymphony implementa.

O que e OpenAI Symphony

Um modelo para orquestracao do sistema de trabalho

OpenAI Symphony transforma ticket, workspace e workflow contract em conceitos de runtime de primeira classe. Ele assume polling, reconciliacao, workspaces preservados e revisao humana dentro do ciclo.

O modelo de orquestracao torna polling, selecao, reconciliacao e dispatch partes explicitas do sistema de trabalho.
Diagrama mostrando o poll loop de orquestracao, a logica de selecao e as interfaces de backend no modelo Symphony.

O que OpenSymphony entrega

Uma implementacao local-first concreta em Rust

OpenSymphony usa Linear para issues, OpenHands como harness padrao e uma rota local Codex app-server suportada. O control plane pode ser observado pela TUI e por um app desktop completo com visualizacoes de Knowledge Graph, Task Graph e Code Graph.

O Task Graph desktop torna visiveis evidencias concluidas, execucao ativa e dependencias do backlog na mesma superficie.
Task Graph desktop do OpenSymphony com paineis Completed, Current e Backlog, setas de dependencia e um caminho critico selecionado.

Arquitetura

Cinco camadas mantem o sistema legivel.

OpenHands ou Codex executam o trabalho, e OpenSymphony possui o ciclo de vida ao redor dele.

Policy

Arquivos de workflow e regras do repositorio

WORKFLOW.md, AGENTS.md e skills locais definem o contrato de como o repositorio quer que o trabalho rode.

Configuration

Configuracao tipada de workflow e runtime

OpenSymphony resolve configuracao, variaveis de ambiente, paths e settings de OpenHands antes da execucao.

Coordination

Scheduler, retries e reconciliacao

O orquestrador decide elegibilidade, concorrencia limitada, despacho com hierarquia, retries e recuperacao na inicializacao.

Execution

Workspace manager mais runtime do harness selecionado

Cada issue se mapeia para um workspace deterministico, e o harness selecionado cuida da sessao e das ferramentas dentro desse limite. OpenHands e a rota padrao, com uma rota local Codex app-server suportada.

Clients

Control plane e clientes

A TUI e o app desktop leem o control plane e mantem separados o monitoramento, os task graphs, o detalhe de execucao e o contexto do projeto da corretude da orquestracao.

Resumo do workflow

O ciclo completo em uma passada.

O ciclo mantem planejamento, execucao, revisao e recuperacao ligados ao mesmo contexto da issue.

Diagrama mostrando o fluxo de uma issue do Linear pelas camadas de runtime do OpenSymphony ate a tarefa de codigo e o agente de IA.

01

Consultar o Linear por issues elegiveis

As issues candidatas vem do tracker com scheduling consciente de hierarquia.

02

Preparar o workspace da issue

Hooks, manifests, artefatos de prompt e checagens de ownership vivem no diretorio escopado pela issue.

03

Anexar ou retomar a sessao de execucao

OpenSymphony reutiliza conversas por issue e lida com continuacao, startup recovery e reconciliacao.

04

Acompanhar o progresso pelo control plane

A pessoa operadora ve o trabalho na TUI ou no app desktop e inspeciona snapshots, eventos, retries, estado das tarefas e contexto da issue.

05

Manter revisao e recuperacao no mesmo ciclo

Feedback de PR, retrabalho, reinicio e novas execucoes continuam anexados ao mesmo contexto.

Regras de design

As fronteiras sao o ponto central.

O orquestrador e a fonte da verdade.

Estado de scheduling, retries e recuperacao ficam em Rust, onde a orquestracao permanece autoritativa.

Cada issue possui sua fronteira de execucao.

Isolamento de workspace mantem estado duravel e recuperacao compreensiveis.

Os clientes permanecem focados na supervisao.

A TUI e o app desktop oferecem observabilidade e supervisao enquanto a orquestracao mantem a autoridade em Rust.

Revisao humana faz parte do modelo.

O modelo se concentra em trabalho agentico supervisionado de longo horizonte com trilha de auditoria clara.