K
Kodama Vault
knowledge hub
Vault
HomeBoardMap of ContentChatConversasAuditoria
Agentes
AgentsIssuesTerminalPreviews
Sistema
MCPSetup MCPSettings
Brain
Global agent instructions
Análise custos migração — evitar senha no payloadLevantamento fluxo registro + duplicados StripeRelatório segurança + pentes finos (Cláudio)Revisão security concerns e race conditionsMagic link / esqueceu senha via SupabaseCorrigir erros pós-upgrade TypeScriptTestar PRs do agente Vault para mergeAnálise de 3 issues para iniciarErro no terminal do VSCodePR #173 — aguardando aprovação do LeoTestar fluxo ponta a ponta — criação de clients no StripePR #172 — testar e subir correção de funções deprecatedPitch de vendas SaaS — agendar call de conversãoOrganizar issues e bugs rápidos para a semanaMerge PR cadastro-novo — funcionalidades e correçõesCorrigir bugs PR #173 e #172 — image domainsPR mesosóico — página de acesso mobile + segurança OTPRefatoração de códigos — PR #202Ajustes em PRs abertos de ontemEstudo de jornada de compra e técnicas de fechamentoDefinir preço e entregável do produtoProspecção de reuniões para esta semanaAgente anti AI slop — centralização de conhecimento ConnfitPR #179 — resolver conflitos e erros de teste CLIAlinhamento de preços e usos da ConffitFix adicional para PR #183 — perfil do usuárioCorrigir estilização da Connfit para identidade visualSubir modificações no copy da ConnfitCriação de 4 campanhas no Meta AdsRevisão de PRs do GilinesExploração do Roblox EditorRelatório João — devolutiva TikTok ShopReunião presencial Zassi Uniformes — diagnóstico automaçõesCriar repositório de diagnósticos e relatórios de entrevistasDiagnóstico da ZassiGeração de relatórios para reuniões de fechamentoProposta Zassi — apresentação amanhãProspecção — Clínica Odontológica Dr. But
VPS Hermes — acesso e estrutura
Always Commit Push DeployHermes Voice GeminiHermes VPSKodama Prospects TrackerMEMORYObsidian VaultRoblox Mining Sim
OpenSpec -- Spec-Driven Development no VaultPlano de Teste — OpenSpec Vault Persistence
CaumzitoNyxzZanini
Change 01 — Conteúdo perdido por sobrescrita acidentalChange03Change 04 — Sessão híbrida: 3 planos + fidelidade decrescente + diagnóstico pagoChange 05 — Reverter comissão Kodama para 5% piloto / 8% regularChange 06 — Foco temporário em TikTok Shop apenasChange 07 — Mapeamento ampliado (moda) e dados de mercado atualizadosContexto Scraping V04Destilado01Destilado02Destilado03Destilado04Destilado05Destilado06Destilado07Destilado Kodama — v08Standup log — kodama
Claude Code — Setup MCP VaultClaude Desktop — Setup MCP Vault (remote)VS Code + Copilot — Setup MCP Vault
Skill — Carousel Designer (Paper Style)
Standup 2026-05-14Standup 2026-05-15Standup 2026-05-16Standup 2026-05-17Standup 2026-05-18Standup 2026-05-19Standup 2026-05-20Standup 2026-05-21Standup 2026-05-22Standup 2026-05-25Standup 2026-05-26Standup 2026-05-27Standup 2026-05-28Standup 2026-05-29Standup 2026-06-01Standup 2026-06-02Standup 2026-06-03Standup 2026-06-05Standup 2026-06-11Standup 2026-06-15Standup 2026-06-16Standup 2026-06-17Standups
MOCWelcome
v0.3
K
Kodama Vault
brain / projects / kodama

Destilado Kodama — v08

Mudança estrutural para plano único + comissão decrescente por banda de GMV. Substitui modelo 8/6/4 por plano e Performance/Completo/Básico.

Destilado Kodama — v08

Gerado em 2026-05-20 a partir de revisão crítica da estrutura de comissão decrescente por plano (8/6/4) introduzida no site institucional.

Mudança nuclear: acaba a estrutura de 3 planos. Passa a existir um plano único com mensalidade flat + comissão decrescente por banda de GMV (não por escolha de plano). Serviços antes restritos aos planos Completo/Performance viram add-ons à la carte.


Changelog v07 → v08

