Orquestrador de Demonstração de Restaurante

O que Orquestrador de Demonstração de Restaurante faz?

Execute uma ordem de serviço retomável, desde a captura do lead até uma demonstração privada verificada localmente. Trate este Skill e o agente principal como o plano de controle; use três agentes de trabalho limitados e os quatro Skills especialistas como planos de execução.

Leia referências/contrato-de-orquestração.md antes de alterar o modelo de estágio, tipos de artefatos ou regras de transição.

Iniciar ou Retomar uma Ordem de Serviço

1. Leia o contexto do projeto e inspecione os dados locais do lead antes de navegar.
2. Inicialize a ordem de serviço com scripts/workflow.py init. Semeie a linha da planilha, ID do Local, URL do Maps e o instantâneo do lead local quando disponível.
3. Execute scripts/workflow.py resume para obter cada estágio ativo ou pronto para dependência, sua faixa de trabalho, Skill atribuído, artefatos esperados e prompt específico do estágio.
4. Complete a captura, pesquisa, bloqueio de design e slots de imagem no agente principal antes da ramificação.
5. Crie um trabalhador de design, um trabalhador de comida e um trabalhador de exterior quando os subagentes estiverem disponíveis. Inicie as três faixas prontas para dependência juntas; cada trabalhador registra artefatos reais e marca apenas seus estágios atribuídos como passed, blocked ou—apenas para uma ramificação opcional—skipped com um motivo.
6. Junte todos os trabalhadores. O agente principal executa a validação do contrato, integra suas saídas, resolve conflitos, realiza o QA final e registra a demonstração privada.
7. Execute scripts/workflow.py validate após as transições. Use --run-contracts após os manifestos de paleta, comida ou exterior passarem.
8. Repita até que private_demo passe ou a evidência crie um bloqueio genuíno. Se os subagentes não estiverem disponíveis, execute as mesmas faixas sequencialmente e registre o fallback nas notas do estágio.

Não peça ao usuário para invocar cada Skill separadamente. Quando o usuário disser para construir, executar, continuar ou retomar a Demonstração, continue por todos os estágios desbloqueados na mesma tarefa. Forneça atualizações concisas de progresso ao alternar entre Skills especialistas.

Preservar os Limites dos Especialistas

Use o Skill atribuído em vez de reproduzir seu trabalho dentro do orquestrador:

• pesquisa, bloqueio_de_design, slots_de_imagem, design_do_site, implementação e qa: $restaurant-demo-builder
• paleta_de_marca: $restaurant-brand-palette
• imagens_de_comida: $restaurant-food-image-studio
• imagem_exterior: $restaurant-exterior-image-studio
• captura e demonstração_privada: este Skill

Antes de despachar um estágio especialista, o agente principal deve ler esse Skill completamente. Cada trabalhador também deve ler seu Skill atribuído e seguir suas evidências e portões de validação. Um estágio só pode passar quando seus artefatos necessários existem. Um status de manifesto especialista registrado pelo fluxo de trabalho nunca substitui o validador especialista.

Contrato de Agentes Paralelos

Use no máximo três agentes de trabalho nestas faixas isoladas:

• design: execute paleta_de_marca, depois crie o shell responsivo design_do_site com placeholders de imagem definidos pelo contrato. Escreva arquivos de paleta/bloqueio/handoff e o shell do site; não integre as saídas de imagem do trabalhador nem realize o QA final.
• comida: execute imagens_de_comida. Escreva apenas a ordem de serviço e o manifesto do Food Image Studio; não edite o shell do site ou a Demonstração final.
• exterior: execute imagem_exterior. Escreva apenas a ordem de serviço e o manifesto do Exterior Image Studio; não edite o shell do site ou a Demonstração final.

O agente principal é dono da captura, pesquisa, bloqueios compartilhados por todas as faixas, implementação final, QA, operações de repositório, decisões de publicação e o handoff ao usuário. Apenas o agente principal pode copiar ativos selecionados do trabalhador para a Demonstração final, reconciliar conflitos de cópia/layout/ativos ou declarar a Demonstração pronta.

Os trabalhadores podem atualizar seus próprios estágios do fluxo de trabalho através de workflow.py set-stage; a ferramenta de estado serializa escritas concorrentes. Um trabalhador não deve editar arquivos ou status de outra faixa. Ao finalizar o trabalhador, inspecione os artefatos reais e execute validadores em vez de confiar apenas na mensagem.

