Argila · passe o mouse para amassar

Primeiro a escultura. Depois, a explosão.

O Deidara é uma skill do Claude Code para Power BI. Você descreve o painel em português, o gestor aprova um protótipo com números fictícios e, só depois do “sim”, sai o projeto completo. Sem acessar os seus dados. Sem adivinhar o nome de uma coluna.

role ↓
壱O problema

Painel errado costuma rachar
nos mesmos três lugares.

Nome de coluna chutado, indicador montado do jeito mais fácil e um gestor que só vê o resultado quando já está tudo pronto. O Deidara fecha as três rachaduras antes de a peça ir ao forno.

01

O nome adivinhado

SELECT DATA_ADMISSAO
FROM F_FUNCIONARIO
-- a coluna real é DATAADMISSAO

No Deidara, todo nome vem do catálogo da fonte e toda função, do dicionário. O validar recusa o resto e diz o que existe.

02

O indicador do jeito fácil

Headcount =
  COUNTROWS(Funcionarios)
-- conta desligados de todos os tempos

No Deidara, headcount é estoque na data, turnover usa o headcount médio e a meta tem polaridade. Ele avisa quando um corte não filtra o número.

03

O gestor só vê no fim

semana 1  modelagem
semana 2  medidas e visuais
semana 3  "não era isso"

No Deidara, o gestor aprova um protótipo HTML primeiro, com checklist e comentários. Mudou algo? Novo protótipo, novo aceite.

弐Como funciona

Oito quadros,
do pedido ao .pbip.

No dia a dia, quem roda os comandos é o Claude. As saídas nos quadros são reais, do exemplo de RH do repositório.

01 · BRIEFING

Você pede em português.

quero um painel de desligamentos por motivo e cargo, com a meta de turnover por empresa
A meta vem da planilha do RH e usa o mesmo código de empresa do ERP?
$ deidara.py novo meu --projeto "Turnover RH"
02 · FONTES

A receita vai. Só a estrutura volta.

Quem tem acesso roda a consulta onde os dados estão e cola o resultado.

$ catalogar --de colado/erp.txt 5 tabela(s), 17 coluna(s), 4 ligação(ões)
03 · ESBOÇO

A argila toma forma.

Tabelas, calendário e o turnover com a cadeia inteira.

padrão "turnover": a cadeia inteira entrou
04 · VALIDAR

Nada de nome chutado.

Os avisos viram decisões, em linguagem de negócio.

! 4 aviso(s) para decidir com o usuário
05 · PROTÓTIPO

A escultura, para o gestor.

Um HTML com números fictícios coerentes, um ⓘ em cada visual e a aba “Para aprovar”, com checklist e comentários.

Aprova este protótipo para eu gerar o projeto Power BI?
06 · ACEITE
承認APROVADO

O “sim”, registrado.

Sem protótipo, não há aceite. Mudou algo depois? O gerar recusa.

Katsu! Aprovado por Gestor de RH
07 · GERAR
C3!

A explosão: o projeto inteiro.

O .pbip com TMDL e PBIR, as views SQL, a conferência, a qualidade, o LEIA-ME e a folha de homologação, com quem faz o quê.

C3! Projeto gerado Quadro_e_Turnover.pbip · LEIA-ME.md · HOMOLOGACAO.md · sql/erp/
08 · MEMORY CARD

O time guarda o que aprovou.

Cada painel e indicador vai para um repositório privado do time, com versão e o motivo de cada mudança. Indicador oficial não é reescrito por um painel.

$ memory-card enviar ... (prévia; envio só com o "sim")
参Privacidade por construção

Ele não toca
nos seus dados.

O Deidara não se conecta a nenhuma fonte. Ele entrega uma consulta SQL, DAX ou Power Query que lê só o catálogo. Quem tem acesso roda onde os dados estão e cola o resultado: tabelas, colunas, tipos, chaves e ligações.

Receita SQL · SQL Server
/* Lê SOMENTE o catálogo (sys.*):
   nenhuma linha de dado sai daqui. */