# Mudança Seção Origem
01 3 planos (Básico/Completo/Performance) → plano único Kodama Estrutura comercial Análise de produto 2026-05-20
02 Comissão 8% flat (regular) → comissão decrescente por banda de GMV Precificação Resolve incentivo invertido detectado em v06/v07
03 Serviços antes "premium" (relatório semanal, otimização agressiva, reunião mensal) → add-ons à la carte Catálogo Plano único exige modularização
04 Mensalidade 400/700/1000 → R$ 700 flat Pricing Mantém média ponderada da projeção v05
05 Argumento comercial "comissão flat" → "comissão que cai conforme você cresce" Mensagem Captura benefício sem ponto de inversão
06 Setup grátis condicionado mantido — ADR-006 segue válido
07 Fidelidade 6m + multa decrescente mantida — ADR-006 segue válido
08 Diagnóstico R$ 300 mantido — ADR-006 segue válido

Problema com o modelo anterior (v06 / v07)

A estrutura 8% flat (v07) ou 8/6/4 por plano (proposta site v08-pre) tinha três problemas estruturais:

  1. Incentivo invertido (no 8/6/4): cliente Performance entrega mais trabalho operacional (relatório semanal, otimização agressiva, reunião mensal) mas cobrava menor comissão (4%). Acima de R$ 15k de GMV mensal, Básico passava a render mais que Performance para a Kodama — apesar de ocupar menos horas-pessoa.

  2. Decisão de plano gera fricção: lojista chega no funil tentando avaliar 3 pacotes com pricing diferente, frequência de relatório diferente e nível de ads diferente. Trava no fechamento. Plano único elimina essa fricção.

  3. Argumento comercial mais forte vinha por banda de GMV, não por plano: "quem vende mais paga menos %" só funciona se o desconto seguir o volume real, não a escolha de pacote.

Ver análise completa em projects/kodama-agencia/analise-comissao-decrescente.


Nova estrutura — Plano Kodama

Mensalidade

R$ 700 / mês — plano único, mesmo serviço base para todo cliente.

Cobre:

  • TikTok Shop operado de ponta a ponta
  • Cadastro com atributos otimizados, fotos, descrições
  • Anúncios pagos no TikTok Ads (gestão básica)
  • Atendimento ao cliente na plataforma
  • Gestão de avaliações
  • Gestão de festivais e datas-chave do TikTok
  • Relatório quinzenal de performance
  • Produtos ilimitados

Comissão decrescente por banda de GMV

Comissão é marginal — cada faixa paga a alíquota daquela faixa. Não é alíquota única sobre o total.

Banda de GMV mensal Comissão sobre vendas líquidas
Até R$ 5.000 8%
R$ 5.000 a R$ 15.000 6%
R$ 15.000 a R$ 50.000 4%
Acima de R$ 50.000 3%

Base de cálculo: vendas líquidas = GMV no TikTok Shop − taxa de plataforma (6%) − taxa fixa (R$ 4/item).

Exemplo prático: cliente faturou R$ 20.000 num mês.

  • Primeiros R$ 5.000 × 8% = R$ 400
  • Próximos R$ 10.000 × 6% = R$ 600
  • Últimos R$ 5.000 × 4% = R$ 200
  • Total comissão Kodama: R$ 1.200

Setup

Grátis condicionado à fidelidade de 6 meses. ADR-006 segue válido.

Para os 2 primeiros clientes piloto: grátis sem condicionante adicional.

Fidelidade

6 meses com multa decrescente. ADR-006 segue válido.

Mês de saída Multa em mensalidades Em R$
1 5× R$ 3.500
2 4× R$ 2.800
3 3× R$ 2.100
4 2× R$ 1.400
5 1× R$ 700
6+ 0 R$ 0

Diagnóstico

R$ 300 mantido. Vira desconto na primeira mensalidade se cliente fechar em 30 dias. ADR-006 segue válido.


Add-ons à la carte

Substituem a diferenciação "Completo vs Performance". Cliente pode contratar qualquer combinação:

Add-on Preço Recorrência Quando vender
Relatório semanal R$ 200 / mês Mensal Cliente quer acompanhamento próximo
Otimização agressiva de listagens R$ 300 / mês Mensal Cliente em fase de aceleração
Reunião mensal de estratégia R$ 200 / mês Mensal Cliente quer reuniões fixas, não eventual
Estratégia customizada de campanhas R$ 400 / mês Mensal Cliente com budget de ads alto
Fotos profissionais de produto R$ 200–400 Único, por produto/lote Cliente sem fotos profissionais
Cortes para Reels e TikTok orgânico R$ 300 / mês Mensal Cliente quer presença orgânica
Live commerce exclusiva R$ 800–1.200 Por evento A partir do mês 7 (fase 2)
Outros marketplaces (ML / Magalu / Shopee) R$ 300 / mês por canal Mensal Sob demanda — não destacar no comercial

