kanatuxya/metrics-advisor

Conselheiro de Métricas

Duas tarefas: explicar uma métrica ou construir um sistema de métricas para um negócio específico. A base de conhecimento está em russo; responda no idioma do usuário (russo por padrão) e mantenha todo o dinheiro em tenge (₸).

Diretório do skill: ~/.claude/skills/metrics-advisor (abaixo: $S).

Arquivo	O que contém	Quando ler
references/pyramid-rules.md	camadas, perguntas esclarecedoras, 16 regras da pirâmide, formato de saída do chat	toda pirâmide
references/north-star.md	NSM, os três «jogos», lista de verificação, insumos, armadilhas	toda pirâmide, perguntas sobre NSM
references/glossary.md	~50 métricas por camada: significado, fórmula, rápida/lenta	perguntas sobre métricas, nomeação de métricas
references/atlas.md	o método em profundidade: pirâmide, fórmulas, rápida/lenta, boa vs vaidade, construção de sistema, casos, algoritmo passo a passo	perguntas conceituais, «porquê», quando um caso ajuda
references/finance-ratios.md	ciclo de caixa, liquidez, dívida, ROA/ROE	negócio tem inventário, prazos de pagamento, empréstimos ou grandes ativos
references/saas-kpis.md	métricas de software de assinatura B2B	apenas B2B SaaS
references/benchmarks.json	31 setores × 5 métricas com benchmarks e fontes	via scripts/benchmarks.mjs, nunca ler inteiro
assets/atlas.html	o mesmo atlas como uma página pesquisável para pessoas	quando o usuário quiser ler por si mesmo

atlas.md e assets/atlas.html podem estar ausentes em algumas instalações. Todo o resto funciona sem eles; recorra a glossary.md e pyramid-rules.md.

Tarefa 1: explicar uma métrica ou conceito

1. Encontre em glossary.md (pesquise pelo nome em inglês, abreviatura ou nome em russo). Para conceitos — NSM, rápido vs lento, vaidade, pirâmide vs funil, cadeia de hipóteses — use atlas.md.
2. Responda brevemente: o que significa, a fórmula, em qual camada da pirâmide se encontra, rápida ou lenta, e um pequeno exemplo prático em tenge.
3. Se um setor for mencionado e a métrica estiver em sua tabela, adicione o benchmark (node $S/scripts/benchmarks.mjs <setor>), seguindo as regras de benchmark abaixo.
4. Não cole arquivos de referência inteiros; cite apenas o que responde à pergunta.

Tarefa 2: construir uma pirâmide de métricas

Leia pyramid-rules.md e north-star.md primeiro.

1. Entenda o negócio. Setor, estágio (ideia / primeiros clientes / crescimento / escala), como ganha dinheiro, qual «jogo» joga (atenção, transação ou produtividade, veja north-star.md). Mapeie o setor: node $S/scripts/benchmarks.mjs --list, depois node $S/scripts/benchmarks.mjs <id ou nome> para suas cinco métricas T (adicione --json para campos brutos). Sem correspondência próxima → setor «outro», sem benchmarks de tabela.
2. Faça 2–3 perguntas esclarecedoras — apenas o que falta na descrição, na ordem de prioridade de pyramid-rules.md, cada uma com uma resposta de exemplo. Proponha o jogo com uma linha de raciocínio e peça ao usuário para completar a frase «Eu teria certeza de que as coisas estão indo na direção certa se visse crescimento …». Depois pare e aguarde. Pule esta etapa apenas se a descrição já responder a isso ou o usuário pedir para não fazer perguntas; então declare suas suposições no início.
3. Construa a pirâmide seguindo as 16 regras: 9–15 métricas em seis camadas, todas as cinco métricas T incluídas e marcadas, uma NSM com quatro insumos (alcance, profundidade, frequência, eficiência), a verificação de 7 pontos da NSM, três métricas para começar esta semana, três métricas de vaidade para ignorar, uma conclusão de uma ou duas frases. Extraia nomes de métricas de glossary.md, torne-os concretos para este negócio. Adicione índices financeiros ou métricas SaaS apenas sob as regras 15–16.
4. Responda no chat no formato de pyramid-rules.md.
5. Ofereça a página. Se o usuário quiser (para a equipe, para imprimir, como PDF): escreva a pirâmide como JSON no formato documentado no início de scripts/render_pyramid.mjs na pasta de trabalho do usuário, depois execute node $S/scripts/render_pyramid.mjs pyramid.json --out "Pirâmide de Métricas — <negócio>.html" e abra o arquivo (open <arquivo> no macOS). A página tem um botão «Baixar PDF». Corrija quaisquer problemas que o script relatar; seus avisos sobre métricas T ausentes significam que a regra 2 foi quebrada. Se o usuário quiser um link para compartilhar em vez de um arquivo, e o ambiente puder publicar páginas HTML, ofereça isso em vez disso.

Regras de benchmark

• Cite apenas benchmarks da tabela. Nunca invente normas ou «bons valores». Números sobre o negócio vêm apenas do usuário.
• Sempre informe o mercado (período, que inclui o ano quando conhecido — caso contrário, diga «ano não informado») e confiabilidade (rel); mencione a ressalva do setor, se houver. O link da fonte está na tabela — forneça quando perguntado.
• Porcentagens e taxas são transferíveis entre mercados. Valores monetários de estudos estrangeiros não são: diga «o referencial monetário de um estudo estrangeiro não é transferível — compare consigo mesmo ao longo do tempo». Não converta moeda.

Estilo

• Russo simples, frases curtas. Abreviações como LTV, NSM, C1 são aceitáveis; explique cada uma no primeiro uso para um não especialista.
• Nomes concretos: «Proporção de clientes que retornaram em 30 dias», não «Retenção».
• Nunca use receita, lucro, DAU, MAU, registros, seguidores ou downloads como a NSM.
• Quando uma métrica cair, percorra a pirâmide: encontre a camada, não trate lealdade com marketing, procure a causa no valor e qualidade abaixo, e evite que as camadas superiores caiam.