Ir para o conteúdo

Como funciona

De um objetivo a um plano que você acompanha

Seis fases, em um ciclo. Você diz o que quer. O PO planeja, ordena as tarefas, recorda o que o projeto sabe, executa o trabalho, confere e guarda o que foi aprendido. Em cada fase, você pode abrir os detalhes técnicos.

Planejar → Ordenar → Recordar → Executar → Verificar → Aprender, e de volta a Recordar. O que a fase 6 guarda é o que a fase 3 recorda no próximo plano.

Experimente: passe o cursor ou dê foco a uma etapa para lê-la; selecione para ir até ela

O ciclo

O ciclo, fase por fase

Role a página: cada imagem é desenhada como as telas do produto. O exemplo é um fim de semana de equipe.

Fase 1 de 6: Planejar, parada de leitura 5 de 5: Aprovado

Você diz o que quer e recebe um plano

Você descreve o resultado em uma frase. O assistente o transforma em um plano com tarefas. Cada tarefa tem passos, e cada passo diz como conferir que está concluído.

Por baixo dos panos

O resultado é guardado como um plano com uma prioridade e as suas restrições, e depois dividido em tarefas. Cada tarefa diz do que depende e lista os seus passos. Cada passo traz a verificação que prova que está concluído.

Planos, tarefas e passos são guardados como dados, não como texto livre em um chat. As telas e o executor leem os mesmos status.

plan(action: "create", title, description, priority: 8, constraints: [{ constraint_type: "performance", … }])task(action: "create", plan_id, title, depends_on: [task_id], steps: [{ description, verification }])
  • Status do plano: draft, approved, in_progress, completed, cancelled.
  • Tipos de restrição: performance, security, style, compatibility, other.
  • code(action: "plan_implementation", auto_create_plan: true) esboça um plano a partir do grafo de código.

Experimente: selecione uma parada, avance com as setas ou toque em reproduzir; o diagrama volta a acompanhar a rolagem depois de uma pausa

Fase 2 de 6: Ordenar, parada de leitura 5 de 5: Pronto agora

Tarefas que não dependem umas das outras andam juntas

O PO ordena as tarefas. Uma tarefa só espera as tarefas de que precisa. Todas as outras podem começar agora, ao mesmo tempo.

Por baixo dos panos

Uma tarefa só começa quando tudo de que depende está concluído. O PO transforma essas ligações em ondas: a onda 1 reúne toda tarefa sem pré-requisito pendente, a onda 2 reúne o que a onda 1 libera, e assim por diante.

As tarefas de uma mesma onda são independentes, então rodam ao mesmo tempo. A cadeia de dependências mais longa, o caminho crítico, define o número mínimo de ondas.

plan(action: "get_waves", plan_id)plan(action: "get_critical_path", plan_id)
  • plan(action: "get_dependency_graph") devolve o DAG das tarefas.
  • task(action: "get_next") devolve a próxima tarefa desbloqueada, de maior prioridade primeiro.
  • Quando uma execução é retomada, as ondas são recalculadas e as ondas já concluídas são puladas.
Plan · dependency graph
Wave 13 in parallelWave 22 in parallelWave 31 taskT1 Venuesno prerequisiteT2 Availabilityno prerequisiteT3 Budgetno prerequisiteT4 Bookingafter T1, T2T5 Mealsafter T3T6 Share planafter T4

Experimente: selecione uma tarefa para ver do que ela depende e o que libera

6 tasks3 waveswave 1 is ready now

Experimente: selecione uma parada, avance com as setas ou toque em reproduzir; o diagrama volta a acompanhar a rolagem depois de uma pausa

Fase 3 de 6: Recordar, parada de leitura 5 de 5: Entregue

O assistente consulta o que o projeto já sabe

Antes de cada tarefa, o assistente lê as notas e decisões que se aplicam. Assim ele não repete as mesmas perguntas.

Por baixo dos panos

