/pp:construir — Agentes Power Apps Canvas e Power Automate

Etapa 7 do pipeline, bloco 3. Construção na Power Platform. Cada sessão constrói uma onda do GOAL.md: os dois agentes trabalham em paralelo, você confere a integração e o usuário cola no ambiente. A etapa só fecha quando a última onda fecha.

KIT = ${CLAUDE_PLUGIN_ROOT}. Formato de saída: KIT/skills/power-platform/references/formato-saida.md. Script de estado: python "${CLAUDE_PLUGIN_ROOT}/skills/power-platform/scripts/estado.py". Modelos: python "${CLAUDE_PLUGIN_ROOT}/skills/power-platform/scripts/modelos.py". Fila e evidência: KIT/skills/power-platform/references/modo-goal-fila.md.

Antes de começar

1. estado.py comecar construir. Exit 1: mostre a saída e pare.
2. Quem trabalha: $ARGUMENTS = app (só Canvas), flows (só Power Automate) ou vazio (os dois).
3. Portão do ambiente. Leia power-platform.config.json (nomes_as_built) e abra o NOMES-AS-BUILT. Ausente, vazio ou sem as tabelas que a onda usa: checkpoint Ação no ambiente com a onda 0 do GOAL.md (o que criar, quem cria, como capturar os nomes) e pare. Escrever tela sobre nome chutado é a causa nº 1 de retrabalho.
4. O que construir:
   • etapa reaberta com docs/qa/correcoes.md: só os itens abertos da camada pedida (modo correção);
   • senão, a primeira onda do GOAL.md com tarefa 🟢 não feita e onda anterior com portão fechado. Mostre a onda: tarefas, telas e fluxos.
5. Contrato fechado? Cada fluxo da onda tem em arquitetura.md os parâmetros (posicionais, texto) e o retorno {status, description, id, url}. Faltou: escreva agora, antes dos agentes.

Passos

1. Divida a onda pelos arquivos (coluna Arquivos do GOAL.md), sem dois agentes no mesmo arquivo:
   • telas em grupos de até 3, um pp:agente-canvas por grupo. Os tokens (App.Formulas, App.OnStart, só na primeira onda) são de um agente só, o que recebe TOKENS: sim;
   • fluxos em grupos de até 3, um pp:agente-automate por grupo;
   • correção: itens app para o Canvas; itens flows de fluxo para o Automate e de procedure para o pp:agente-sql (CORRECOES);
   • no máximo 5 agentes por mensagem; o que sobrar vai numa segunda leva, depois do julgamento da primeira. Onda pequena (até 3 telas e 3 fluxos): um de cada.
2. Agentes em paralelo, na mesma mensagem:

   ◆ Chamando 3 agentes em paralelo...
     → Agente Power Apps Canvas #1: Inicio, Pedidos, Detalhe
     → Agente Power Apps Canvas #2: Cadastro, Relatório
     → Agente Power Automate: fluxos da onda <n>

   • pp:agente-canvas com RAIZ, KIT (o valor de ${CLAUDE_PLUGIN_ROOT}), TELAS (as tarefas de tela do grupo) e TOKENS (sim ou não), ou CORRECOES (itens app);
   • pp:agente-automate com RAIZ, KIT, FLUXOS (as tarefas de fluxo do grupo) ou CORRECOES (itens flows de fluxo);
   • pp:agente-sql com RAIZ, KIT e CORRECOES (itens flows de procedure), só em correção. O modelo de cada um: modelos.py de <agente> (linha vazia: não passe model).
3. Julgue as entregas e a integração app ↔ automações (você mesmo, não um agente; KIT/skills/power-platform/references/subagentes.md, "Julgar a entrega"):
   • python "${CLAUDE_PLUGIN_ROOT}/skills/powerapps-canvas/scripts/validar-telas.py" e python "${CLAUDE_PLUGIN_ROOT}/skills/power-automate/scripts/verificar-fluxo.py", da raiz: 0 erro(s) e arquivos lidos > 0 (correção de procedure: também python "${CLAUDE_PLUGIN_ROOT}/skills/sql-procedures/scripts/lint-procedure.py");
   • cada .Run( nas telas tem o número e a ordem de parâmetros do contrato (grep -n "\.Run(" <pasta-telas>);
   • cada tela trata o retorno: .Run() dentro de IfError, sucesso = status <> "error", toast com description, Refresh depois de gravar;
   • nomes de tabela e coluna das telas e dos fluxos existem no NOMES-AS-BUILT (grep -n "<nome>" <NOMES-AS-BUILT>). O que falhar volta ao agente da camada como revisão (o item, o arquivo, a saída). Um veredito por agente (--agente agente-canvas#1, agente-automate...): estado.py veredito construir --agente <nome> --resultado <...>.
4. Colar no ambiente (checkpoint Ação no ambiente, 🔴). Junte as instruções dos dois agentes num passo a passo só, nesta ordem:
   1. fluxos primeiro: criar o gatilho à mão com os parâmetros na ordem, colar o escopo, religar as conexões, salvar e testar com o dado de teste;
   2. tokens fx* no App.Formulas (só na primeira onda);
   3. telas: selecionar a tela, Colar código, adicionar o fluxo ao app, rodar. "Digite 'feito' ou cole a mensagem de erro."
5. Erro na colagem: diagnostique com a skill da camada (powerapps-canvas ou power-automate) e devolva ao agente da camada como revisão, com a mensagem exata do Studio ou do designer e a linha do arquivo; você não edita a tela nem o fluxo. Mensagem que a skill da camada não explica: antes, pp:agente-pesquisa com a mensagem exata (ONDE: os dois, PARA QUE: corrigir a colagem; modelo: modelos.py de agente-pesquisa), e os achados vão junto na revisão. Depois repita o passo 4. Duas falhas pela mesma causa: escalado (pare, registre no GOAL.md e diga ao usuário o que foi tentado).
6. Atualize a fila: cada tarefa da onda vira ✅ com evidência (comando + última linha do validador + "colado em <data>"). Correção: marque o item como feito em docs/qa/correcoes.md.

Portão de saída da onda

• Validadores das duas camadas com 0 erro(s), arquivos lidos > 0.
• Contrato conferido: parâmetros, retorno e nomes reais.
• Usuário colou e testou sem erro; evidência na coluna do GOAL.md.

Encerrar

• Ainda há onda pela frente: não conclua a etapa. Mostre o progresso da fila (ondas feitas / total) e rode estado.py proximo: ele aponta /pp:construir de novo, numa sessão nova.
• Última onda ou correção terminada: estado.py concluir construir --nota "<N> ondas; <telas> telas, <fluxos> fluxos".
• Commit se git_commit_por_etapa: pp(construir): onda <n> (ou correções <app|flows>).
• Resumo e o bloco "Próximo passo" que o script imprimiu.