Regras de Estágio

Siga esta ordem:

captura
  -> pesquisa
  -> bloqueio_de_design
  -> slots_de_imagem
  -> [design: paleta_de_marca -> design_do_site]
     [comida: imagens_de_comida]                 (paralelo)
     [exterior: imagem_exterior]
  -> implementação pelo agente principal
  -> qa
  -> demonstração_privada

imagens_de_comida e imagem_exterior são ramificações de decisão, não omissões silenciosas. Passe-as quando ativos qualificados forem produzidos; pule-as com um motivo baseado em evidências quando a página permanecer focada em texto ou um exterior não agregar valor de chegada. Nunca pule paleta_de_marca; use seu fallback explícito de Receita rotulada quando a evidência do restaurante não puder sustentar uma paleta derivada da marca.

Use apenas estes status. Até três estágios de trabalhador independentes de dependência podem estar in_progress, mas apenas um por faixa de trabalhador; um estágio do agente principal nunca se sobrepõe a um estágio de trabalhador:

• pendente: não iniciado
• em_andamento: executando ativamente; apenas um estágio por vez
• aprovado: dependências, artefatos e validadores relevantes passam
• bloqueado: não pode prosseguir; registre um bloqueador concreto
• pulado: ramificação opcional deliberadamente omitida; registre o motivo

Nunca marque trabalho incompleto como aprovado para avançar o fluxo de trabalho. Reabra um estágio terminal com --reopen quando sua evidência ou saída mudar.

Comandos

Substitua <skill-do-orquestrador> pela pasta deste skill instalado. Execute os comandos da ordem de serviço a partir do diretório do seu projeto de restaurante.

Inicializar:

python3 <skill-do-orquestrador>/scripts/workflow.py init \
  --project-root . \
  --restaurant "Nome do Restaurante" \
  --slug nome-do-restaurante \
  --place-id "PLACE_ID" \
  --maps-url "GOOGLE_MAPS_URL" \
  --lead-json output/leads.json \
  --source-sheet-id "SHEET_ID" \
  --source-sheet-title "Título da planilha" \
  --source-tab Sheet1 \
  --source-row 28 \
  --sheet-checked-at 2026-07-13

Inspecionar e retomar; resume pode retornar vários estágios acionáveis após a ramificação:

python3 <skill-do-orquestrador>/scripts/workflow.py status \
  --workflow orquestração/nome-do-restaurante/workflow.json

python3 <skill-do-orquestrador>/scripts/workflow.py resume \
  --workflow orquestração/nome-do-restaurante/workflow.json

Registrar um estágio:

python3 <skill-do-orquestrador>/scripts/workflow.py set-stage \
  --workflow orquestração/nome-do-restaurante/workflow.json \
  --stage pesquisa --status aprovado \
  --artifact registro_de_pesquisa=orquestração/nome-do-restaurante/pesquisa/PESQUISA.md \
  --artifact perfil_do_restaurante=orquestração/nome-do-restaurante/pesquisa/perfil-do-restaurante.json

Validar:

python3 <skill-do-orquestrador>/scripts/workflow.py validate \
  --workflow orquestração/nome-do-restaurante/workflow.json --run-contracts

Salvaguardas

• Mantenha toda nova ordem de serviço como privada-local por padrão.
• Não adicione comandos automáticos de deploy, upload, email, Messenger ou divulgação.
• Mantenha fatos verificados, fatos de instantâneo, inferências, decisões criativas e perguntas em aberto distintos.
• Reverifique horários atuais, cardápio, avaliação, contagem de avaliações, status do site, serviços e links de contato antes de usá-los na página.
• Não coloque segredos, arquivos de conta de serviço, tokens ou credenciais privadas em uma ordem de serviço.
• Pare em demonstração_privada; publicação e divulgação exigem autorização explícita separada do usuário.

Handoff

Informe o caminho da ordem de serviço, estágio atual, caminho ou URL da Demonstração local quando disponível, resultados de validação, bloqueadores, itens de confirmação do proprietário e lacunas de autorização para publicação. Declare explicitamente que nenhuma publicação ou divulgação ocorreu, a menos que autorizado separadamente.