Antes de uma tarefa, o assistente lê a memória do projeto: notas (avisos, diretrizes, padrões), decisões com os seus motivos e, em um projeto de código, o código em torno dos arquivos em que vai mexer. Uma busca pelo sentido encontra primeiro as correspondências mais próximas.

Depois o PO segue as ligações entre as notas. Uma nota que não correspondia à pergunta ainda pode aparecer, porque uma nota que correspondia está fortemente ligada a ela. A ligação enfraquece a cada passo, e as notas que se apagaram ficam de fora.

note(action: "search_semantic", query, project_slug)decision(action: "search_semantic", query)admin(action: "search_neurons", query, max_hops: 2)note(action: "get_context", entity_type: "file", entity_id)
  • Padrões da ativação por propagação: 20 notas de partida, 2 saltos, o sinal cai pela metade a cada salto, 10 resultados.
  • 40% das vagas de resultado são reservadas a notas alcançadas por sinapses.
  • Uma pontuação propagada é a pontuação do pai x peso da sinapse x energia da nota x decaimento.
Memory · recall
taskdirecthop 1hop 20.910.840.720.460.410.350.300.170.15

Experimente: selecione um nó para seguir a ativação de volta até a tarefa

Given to the assistant

  • The team prefers a quiet place
    0.91
    guidelinedirect match
  • The weekend is 14 and 15 June
    0.84
    decisiondirect match
  • Two people need vegetarian meals
    0.46
    gotcha1 hop
  • Last year the venue was too far from the station
    0.17
    guideline2 hops

Experimente: selecione uma parada, avance com as setas ou toque em reproduzir; o diagrama volta a acompanhar a rolagem depois de uma pausa

Fase 4 de 6: Executar, parada de leitura 5 de 5: Onda 2 começa

Os assistentes fazem as tarefas, grupo por grupo

Cada tarefa vai para o seu próprio assistente. As tarefas de um grupo rodam ao mesmo tempo, e o grupo seguinte espera.

Por baixo dos panos

plan(action: "run") inicia o executor em uma branch git própria. Para cada onda, ele inicia uma sessão de assistente por tarefa elegível e as roda em paralelo, até um limite (4 por padrão).

Cada tarefa recebe um prompt montado a partir da memória do projeto: a sua descrição, os passos e as restrições, as notas ligadas a ela, a persona e as habilidades que combinam e um resumo do que as ondas anteriores fizeram. Uma salvaguarda observa a sessão quanto a tempo ocioso, chamadas repetidas e timeouts, e envia uma dica quando o assistente se desvia.

plan(action: "run", plan_id, cwd, project_slug)plan(action: "run_status", plan_id)
  • Uma tarefa é classificada como simple, complex ou creative a partir das suas tags, passos e arquivos. O perfil define o seu limite de tempo e o seu orçamento de custo.
  • Simple: 600 s e US$ 0,50. Complex: 3600 s e US$ 2,00. Creative: 1800 s e US$ 1,00.
  • As execuções são salvas, então uma execução pode ser retomada após uma reinicialização. plan(action: "cancel_run") interrompe uma.
  • O assistente que delega uma tarefa pode indicar o provedor e o modelo para ela: plan(action: "delegate_task") recebe provider, model e task_class. O projeto precisa ter autorizado esse provedor.

Experimente: selecione uma parada, avance com as setas ou toque em reproduzir; o diagrama volta a acompanhar a rolagem depois de uma pausa

Fase 5 de 6: Verificar, parada de leitura 5 de 5: Concluída

Um grupo está concluído quando as suas verificações passam

Antes de o grupo seguinte começar, o PO confere o trabalho. Os passos devem estar fechados e nenhum arquivo sensível pode ficar nas mudanças. Em um projeto de código, o PO também confere se ele ainda compila.

Por baixo dos panos

