Power Platform Kit

Como funciona

Você não precisa conhecer o método.

O kit carrega o método por você. Quatro ideias deixam o caminho fácil, mesmo para quem nunca fez um levantamento de requisitos nem um Power App.

Um comando por etapa

Dez etapas, de /pp:novo a /pp:publicar. Cada uma confere se a anterior terminou. Rodou fora de ordem? Ela diz qual rodar no lugar.

Uma sessão nova por etapa

Tudo o que uma etapa produz fica gravado em disco, então a próxima começa com o contexto limpo. Toda etapa termina com o bloco Próximo passo: o comando e o lembrete de digitar /clear antes.

Você só para onde precisa de gente

Aprovar o MVP, a identidade e o protótipo; criar tabelas, colar telas e fluxos, homologar e publicar. O resto é produzido e validado para você.

Quem pensa não é quem executa

A sessão define o pedido e julga; os agentes escrevem e provam o que fizeram. Cada entrega recebe um veredito (aceito, revisão ou levada a você) antes de chegar até você.

Perdeu o fio? /pp:progresso mostra a qualquer momento onde o projeto está e o próximo comando. O estado fica no ESTADO.md, na raiz do projeto.

As etapas

Dez etapas, quatro blocos.

Abra o Claude Code numa pasta vazia e digite /pp:novo seguido da sua ideia. Depois, siga o bloco Próximo passo no fim de cada etapa. 🔴 pessoa marca o que só alguém no ambiente pode fazer; o Claude mostra um passo a passo numerado e espera.

Início

Orquestrador

/pp:novoProjeto novoOrquestrador

Conte a ideia do jeito que tiver (frase, lista, print); escolha pasta, commits e modelos numa rodada.

power-platform.config.json ideia-bruta.md ESTADO.md, repositório git

1 · Definição do produto

conversa com você

/pp:brainstormBrainstorm e requisitosAgente Brainstorm

Escolha um dos quatro modos, responda às perguntas e decida o que entra no MVP.

brainstorm.md prd.md com o escopo do MVP

2 · Identidade e experiência

volta até aprovar

/pp:designIdentidade visualAgente Designer Branding

Escolha cores, estilo, fonte e o jeito de navegar (menu lateral, barra no topo ou tela inicial com cartões); aprove uma amostra visual com o contraste conferido.

ux-design-system.md identidade.html

/pp:mockupsMockups em imagempp:agente-mockups + script

Confira a lista de telas (navegação, carregamento, erros, estados vazios); autorize as imagens ou pule.

