pp

Use quando o protótipo do app Power Apps foi aprovado e é hora da etapa 6 do pipeline: decidir com o usuário a trilha de dados (Dataverse ou SQL Server) e chamar o Agente de Arquitetura, que escreve o modelo de dados, as permissões, as integrações, o contrato app↔flow, os scripts de dados e a fila de construção GOAL.md. Não use antes de o protótipo ser aprovado, nem para uma procedure ou tabela isolada (use `sql-procedures` ou `dataverse`).

Use quando o projeto Power Apps já foi iniciado com /pp:novo e é hora da etapa 2 do pipeline: o Agente Brainstorm conversa com o usuário e fecha os requisitos, as funcionalidades e o escopo do MVP no prd.md. Oferece quatro modos, cada um conduzido por uma persona: entrevista guiada, foco nas pessoas (design thinking), foco no problema (causa raiz) e mesa redonda (várias personas debatem). Retoma de onde parou se a sessão anterior foi interrompida. Não use antes do /pp:novo, nem para mudar requisito de um projeto já em construção (descreva a mudança ao orquestrador `power-platform`).

Use quando a arquitetura do app Power Apps está pronta e o ambiente tem o NOMES-AS-BUILT preenchido, para a etapa 7 do pipeline: constrói a próxima onda do GOAL.md com o Agente Power Apps Canvas (telas, componentes, Power Fx) e o Agente Power Automate (fluxos, aprovações, notificações, erros) em paralelo, confere a integração app↔flow e guia a colagem no ambiente. Com `app` ou `flows`, roda só um agente (correção vinda dos testes). Não use antes do /pp:arquitetura, nem para um ajuste pontual fora do pipeline (use `powerapps-canvas` ou `power-automate`).

Use quando o app Power Apps ou o flow lê ou grava em tabelas Dataverse: escrever ou corrigir fórmula que filtra, ordena, compara ou grava coluna Dataverse; descobrir o nome certo de tabela ou coluna (lógico, de exibição, de schema, prefixo do publisher); decidir Choice, Lookup ou texto; montar ou atualizar o NOMES-AS-BUILT; delegação no conector Dataverse (o que delega, 500/2.000); desenhar security role, business unit, owner team ou segurança de coluna; modelar tabela, relacionamento, alternate key ou coluna calculada; importar CSV ou Excel. Termos: "qual o nome da coluna", "Choice ou texto", "usuário vê todas as unidades", "importar planilha". Não use para YAML de tela, Power Fx fora de Dataverse, combo e UX (use `powerapps-canvas`), flow, `$batch` e HTTP (use `power-automate`), procedure e SQL Server (use `sql-procedures`), soluções, ambientes e connection references (use `power-platform`).

Use quando o MVP do app Power Apps já está no prd.md e é hora da etapa 3 do pipeline: o Agente Designer Branding define com o usuário cores, fontes, navegação (menu lateral fixo, recolhível ou gaveta, barra no topo ou tela inicial com cartões), componentes e identidade visual (ux-design-system.md + amostra visual). Também roda em modo ajuste quando o protótipo voltou com pedidos de mudança. Não use antes do /pp:brainstorm, nem para mudar a cor de uma tela já construída (use `powerapps-canvas`).

Use quando os testes do app Power Apps foram aprovados e é hora da etapa 9 do pipeline: levar o app ao ambiente de homologação, gerar o roteiro de UAT por perfil e registrar o aceite dos usuários reais (quem e quando). Reprovado, devolve a correção para a construção. Não use antes do /pp:testar aprovar, nem para promover para produção (use `/pp:publicar`).

Use quando a identidade visual do app Power Apps está aprovada e é hora da etapa 4 do pipeline: o Agente de Mockups em Imagem elenca todas as telas, a navegação, o loading, os erros e os estados vazios, e, com a autorização do usuário, o script gera uma imagem por tela pela API da OpenAI. Também refaz só as telas afetadas quando o protótipo voltou com ajuste. Não use antes do /pp:design, nem para desenhar uma tela em YAML (use `powerapps-canvas`).

Use quando o app Power Apps já foi publicado pelo pipeline (ou já tem power-platform.config.json do kit) e o usuário traz uma lista de mudanças: corrigir, ajustar, acrescentar campo, tela ou regra. Escopa cada pedido, junta o contexto com agentes de pesquisa, escreve um spec por frente, manda os agentes de construção em paralelo, julga cada entrega (aceito, revisão, escalado), roda o QA da mudança e reabre a homologação. Não use com o pipeline no meio (as voltas do protótipo e dos testes cuidam disso), em app sem o kit (descreva ao orquestrador `power-platform`) nem para mudança que refaz o MVP (reabra o pipeline no brainstorm).

Use quando for começar um app Power Apps novo do zero: etapa 1 do pipeline do kit (Orquestrador). Recebe a ideia, cria a pasta do projeto, o git, o power-platform.config.json, o 00-LEIA-PRIMEIRO.md e o ESTADO.md, e aponta o próximo comando. Não use para app que já existe (descreva o problema e o orquestrador `power-platform` escolhe o caminho) nem para continuar um projeto já iniciado (use `/pp:progresso`).