Quando uma onda termina, o executor a verifica antes de a seguinte começar. Ele confere se os assistentes produziram commits, se todo passo está concluído ou ignorado, se o projeto compila e se o diff não contém arquivo sensível.

A execução em si é uma máquina de estados. Um protocolo de ciclo de vida vai de approved a executing e a post_run, e cada transição exige um gatilho explícito. Uma tarefa cujo assistente falha ou estoura o tempo é repetida uma vez por padrão, com o erro como contexto.

protocol(action: "transition", run_id, trigger: "child_completed")step(action: "get_progress", task_id)
  • Verificação de build: cargo check, npm run build ou go build ./..., conforme a linguagem detectada.
  • Arquivos sensíveis recusados: .env, credentials.json, *.pem, *.key e similares.
  • Os testes são uma opção, desativada por padrão. plan-runner-reviewed adiciona um estado awaiting_review para uma pessoa.

Experimente: selecione uma parada, avance com as setas ou toque em reproduzir; o diagrama volta a acompanhar a rolagem depois de uma pausa

Fase 6 de 6: Aprender, parada de leitura 6 de 6: De volta a Recordar

O que foi aprendido é guardado para a próxima vez

Quando o trabalho termina, o que foi decidido e aprendido é gravado de volta na memória do projeto. O próximo plano começa com isso.

Por baixo dos panos

Quando uma tarefa é concluída, o executor grava de volta sem chamar um modelo: liga os commits à tarefa e ao plano, cria uma nota de contexto a partir do log do git e associa as decisões aos arquivos que elas afetam.

O assistente acrescenta o que só ele sabe: decisões com as suas alternativas, avisos, padrões. Notas usadas juntas se aproximam. Notas que nunca são usadas perdem energia e ficam desatualizadas. Um episódio registra o pedido, o caminho pelos estados e o resultado. O próximo plano começa na fase 3 com tudo isso.

decision(action: "add", task_id, rationale, alternatives)note(action: "create", note_type: "gotcha", content, anchors)episode(action: "collect", run_id, project_id)admin(action: "reinforce_neurons", note_ids)
  • A desatualização cresce com o tempo desde a última atividade, a uma taxa que depende do tipo da nota. note(action: "confirm") a zera.
  • As habilidades emergem de clusters de notas fortemente ligadas (admin(action: "detect_skills")).

Experimente: selecione uma parada, avance com as setas ou toque em reproduzir; o diagrama volta a acompanhar a rolagem depois de uma pausa

Responsabilidades

Quem faz o quê

O PO cuida da mecânica, para o assistente se concentrar no trabalho.

O PO faz, sem ser solicitado

  • Ordena as tarefas em grupos e inicia os assistentes.
  • Confere cada grupo: passos fechados, nenhum arquivo sensível e o build em um projeto de código.
  • Liga as mudanças à tarefa e escreve uma nota sobre o que aconteceu.
  • Mantém as mudanças de cada execução em uma branch git própria.
  • Registra qual persona e quais habilidades ajudaram.

O assistente faz, por meio das suas ferramentas

  • Busca notas e decisões antes de começar.
  • Cria planos, tarefas e passos, e atualiza o seu status.
  • Guarda decisões com as suas alternativas e o que elas afetam.
  • Escreve avisos, diretrizes e padrões, ligados ao que dizem respeito.
  • Avança um procedimento, passo a passo.

Pontos de entrada

Três jeitos de iniciar o ciclo

A partir da sua ferramenta de IA

O Claude Code, o Cursor ou outra ferramenta de IA conectada ao PO. Você descreve o resultado. Ela planeja, ordena e recorda, e no fim guarda o que aprendeu.

A partir do chat