inventario-telas.md mockups/*.png

/pp:prototipoProtótipo navegávelpp:agente-prototipo

Navegue pelo protótipo HTML; aprove ou peça ajustes.

prototipo/index.html, conferido pelo verificar-prototipo.py

3 · Construção na Power Platform

Canvas ∥ Automate ∥ SQL

/pp:arquiteturaArquiteturapp:agente-arquitetura + pp:agente-sql ∥🔴 pessoa

Escolha SQL Server ou Dataverse com a matriz de decisão; crie as tabelas no ambiente.

arquitetura.md ADR, DDL e procedures (ou modelo Dataverse), ondas no GOAL.md

/pp:construirConstrução, uma onda por sessãopp:agente-canvas ∥ pp:agente-automate, por grupo🔴 pessoa

Cole as telas e os fluxos gerados no Power Apps Studio e no Power Automate.

telas .pa.yaml, JSON dos fluxos, ambos validados

4 · Validação e entrega

volta até ficar verde

/pp:testarTestes e qualidadepp:agente-qa🔴 pessoa

Rode o roteiro de teste no ambiente e conte o que falhou.

docs/qa/QA-<data>.md

/pp:homologarHomologaçãoOrquestrador, com você🔴 pessoa

Faça a homologação com usuários reais e colete o aceite.

docs/qa/UAT-<data>.md

/pp:publicarPublicação e documentaçãoOrquestrador🔴 pessoa

Publique em produção e rode o teste de fumaça.

manual do usuário, guia técnico, checklist de go-live, tag v1.0.0

Protótipo não aprovado

Os pedidos de ajuste vão para ajustes-prototipo.md e o próximo passo é /pp:design de novo. Mockups e protótipo refazem só o que mudou.

Teste ou homologação falhou

Cada falha vai para correcoes.md, marcada como app ou fluxos. O próximo passo é /pp:construir app ou /pp:construir flows, e depois o teste de novo.

Parou no meio?

Rode o mesmo comando de novo. A etapa retoma do que está em disco, e o /pp:progresso sempre sabe onde você está.

Depois de publicado

Mande a lista de mudanças com /pp:mudanca. Cada pedido vira um spec, os agentes fazem em paralelo, o QA roda e a homologação reabre para uma versão nova.

Brainstorm

Quatro jeitos de pensar, um PRD no fim.

A etapa 2 começa perguntando como você quer pensar. Cada modo é conduzido por uma persona e só muda o começo da conversa. Os quatro fecham do mesmo jeito: corte do MVP, regras de negócio, bloqueadores, volumes e prd.md.

🧠

Facilitador

Entrevista guiada

Escolha quando você já sabe o que quer e precisa de ajuda para fechar.

uma pergunta por vezperfis × ações

🎨

Designer de experiência

Foco nas pessoas

Escolha quando o app muda o dia a dia de muita gente, em perfis diferentes.

mapa de empatiaum dia na vidaComo poderíamos…?

🔬

Investigador

Foco no problema

Escolha quando algo está quebrado (retrabalho, erro, atraso) e você quer a causa.

5 porquêsespinha de peixegargalobrainstorm reverso

🗣️

Facilitador modera

Mesa redonda

Escolha quando a ideia ainda está vaga e você quer ouvir vários pontos de vista.

2–3 personas por rodadauma pergunta para você

🧠

Facilitadormantém a sessão andando

🎨

Designer de experiênciaas pessoas que vão usar

🔬

Investigadora causa raiz

💼

Estrategista de negócioo valor e a métrica

👤

Usuário da pontacliques, celular, sem sinal

🛠️

Arquiteto Power Platformvolumes, licenças, limites

🛡️

Segurança e compliancedado, acesso, aprovações

😈

Advogado do diaboo que pode dar errado

As personas perguntam e propõem; quem decide é você. Dá para trocar de modo no meio sem perder nada. Inspiradas no módulo criativo e no party mode do BMAD Method.

Os agentes

Especialistas com o mínimo de ferramentas.

Subagente não consegue fazer perguntas a você, por isso os dois agentes que conversam rodam na própria sessão da etapa. A etapa que chama um subagente julga o trabalho dele antes de seguir.

Agente	Etapa	Roda como	Ferramentas
Brainstorm	`/pp:brainstorm`	sua sessão	conversa com você, na pele da persona do modo escolhido
Designer Branding	`/pp:design`	sua sessão	conversa com você; monta uma amostra visual
`pp:agente-mockups`	`/pp:mockups`	subagente	lê e escreve; sem shell, então não consegue chamar a API de imagens
`pp:agente-prototipo`	`/pp:prototipo`	subagente	lê, escreve, shell (verificador do protótipo)
`pp:agente-arquitetura`	`/pp:arquitetura`	subagente	lê, escreve, shell; escreve o spec das procedures, não o corpo
`pp:agente-sql`	`/pp:arquitetura`	subagente ∥	lê, escreve, shell (`lint-procedure.py`); um por grupo de procedures
`pp:agente-canvas`	`/pp:construir`	subagente ∥	lê, escreve, shell (`validar-telas.py`)
`pp:agente-automate`	`/pp:construir`	subagente ∥	lê, escreve, shell (`verificar-fluxo.py`)
`pp:agente-qa`	`/pp:testar`	subagente	só lê, mais shell para os validadores
`pp:agente-pesquisa`	quando falta um fato	subagente	só lê, mais busca na documentação oficial; nada do projeto vai para a web

Quem pensa e quem executa

A sessão de cada etapa é a cabeça: escreve o pedido de cada agente, roda o validador de novo e dá um veredito por entrega: aceito, revisão (o mesmo agente, com um pedido mais preciso, no máximo duas) ou escalado (vem para você). Antes de mostrar a amostra do design ou o protótipo, o Claude fotografa as telas e olha. Como pensar e julgar é a parte pequena do trabalho, a cabeça pode usar um modelo mais forte e as mãos um mais rápido. Você escolhe o perfil no /pp:novo.

Perfil	Sessão de cada etapa	Arquitetura e QA	Telas, fluxos, SQL, protótipo	Pesquisa
Equilibrado recomendado	Opus	Opus	Sonnet	Sonnet
Máximo	Fable, se a conta tem (senão Opus)	Opus	Opus	Sonnet
Econômico	Sonnet	Sonnet	Sonnet	Haiku
Herdar	o modelo em que a sessão abrir	idem	idem	idem

App que já existe

Já tem um app? É só descrever o problema.

Fora do pipeline, o orquestrador power-platform leva o pedido em linguagem natural para o modo certo.

Você diz	O que o Claude faz
“O KPI não bate com a galeria”	Modo investigar. Percorre tela → fórmula → fonte → fluxo → procedure → dado, uma hipótese por vez, e prova a causa raiz antes de propor código.
“Um usuário vê dados de outra unidade”	Confere a camada que de fato bloqueia o acesso: fluxo + procedure no SQL, papéis de segurança no Dataverse. A tela só filtra.
“Audite o app inteiro”	Revisores em paralelo por disciplina (UX, desenvolvimento, performance, dados, fluxos, SQL) e nova conferência dos achados mais fortes.
“Coloque um filtro de status aqui”	Vai direto para o `powerapps-canvas`, sem o protocolo completo.
Uma lista de mudanças num app publicado pelo kit	`/pp:mudanca`: um spec por pedido, agentes em paralelo, julgamento, QA da mudança e a homologação reaberta.
“Promova para HML/PRD”	Soluções, variáveis de ambiente, connection references e o CLI `pac`; o que vai por colagem e o que vai por solução.
“Está pronto?”	Roda o portão final: todos os validadores que se aplicam, mais o checklist.

O que vem junto

Peças prontas para colar e validadores que rodam.

Cinco skills de domínio por trás dos comandos de etapa: power-platform, powerapps-canvas, power-automate, sql-procedures e dataverse.

Componentes Canvas

YAML pronto para colar, com as variáveis que cada um espera no OnStart.

menu lateral (fixo, recolhível ou gaveta), menu no topo, tela inicial com cartões
galeria em tabela, ordenação, paginação por cursor, card de KPI
modais, overlay de carregamento, toast, estado vazio, painel sem acesso

Blocos de Power Automate

JSON de área de transferência mais notas, com a ordem de montagem de cada tipo de fluxo.

identificar e autorizar quem chama, escopo por unidade
gravar via stored procedure, traduzir código e responder
upsert $batch no Dataverse, exportação CSV, log de execução

✓

Validadores executáveis

Python, só biblioteca padrão. ✅ exige evidência: comando, saída e data.

validar-telas.py para telas
verificar-fluxo.py para fluxos
lint-procedure.py, verificar-prototipo.py

Uma trilha de dados por projeto: SQL Server ou Dataverse.

O nome real vence. Fórmulas e fluxos usam os nomes lidos do ambiente, nunca os do plano.

Escrita sempre passa por um fluxo, com resposta de 4 campos e .Run() dentro de IfError.

O fluxo lê a identidade de quem chama do próprio contexto e autoriza cada ação.

Nenhum literal de ambiente nas entregas: variáveis de ambiente e connection references no lugar.

Gerador nunca sobrescreve o que foi colado. O que é gerado vai para dist/.

Instalar

Dois comandos, depois `/pp:novo`.

Dentro do Claude Code, adicione o marketplace e instale o plugin. Digite /pp: para ver os comandos de etapa; se não aparecerem numa sessão que já estava aberta, reinicie o Claude Code.

Dentro do Claude Code

/plugin marketplace add <owner>/power-platform-skills
/plugin install pp@power-platform-kit

Ou pelo terminal

claude plugin marketplace add <owner>/power-platform-skills
claude plugin install pp@power-platform-kit

Seu primeiro app

/pp:novo um app para acompanhar pedidos entre as unidades

Para atualizar depois: claude plugin marketplace update power-platform-kit e, em seguida, claude plugin update pp.

⌘
Claude Codecom suporte a plugins
🐍
Python 3.10+estado do projeto e validadores; pip install pyyaml para validar as telas
⚡
Um ambiente Power PlatformPower Apps Studio e Power Automate, para colar, testar e publicar
🖼️
Chave da API da OpenAI opcionalsó para os mockups em imagem da etapa 4, gerados depois que você autoriza. Configure fora do chat; sem ela, a etapa segue sem imagens.