SET NOCOUNT ON;
DECLARE @esquema sysname = N'dbo';
WITH alvo AS (
  SELECT t.object_id, t.name
  FROM sys.tables AS t
  JOIN sys.schemas AS s ...
linhas de dado0só a estrutura
Catálogo · nomes amigáveis
F_DESLIGAMENTOfDesligamento
DATADESLIGAMENTOData do Desligamento
F_FUNCIONARIOdColaborador
DATAADMISSAOData de Admissão
CODCARGOCód. Cargo
零0 LINHAS
DE DADO
伍Entende indicador

Headcount não é
contagem de cadastro.

Os padrões de indicador dizem como criar cada número e onde: medida, cálculo visual, grupo de cálculo, Power Query ou view SQL. O turnover entra com a cadeia inteira.

✕ Como costuma aparecer

Headcount = COUNTROWS(Funcionarios)

Turnover % = [Qtd Desligamentos] / [Headcount]

O denominador conta ativos e desligados de todos os tempos e não muda com o período: a taxa sai menor do que é e não compara meses. A divisão com “/” quebra quando o denominador é zero.

✓ O que o Deidara gera (TMDL)

measure Headcount =
  VAR _fim = MIN(MAX(dCalendario[Data]), [Data de Corte])
  VAR _entradas =
    CALCULATE(COUNTROWS(dColaborador),
      dColaborador[Data de Admissão] <= _fim,
      REMOVEFILTERS(dCalendario))
  ...
measure 'HC Médio' =
  ... AVERAGEX(VALUES(dCalendario[Ano-Mês]), [Headcount])
measure Turnover = DIVIDE([Desligamentos] + 0, [HC Médio])

Quem estava dentro no fim de cada mês, a média desses fins de mês e a taxa sobre ela.

30 padrões de indicador

Taxa, estoque, acumulado, turnover completo, dias úteis… cada um com o DAX, a alternativa e os cuidados.

Corte que não filtra

Quando um segmentador filtra só parte de uma taxa, o esboço tira o corte do visual e diz por quê.

Sinal ou ruído

Gráfico de controle, fora da curva, meta contra faixa normal e sazonalidade, para o gestor não reagir a ruído.

陸C0 · engenharia reversa

Já tem um painel?
Ele quebra e refaz.

Traga uma medida colada, a pasta do .pbip ou o resultado da receita DAX de um .pbix. O C0 mostra o que cada fórmula faz de verdade, o efeito de cada problema no número e a versão corrigida. Abaixo, a saída real de c0 estudar no painel antigo de exemplo.

4,5de 10 · reprovado
  • Turnover %

    CRÍTICOO denominador conta ativos e desligados de todos os tempos e não muda com o período: a taxa sai menor do que é e não compara meses.

  • Headcount

    Entram também os desligados (e quem ainda não entrou): o número não é quem está ativo, e não muda com o período.

  • Turnover Médio

    CRÍTICOMédia de taxas: dá o mesmo peso à área de 10 pessoas e à de 5.000. O total não é a taxa do grupo.

  • Status Turnover

    Meta escrita dentro da fórmula: quando a meta mudar, alguém precisa achar e editar o DAX, e o gestor não vê a meta no painel.

3 crítico8 alto9 médio1 baixo5 tabelas · 13 medidas
漆O que você recebe

Pronto para
homologar.

O .pbip é o formato texto oficial da Microsoft para o mesmo conteúdo do .pbix: abre no Power BI Desktop, que salva como .pbix em um clique, e fica versionável no git.

pbi/ ├── Quadro_e_Turnover.pbip # abre no Desktop ├── ….SemanticModel/ # TMDL ├── ….Report/ # PBIR ├── sql/erp/ │ ├── 01_views.sql # bi.vw_* │ ├── 02_conferencia.sql # totais no banco │ └── 03_qualidade.sql # tudo tem que dar 0 ├── docs/dicionario_indicadores.md ├── HOMOLOGACAO.md └── LEIA-ME.md
Projeto Power BI

Modelo dimensional com calendário, medidas DAX com descrição, páginas no modelo de layout escolhido e o tema.

Views, conferência e qualidade em SQL

A camada bi.vw_*, o total de cada indicador no banco (inclusive o headcount de cada fim de mês) e a checagem de chave repetida, órfãos e datas fora do calendário.

Homologação e LEIA-ME

O que conferir antes de publicar, com onde ler cada número no painel, e quem faz o quê: DBA, analista e dono do indicador.

Dicionário e Memory Card

Definição, fórmula, origem e prova de cada ligação. Com o “sim”, o painel vai para o repositório do time.

捌Resultados

Medido,
não prometido.

Conferido na versão 0.33.0, no exemplo e na vitrine do repositório (um ERP fictício em SQL Server e uma planilha de metas no Excel).

289testes automatizados passando
143/143arquivos do projeto da vitrine conferidos contra o formato oficial da Microsoft
467funções DAX no dicionário, com assinatura e link da documentação
667funções de Power Query no dicionário
53técnicas de visual catalogadas, 44 com visual nativo
30padrões de indicador prontos
11modelos de layout, do protótipo ao .pbip
158 + 66modelos Deneb e pacotes de funções DAX do daxlib na galeria da comunidade, com licença MIT
0linhas de dado que as receitas devolvem. A estrutura das fontes nunca vai para o Memory Card.

Para conferir: python -m unittest discover -s testes · python ferramentas/validar_pbip.py <pasta do projeto>

玖“A arte é uma explosão!”

Cada etapa
é uma técnica.

Batizado em homenagem ao artista de Naruto que molda a argila e a faz explodir: a argila é a especificação do painel, a escultura é o protótipo e a explosão é o projeto completo. Passe o mouse em cada carta.

拾Comece agora

Um clone.
Nada de pip.

Você precisa do Claude Code (com uma conta do Claude que inclua o Claude Code), de Python 3.8+ com a biblioteca padrão e do Power BI Desktop para abrir o projeto gerado.

terminal · sequência ilustrativa, saídas encurtadas

Prefere o claude.ai? Suba o zip da skill (COMO-INSTALAR.md). Quer ver tudo por dentro antes? Faça o tutorial com o exemplo do repositório.

無Sem letra miúda

O que o Deidara
não faz.

Não se conecta às suas fontes

Quem tem acesso roda a receita e cola o resultado. Guarde os catálogos e as aprovações fora de repositórios públicos.

A estrutura passa pelo Claude

Os nomes de tabelas, colunas e medidas que você cola vão para a conversa com o Claude. Se forem sensíveis, siga a política de uso de IA da sua empresa.

Não gera o .pbix direto

O .pbix é binário e fechado. O Deidara entrega o .pbip, e o Power BI Desktop salva como .pbix.

O protótipo não mostra números reais

Os números são fictícios e coerentes: servem para aprovar layout, indicadores e navegação. Os valores de verdade só o Power BI calcula.

Não cria ligação sozinho

Ele sugere com evidência e mede na fonte com uma receita de prova. Quem confirma é uma pessoa, com o nome registrado.

Não escolhe o indicador por você

A nota do C0 mede a construção da fórmula, não se aquele é o número certo para a decisão. Indicador sem definição não vai ao gestor.

Nem toda técnica é nativa

9 das 53 técnicas de visual pedem um visual personalizado (como Gantt ou nuvem de palavras); o Deidara avisa quais.

KATSU!

Qual painel o seu gestor vai aprovar primeiro? Descreva em português, mostre a escultura e só depois gere o projeto.