Use quando o trabalho envolver flow do Power Automate: desenhar ou revisar um flow chamado pelo app (trigger Power Apps V2, Response de 4 campos, Try/Catch, Switch por ação), cola esse flow no designer (clipboard, escopo colável, allConnectionData), autorização e escopo por unidade dentro do flow, chamar procedure SQL (Execute stored procedure), receber lote de sistema externo por HTTP com token, gravar no Dataverse por $batch/upsert, escopo de log, expressão que estoura em execução (if não curto-circuita, string(null), outputs de Select), contrato tela-flow-procedure, ou verificar um JSON de flow. Não use para a chamada .Run() do lado do app (use `powerapps-canvas`), a procedure e o DDL (use `sql-procedures`), tabelas e Security Role (use `dataverse`), nem ambientes, soluções e connection references em geral (use `power-platform`).

Use quando a tarefa de um projeto Power Platform (Power Apps Canvas, Power Automate, SQL Server, Dataverse) pedir método ou tocar mais de uma camada: começar um app novo, "quero criar um app", ideia de app, "onde parei", "qual o próximo passo", pipeline /pp, feature de ponta a ponta (tela + flow + banco), "o número não bate", "usuário de uma unidade vê dado de outra", "está lento", auditar o app inteiro, fila GOAL.md, subagentes em paralelo, promover DEV/HML/PRD (solução, variável de ambiente, pac CLI) ou "está pronto?". Coordena o pipeline guiado de app novo (/pp:novo até /pp:publicar, uma sessão por etapa, ESTADO.md; depois, /pp:mudanca) e, em app existente, roteia para a skill de domínio e fecha com validadores e evidência. Não use para pergunta pontual de fórmula ou ajuste de uma tela (use `powerapps-canvas`), flow isolado (use `power-automate`), procedure ou DDL isolados (use `sql-procedures`) nem modelagem de tabela (use `dataverse`).

Use quando o trabalho for Power Apps Canvas: criar ou alterar tela, galeria, modal, toast, loading, filtro, aba ou formulário; escrever ou corrigir fórmula Power Fx; gerar ou revisar YAML .pa.yaml para colar no Studio ("não cola", PA2108, `;` ou `;;`); combo/ComboBox que não acha o valor (SearchFields, DisplayFields); delegação no conector SQL ("a galeria vem vazia", "o contador mostra 2.000", CountRows, filtro de data); timers, auto-refresh e debounce; a chamada .Run() de um flow do lado do app (loading, IfError, toast); tokens fx*, nomenclatura, acessibilidade e escopo por perfil e unidade na tela. Não use para divergência entre KPI e galeria sem causa óbvia (use `power-platform`), definição do flow, Try/Catch e HTTP (use `power-automate`), procedure, DDL e coluna calculada (use `sql-procedures`), tabelas, Choice, Security Role e delegação no Dataverse (use `dataverse`), ALM, Power BI, model-driven ou Power Pages.

Use quando quiser saber onde um projeto Power Apps do kit está e qual comando rodar agora: mostra o painel do ESTADO.md (etapas feitas, em andamento e pendentes), a fila de construção, as pendências com prazo vencido e o próximo passo. Também explica o pipeline para quem ainda não começou. Não use para executar uma etapa (rode o comando que ele indicar).

Use quando o inventário de telas e os mockups do app Power Apps estão prontos e é hora da etapa 5 do pipeline: o Agente Gerador de Mockup HTML monta um protótipo navegável (um index.html que abre offline) em cima dos mockups, e o usuário aprova ou pede ajuste. Aprovado, o pipeline segue para a arquitetura; com ajuste, volta para o /pp:design. Não use antes do /pp:mockups, nem para construir a tela real (use `/pp:construir`).

Use quando a homologação do app Power Apps foi aprovada e é hora da etapa 10, a última do pipeline: checklist de go-live, documentação (manual do usuário por perfil, guia técnico) e a publicação em produção guiada passo a passo, com teste de fumaça. Não use antes do /pp:homologar aprovar, nem para mover uma correção pontual entre ambientes (descreva ao orquestrador `power-platform`).

Use quando o trabalho for o backend SQL Server de um app Power Apps: escrever, revisar ou corrigir procedure chamada pelo Power Automate ("Table1 vem vazio", NOCOUNT, XACT_ABORT, retorno status/description/id/url, código de resultado), modelo de dados (prefixos Id_/Flg_/Dt_, flags de perfil, chaves, collation), coluna calculada para delegação ("filtro de data não delega", "CountRows não delega", Ref_DtInclusao), escopo por unidade com @Filtros JSON, pacote e pedido de DDL ao DBA (banco congelado, provas de ambiente), GRANT EXECUTE da conta do conector ou migração de dados de legado para SQL Server. Não use para Power Fx, tela ou delegação do lado do app (use `powerapps-canvas`), flow, Try/Catch ou autorização no flow (use `power-automate`), Dataverse (use `dataverse`) nem arquitetura e protocolo de trabalho (use `power-platform`).

Use quando todas as ondas do GOAL.md foram construídas e coladas e é hora da etapa 8 do pipeline: o Agente de Testes e Qualidade roda os validadores, confere o contrato e monta o roteiro de testes no ambiente (negação por perfil e unidade, ciclo completo no dado). Aprovado, segue para a homologação; com falha, devolve a correção para o app ou para as automações. Não use antes do /pp:construir, nem para investigar um número que não bate (descreva ao orquestrador `power-platform`).