O chat integrado ao PO fala com o mesmo assistente. Cada mensagem leva as habilidades correspondentes, as notas e decisões que se aplicam e o que está em andamento. Digite # para apontar um plano, uma tarefa, uma nota ou uma decisão. Você escolhe o motor de uma conversa, o Claude Code por padrão ou outro motor (alfa), ou a coloca no Auto e o PO escolhe o modelo; um modelo que você mesmo escolheu nunca é substituído. Uma linha do tempo acima da conversa mostra o que rodou e por quanto tempo. Uma mensagem enviada enquanto o assistente está ocupado espera em uma fila mantida pelo servidor, então não se perde se você trocar de conversa ou recarregar. No mecanismo nativo, no Codex e no ACP, um turno interrompido por uma reinicialização do servidor retoma sozinho; um turno do Claude Code é encerrado com um erro visível e a sua próxima mensagem retoma a conversa.

Por conta própria

Um plano pode rodar quando ninguém está por perto. Ele começa em um horário programado ou quando um evento acontece, com uma pausa entre dois inícios. Os tipos de início são schedule, webhook, event e chat.

Memória

O PO lembra o que você decide e aprende

Notas, decisões e as ligações entre elas ficam associadas ao seu projeto. O PO as reencontra quando são úteis. Role a página para ver uma memória crescer.

  1. 1

    Seus arquivos viram pontos

    O PO parte do que está no projeto: documentos, planilhas, arquivos. Cada um é um ponto azul.

  2. 2

    Planos e tarefas entram no quadro

    Planos e tarefas são adicionados à mesma imagem. Cada tarefa é ligada aos arquivos em que mexe.

  3. 3

    Notas e decisões continuam ligadas

    O que você aprende vira uma nota. O que você decide vira uma decisão. As duas continuam ligadas aos arquivos e entre si.

  4. 4

    Itens sobre o mesmo assunto ficam próximos. Você vê os principais temas do projeto de relance.

  5. 5

    Você faz uma pergunta. O PO encontra as notas correspondentes (ciano). Depois segue as ligações até itens relacionados (violeta), mesmo quando as palavras são diferentes.

Memória

Exemplo inventado: um pequeno projeto de evento. Os nomes no grafo são ilustrações, não os seus dados. As cores e as formas são as do grafo do produto.

Por baixo dos panos: os nomes das ligações

Estes são os nomes que o produto usa para as ligações do seu grafo. Você não precisa deles para usar o PO.

  • CONTAINSUm plano contém suas tarefas.
  • IMPORTSUm arquivo usa outro arquivo.
  • AFFECTSUma tarefa mexe em um arquivo.
  • CO_CHANGEDDois arquivos que mudam juntos com frequência, vistos no histórico do código.
  • SYNAPSEUma ligação entre notas, decisões e arquivos. As ligações que ninguém usa se apagam.

Experimente

Veja um assistente trabalhar com o PO

Escolha um pedido. Você vê a resposta em palavras simples e as chamadas que o assistente faz ao PO nos bastidores. Abra uma chamada para ver os detalhes.

Chat · team-weekendDemonstração simulada
Organize a weekend in June for my team of 12. We want a quiet place near a train station.

Two notes apply: the place must be close to a train station, and last year the menu had nothing vegetarian. I will write the plan around both.

The plan has 3 tasks in 2 waves. The shortlist and the date poll do not depend on each other, so they happen at the same time. Booking waits for both.

Respostas roteirizadas. Nenhum servidor é contatado.

Experimente: digite o seu próprio pedido, abra uma chamada para ver os detalhes e depois copie a conversa inteira.

Demonstração simulada: as respostas são roteirizadas e nenhum servidor é contatado. As chamadas e seus argumentos são os reais.

Primeiros passos

Dê memória e um plano aos seus assistentes

Instale o orchestrator, conecte o seu assistente por MCP e deixe o seu primeiro agente ler o projeto antes de escrever uma linha.

O aplicativo é gratuito. Você paga apenas pela IA que já usa, como a sua própria assinatura do Claude Code ou uma chave para outro modelo. Veja quanto custa

Ou comece pelo terminal

brew install this-rs/tap/project-orchestrator