Combo "Performance equivalente" (caso o cliente queira reproduzir o antigo plano R$ 1.000): R$ 700 base + relatório semanal R$ 200 + otimização agressiva R$ 300 + reunião mensal R$ 200 + estratégia customizada R$ 400 = R$ 1.800 / mês.

Fica mais caro que o antigo Performance (R$ 1.000), o que está correto — o antigo Performance subsidiava esses add-ons no preço base. Agora cliente paga o valor real.


Receita Kodama por cliente — comparativo

GMV/mês v07 (8% flat) v08-pre (Completo 6%) v08 (1 plano + bandas)
R$ 3.000 R$ 940 R$ 880 R$ 940
R$ 5.000 R$ 1.100 R$ 1.000 R$ 1.100
R$ 10.000 R$ 1.500 R$ 1.300 R$ 1.400
R$ 15.000 R$ 1.900 R$ 1.600 R$ 1.700
R$ 30.000 R$ 3.100 R$ 2.500 R$ 2.300
R$ 50.000 R$ 4.700 R$ 3.700 R$ 3.100
R$ 100.000 R$ 8.700 R$ 6.700 R$ 4.600

v08 fica entre v07 e v08-pre. Sub-otimiza em GMV alto vs v07 puro, mas:

  • Mensagem comercial muito mais forte
  • Sem ponto de inversão entre planos (problema do v08-pre)
  • Recompensa volume real, não escolha de pacote
  • Cliente grande ganha desconto efetivo conforme escala

Em GMVs muito altos (R$ 100k+), a estrutura por banda paga menos que 8% flat — mas:

  • (a) Lojistas dessa faixa já têm peso comercial pra renegociar comissão
  • (b) Margens absolutas continuam crescendo (R$ 4.600 > R$ 3.700)
  • (c) Cliente nesse patamar não estaria mais no "self-service" do site mesmo

Margem do lojista — recalculada

Cenário base (produto R$ 80, frete sul, primeira banda)

Item Valor
Preço de venda R$ 80,00
(−) Taxa TikTok 6% R$ 4,80
(−) Taxa fixa por item R$ 4,00
= Vendas líquidas R$ 71,20
(−) Comissão Kodama (banda 1, 8%) R$ 5,70
(−) Frete R$ 8,00
(−) Custo produto (35%) R$ 28,00
Margem líquida lojista R$ 25,50 (32%)

Cenário escalado (produto R$ 80, cliente já passou da banda 1)

Item Valor
Preço de venda R$ 80,00
(−) Taxa TikTok 6% R$ 4,80
(−) Taxa fixa por item R$ 4,00
= Vendas líquidas R$ 71,20
(−) Comissão Kodama (banda 2, 6%) R$ 4,27
(−) Frete R$ 8,00
(−) Custo produto (35%) R$ 28,00
Margem líquida lojista R$ 26,93 (34%)

Cenário top (produto R$ 120, cliente na banda 3)

Item Valor
Preço de venda R$ 120,00
(−) Taxa TikTok 6% R$ 7,20
(−) Taxa fixa por item R$ 4,00
= Vendas líquidas R$ 108,80
(−) Comissão Kodama (banda 3, 4%) R$ 4,35
(−) Frete R$ 9,00
(−) Custo produto (35%) R$ 42,00
Margem líquida lojista R$ 53,45 (44%)

Cliente que escala ganha mais por venda conforme entra em bandas menores. Argumento de venda fica concreto.


Projeção financeira — recalculada para v08

Premissas:

  • Mensalidade flat R$ 700 (sem mix de 3 planos)
  • Comissão média ponderada: ~7% nos primeiros 12 meses (clientes em sua maioria abaixo de R$ 15k GMV)
  • GMV médio por cliente nos primeiros 12 meses: R$ 3.000 (conservador)
  • 3 clientes novos / mês, fidelidade 6m

Receita média por cliente nos primeiros meses: R$ 700 + (R$ 3.000 × 8%) = R$ 940/mês (assumindo todos na banda 1).

