Uma mudança que atravessa dois projetos

O cenário

A loja-api define o frete grátis a partir de R$ 200, em src/frete.cjs. O portal-web mostra essa regra num banner, em src/banner.js. Quando a regra muda na API, o texto do site precisa acompanhar.

Você vai montar um fluxo que começa num projeto e continua no outro:

1. Na loja-api, o Claude Code lê src/frete.cjs e escreve a regra em CONTRATO.md, em linguagem de front-end.
2. No portal-web, o Codex lê esse contrato e atualiza o texto do banner. Ele começa sozinho quando a primeira etapa fica pronta.

Cada etapa pode usar seu próprio agente e seu próprio modelo. Aqui, a tarefa do portal é trocar um texto, então um modelo menor resolve.

Veja no vídeo

VÍDEO 06 · 1:00

Entre projetos. Uma etapa da API ligada a uma etapa do portal, cada uma com seu agente e seu modelo. Legendas e transcrição ↗

Antes de começar

• Cadastre os dois projetos (C:\demo\loja-api e C:\demo\portal-web). Com um projeto só, a opção Outro projeto da Nova etapa fica desabilitada, com a explicação Só há um projeto aberto.
• Confira que os dois agentes funcionam em cada pasta (abra cada CLI uma vez e aceite a confiança na pasta, se ela perguntar).

Passo a passo

Na loja-api

1. Selecione loja-api e clique em + Nova etapa, com Executa: Claude Code.

2. Tarefa:

   Leia src/frete.cjs e grave em CONTRATO.md, em até cinco linhas, a regra do frete grátis para o front-end.

3. Se quiser fixar o modelo desta etapa, abra Mais opções → Opções de etapa → Modelo e permissões (opcional) e preencha Modelo com um identificador disponível na sua conta. Vazio, vale o padrão da CLI.
4. Em Ao criar, escolha Só planejar e confirme. A etapa aparece planejada no Fluxo.

Continuar no portal-web

1. No Fluxo da loja-api, abra Outras ações e escolha Continuar em outro projeto….
2. Em Projeto de destino, escolha portal-web, confira a Etapa de origem e confirme em Planejar no destino.

Ampliar captura ↗

1. No portal-web, a Nova etapa recebe a etapa de destino. Escolha Executa: Codex CLI e, em Mais opções → Opções de etapa, o modelo se quiser.

2. Tarefa:

   Leia ../loja-api/CONTRATO.md e atualize o texto de src/banner.js com essa regra.

3. Adicione ao planejamento. No Fluxo do portal-web, a etapa mostra o selo Aguardando origem · loja-api.

Ampliar captura ↗

Executar

1. Volte para a loja-api e clique em Executar fluxo.
2. O Claude Code grava o CONTRATO.md. Quando a etapa fica pronta, o selo do portal muda para Origem concluída · loja-api e o Codex começa no portal-web.
3. Selecione o portal-web para ver o Codex editando src/banner.js. A etapa aparece concluída no Fluxo do portal.

Enquanto isso, se o agente do portal pedir permissão e você estiver olhando a loja-api, a Atenção mostra no fim da lista Em outro projeto: portal-web aguarda permissão. Um clique leva ao terminal que pediu. Veja Atenção.

O que conferir

• CONTRATO.md na loja-api descreve a regra certa (R$ 200, quando vale).
• git diff no portal-web mostra só o texto do banner alterado.
• O site reflete o contrato, e não o que o agente imaginou: compare os dois arquivos.

Dicas

• O caminho ../loja-api/CONTRATO.md funciona porque as duas pastas são irmãs em C:\demo. Se os seus projetos estão em lugares diferentes, use o caminho completo na instrução.
• Algumas CLIs, com a sandbox restrita, não leem arquivos fora da pasta do projeto. Nesse caso, peça à primeira etapa para gravar o contrato também dentro do portal-web, ou cole a regra na própria instrução.
• Dê nome claro ao arquivo de contrato e mantenha-o no repositório da API: ele vira documentação para a próxima mudança.
• Um fluxo por objetivo. Se você está corrigindo outra coisa na loja-api ao mesmo tempo, mantenha os dois fluxos separados e troque entre eles pelo seletor de fluxos.

Limites

• A etapa de destino depende da etapa de origem: fechar ou esconder o projeto de origem não aprova nada. Se a origem falhar, o destino continua esperando.
• O avanço automático entre etapas acontece com a janela do PrumoGrid aberta. Se você fechar a janela no meio, os terminais continuam, mas a próxima etapa só é entregue quando você reabrir.