Mês Clientes Receita fixa Comissão Receita total Custo Mês Acum.
M1 0 R$ 0 R$ 0 R$ 0 -R$ 8.000 -R$ 8.000 -R$ 8.000
M2 2 R$ 1.400 R$ 480 R$ 1.880 -R$ 7.150 -R$ 5.270 -R$ 13.270
M3 5 R$ 3.500 R$ 1.200 R$ 4.700 -R$ 7.150 -R$ 2.450 -R$ 15.720
M4 8 R$ 5.600 R$ 1.920 R$ 7.520 -R$ 7.150 +R$ 370 -R$ 15.350
M5 11 R$ 7.700 R$ 2.640 R$ 10.340 -R$ 7.150 +R$ 3.190 -R$ 12.160
M6 14 R$ 9.800 R$ 3.360 R$ 13.160 -R$ 7.150 +R$ 6.010 -R$ 6.150
M7 17 R$ 11.900 R$ 4.080 R$ 15.980 -R$ 7.150 +R$ 8.830 +R$ 2.680
M8 20 R$ 14.000 R$ 4.800 R$ 18.800 -R$ 7.150 +R$ 11.650 +R$ 14.330
M9 23 R$ 16.100 R$ 5.520 R$ 21.620 -R$ 7.150 +R$ 14.470 +R$ 28.800
M12 ~29 R$ 20.300 R$ 6.960 R$ 27.260 -R$ 7.150 +R$ 20.110 ~+R$ 86.000

Break-even mensal: M4 (8 clientes) — mesmo do v05
Payback acumulado: M7 (17 clientes) — igual ao v05
Receita acumulada M12: ~R$ 86.000 — ligeiramente acima do v05 (R$ 82.000)

Conforme parte dos clientes atravessar bandas (R$ 5k+), a comissão média cai, mas o GMV total sobe — a receita total continua escalando, só com curva mais suave que take-rate flat.


Riscos do modelo v08

1. Perda de âncora de preço

Sem plano Performance R$ 1.000 ancorando o topo, o preço de R$ 700 fica solto. Mitigação: material comercial enfatiza comparativo com mercado ("agências cobram R$ 2.500+ pelo mesmo escopo") e mostra cálculo total via add-ons.

2. Cliente pequeno acha caro

Lojista com R$ 3k de GMV vê R$ 700 como peso (~23% do GMV). Mitigação: a primeira banda (8% até R$ 5k) é o cheque-defender da Kodama — esses clientes têm comissão baixa em R$ mas alta em % do GMV, o que ainda mantém receita por cliente ~R$ 940. Se virar problema recorrente, criar plano "Starter" futuro (mensalidade zero + 12% comissão até R$ 5k).

3. Add-ons subutilizados

Cliente médio fica só no R$ 700 base, sem comprar add-ons. Mitigação: add-ons são vendidos no diagnóstico (R$ 300) ou em revisão trimestral. Não dependem de "upgrade de plano" — venda por gatilho operacional ("você não tem fotos boas → fotos profissionais").

4. Mensagem complexa pra explicar

"Comissão por banda" exige explicação. Mitigação: pitch usa exemplo numérico simples ("se vender R$ 20k no mês, sua comissão fica em R$ 1.200 — equivalente a 6%"). Site tem calculadora interativa que faz a conta sozinha.

5. Sem upgrade óbvio para retenção

Em SaaS clássico, upgrade de plano é vetor de retenção. Aqui o "upgrade" vira contratar add-ons. Mitigação: add-ons funcionam — cliente que pega 3 add-ons já chega a R$ 1.500/mês, com expansão de receita real.


Documentos a realinhar com v08

Arquivo Mudança necessária
business-model.md Reescrever — plano único + bandas + add-ons
tabela-precos-cliente.md Reescrever — uma só estrutura, sem 3 planos
tabela-precos-interna.md Reescrever — bandas, add-ons, cenários financeiros recalculados
pitch.md Reescrever visita 2 — vende plano único, sem "qual dos três"
decisions.md Adicionar ADR-009: Plano único + comissão por banda de GMV
Site agencia.kodama.solutions Refatorar Planos → Plano + Add-ons. Calculadora atualizada.
analise-comissao-decrescente.md Marcar como resolvido pelo destilado08

Documentos relacionados

  • projects/kodama-agencia/analise-comissao-decrescente — análise que originou esta mudança
  • projects/kodama/destilado07 — versão imediatamente anterior (8% flat regular)
  • projects/kodama/destilado05 — origem do setup grátis + multa decrescente
  • projects/kodama-agencia/decisions — ADR-009 registra esta decisão
  • projects/kodama-agencia/business-model — modelo de negócio atualizado
notas relacionadas
carregando…