Vamos fazer a análise de um dos principais bancos regionais do sistema americano. Falaremos sobre o ZION um banco que atua no oeste americano em estados importantes como Utah, California, Washington entre outros. O banco fornece empréstimos para pequenas e médias empresas e pessoas.
A análise de banco é bem diferente de uma Stock, então iremos mostrar na prática quais indicadores devemos nos debruçar para entender se seus números fundamentalistas estão dentro do esperado ou não.
Zion veio da nossa área de membros, pois o banco deixou de ser a minha melhor opção no setor. Fizemos recendente uma reestruturação na nossa carteira Top Picks – Stock e retiramos alguns ativos para colocar outros, Zion estava na lista.
Retorno do ZION enquanto esteve na nossa carteira Top Picks – Stocks da área de membros.
Enquanto investimos no ZION na área de membros o banco nos retornou 115% isso é cerca de 70% de IRR anual, um retorno fenomenal. Foram quase R$50 mil de retorno no banco.
Conseguimos manter nosso patrimônio acima de R$ 4,6 milhões, mesmo com a desvalorização do dólar. Os bons resultados da bolsa impulsionaram nossa carteira, mas a cotação abaixo de R$ 4,80 conteve parte dos ganhos.
No próximo mês, provavelmente farei o ajuste financeiro referente ao divórcio. Essa medida deve reduzir nosso patrimônio para a faixa de R$ 3 milhões. Retornaremos alguns patamares na nossa trajetória, mas entendemos que isso faz parte do processo.
A aquisição de um novo veículo também impactou minha taxa de poupança e o patrimônio líquido.
Um resumo deste mês e como aumentamos ou diminuímos nosso patrimônio investido, em reais (R$). Alguns dias da 1ª e da 5ª semana podem pertencer ao mês anterior ou ao seguinte:
1ª semana: +95k
2ª semana: +9k
3ª semana: +153k
4ª semana: -21k
Encerramos o mês anterior com R$ 4,654 milhões e agora chegamos em R$ 4,622 milhões. Isso representa uma redução de R$ 32 mil.
Esse é apenas um passo na nossa trajetória. Para acompanhar todos os detalhes da nossa jornada rumo à independência financeira, visite nossa página de Orçamentos, onde registro cada etapa desse caminho.
Receitas
Companys: Esta categoria inclui a receita proveniente de empresas de capital fechado, dividida em duas subcategorias:
Holding: Compreende as empresas e negócios virtuais dos quais sou o único proprietário.
Lucro em Sociedades: Engloba as empresas onde tenho ao menos um sócio. Uma delas, inclusive, é utilizada como exemplo em nossa série sobre empreendedorismo: Meu Negócio.
Outras Receitas: Refere-se a rendimentos diversos que não se enquadram na categoria de lucros empresariais, provenientes de pequenos projetos independentes que ainda não se transformaram em negócios completos.
Aluguéis: Inclui a renda gerada por imóveis físicos fora do mercado de ações.
Dividendos: Representa as receitas recebidas de empresas de capital aberto na bolsa de valores.
Poupança: Abrange os juros obtidos sobre valores depositados em contas de poupança.
A receita deste mês totalizou R$ 113 mil, registrando forte queda em relação ao mês anterior. Os lucros das empresas recuaram de R$ 173 mil para R$ 77 mil. Esse cenário reflete tanto novos investimentos quanto a redução geral do mercado.
Em comparação a abril de 2025, que registrou R$ 178 mil, a receita atual apresentou queda de R$ 65 mil. Não fossem os investimentos e os gastos maiores em algumas empresas, o lucro poderia ter sido semelhante. Tivemos também uma retração nos pedidos de um dos negócios, o que reduziu os resultados devido ao menor volume de vendas.
Essa queda deveu-se a gastos não recorrentes, como a aquisição de um novo veículo. Estou abrindo um novo negócio, o que exige minha presença semanal no local. Essa rotina está elevando significativamente a quilometragem da minha Mercedes — são 500 km por semana. Para otimizar os custos com combustível e preservar o veículo principal, optei por adquirir um carro elétrico para realizar esse percurso.
Essa aquisição elevou as despesas extraordinárias acima do habitual, o que impactou diretamente os resultados do mês.
Despesas – Resumo
As despesas com a Laura caíram de R$ 16,5 mil para R$ 10,2 mil, principalmente devido aos custos com a professora particular. Preciso desembolsar quase R$ 4 mil mensais para garantir que ela tenha um bom desempenho na escola que frequenta.
Com a Liza, também registramos uma redução, de R$ 5,2 mil para R$ 5 mil. Já com o Nick, nosso filho, os gastos diminuíram de R$ 2,8 mil para R$ 2,7 mil.
Todos os demais gastos apresentaram redução. Não fossem os gastos não recorrentes, teríamos alcançado uma boa taxa de poupança neste mês.
Despesas – Não recorrentes
Os gastos não recorrentes saltaram de R$ 3,3 mil para R$ 64,7 mil, motivados principalmente pela entrada inicial do veículo que adquiri. Inicialmente, considerei o Volvo EX30. Para mim, era essencial contar com um sistema de piloto automático, recurso muito útil para quem percorre longas distâncias, pois permite que o veículo conduza autonomamente.
Ao visitar a Volvo, notei que o interior do carro apresentava um design extremamente minimalista, com a quilometragem exibida no centro da tela. Esse aspecto me incomodou. Em seguida, visitei a Geely, que oferece um modelo equivalente, porém com a marca chinesa, o que se traduz em um preço mais acessível. Outro fator decisivo foi a condição de pagamento: a Geely oferecia 60% de entrada e o restante em 24x sem juros, o que tornava a proposta ainda mais vantajosa em comparação ao Volvo.
Como era meu primeiro carro plug-in, optei por adquiri-lo como um teste. Caso a experiência seja positiva, considerarei migrar para outras opções no futuro.
O veículo é um SUV. Embora eu não tenha preferência por esse segmento, como o uso será focado em viagens a trabalho, com frequência de uma ou duas vezes por semana, a escolha por um SUV justifica-se pela maior capacidade de transporte de carga e passageiros.
Na Geely, optei pelo EX5 Max, pois a versão Pro não contava com o sistema de piloto automático. O carro é completo e conta com todos os recursos que encontramos em um Mercedes top de linha. Agora, vou testá-lo na prática para avaliar se atende às expectativas.
Sei que, em termos de revenda, o resultado será significativamente inferior se comparado ao Volvo. Mesmo sendo elétrico, o Volvo tende a perder menos valor de mercado do que os veículos chineses. Outro ponto relevante é a substituição da bateria: uma troca completa de todas as baterias do Geely custaria mais de R$ 100 mil, o que praticamente caracteriza o veículo como descartável.
A vendedora argumentou que o carro possuía garantia de 5 anos. No entanto, expliquei que esse benefício não seria plenamente aproveitável devido à minha alta quilometragem anual. A garantia possui um limite de quilômetros rodados, que eu ultrapassaria em 3 anos ou menos.
Paguei uma parcela da entrada de R$ 50 mil agora, e faltam outros R$ 83 mil, que quitarei no mês seguinte. Por esse motivo, meus gastos não recorrentes aumentaram significativamente.
Ainda na categoria de gastos não recorrentes, registramos R$ 5,6 mil em investimentos nas empresas e R$ 2,9 mil com uma viagem para Santos/Guarujá no feriado.
Abaixo, listo algumas compras realizadas neste mês:
Balde para bebê: comprei esse balde para poder dar banhos no Nick.
As aventuras de Mike 1 e livro 2: Bem, a Laura me disse que queria este livro. Como não o conheço, é difícil afirmar se contém conteúdo ideológico ou não. Parece ser bem tranquilo, pelo menos pela folheada que dei. O conteúdo é bem infantil e a proposta é que a criança possa colori-lo aos poucos.
Kaoru e Rin volume 3: Outro livro que a Laura me pediu foi um mangá que ela está lendo. Ela já está no terceiro volume e a obra também está disponível na Netflix, onde estou assistindo com a Liza. Com uma pegada romântica, é ideal para meninas. Pode comprar sem medo, pois elas irão gostar. Não contém conteúdo ideológico nem de cunho sexual. É uma leitura bem tranquila. Introduzir o hábito de leitura em seu filho por meio de mangás é uma excelente opção. Esse é o link para o Volume 1.
Off
Como esta série de posts tem um tom mais pessoal, decidi compartilhar um resumo do que estou ouvindo e assistindo.
Meu gosto musical é bastante peculiar, então não se surpreendam. Ultimamente, tenho evitado músicas em inglês ou português, pois prefiro não entender as letras, especialmente porque muitas canções atuais têm letras de baixa qualidade.
Aqui estão três músicas que tenho ouvido neste mês:
Na parte de filmes e séries, vou atribuir uma nota para dar uma ideia se vale a pena assistir. Se a nota for maior que 7, já é assistível. Os filmes de sábado são escolhidos por mim, e os de domingo ficam por conta da Bárbara.
Se você curte séries e filmes e está em busca de algumas recomendações, fique atento ao meu post mensal sobre finanças, onde vou compartilhar algumas bem legais.
Filmes:
Operação Fronteira – Netflix – 8/10: Filme excelente, pode assistir sem medo. As lealdades são testadas quando cinco ex-soldados das forças especiais planejam um assalto a um narcotraficante, cuja operacionalização traz consequências inesperadas.
40 Acres – Netflix – 7/10: Em um futuro devastado pela fome, a veterana Hailey luta para proteger sua família e sua fazenda no interior do Canadá. Quando uma milícia violenta tenta tomar suas terras, mãe e filho precisam se unir para sobreviver.
Caminhos do Crime – Amazon – 7/10: Filme bom, mas com final ridículo. O policial, que era todo certinho, se corrompe no final e deixa o marginal ir embora. A nova fase do conteúdo ideológico coloca o bandido como mocinho e você começa a torcer pelo vilão.
Mercy: Prova da Culpa – Amazon – 7/10: Outro filme que tinha um potencial interessante, mas se perdeu no final. Parece que o orçamento ou o tempo de produção se esgotaram, e a equipe optou por um desfecho apressado apenas para concluir a trama.
Orgulho e Preconceito e Zumbis – HBO – 1/10: Filme de baixa qualidade. Gosto de filmes de zumbi, mas este, além do conteúdo ideológico, é fraco. Não consegui passar dos 15 minutos.
Séries:Estou acompanhando estas séries atualmente; quando parar de assistir ou terminar a temporada, removo-a da lista.
A Noite De – HBO – 10/10: Seriado excelente. Podem assistir: é curto e sensacional. O advogado e o jovem protagonista árabe são interpretados por atores sensacionais. Uma produção que prende sua atenção e faz você querer assistir episódio após episódio.
Rooster – HBO – 8/10: Desde minha última menção aqui, retirei mais um ponto da avaliação da série. Arrastada e com conteúdo ideológico cada vez mais presente. O relacionamento entre o professor e a filha de Rooster não funciona e as atuações deixam a desejar. Uma comédia com Steve Carell, o mesmo de The Office. A série está apenas razoável. Esperava mais dela. Chegamos a dar algumas risadas, mas, geralmente, esse tipo de produção conta com personagens baseados em estereótipos bem divertidos, e aqui não encontramos esse elemento. Carell carrega a série nas costas, enquanto em The Officetínhamos Dwight e Jim, que eram excelentes, sem falar no restante do elenco. Aqui, os outros personagens são bem mais fracos.
One Piece: A Série – Netflix – 9/10: Comecei a assistir com a Liza, tinha visto diversas criticas na internet e achei que seria ruim, mas até que gostei. Obviamente tem algumas trocar de etnia ali, mas de modo geral eles estão mantendo os personagens dentro do esperado. Também conseguiram adaptar dentro do possível os cenários e muitos dos personagens. Acabamos a primeira temporada e espero que a coisa não desande na segunda.
Solo Levelling 7/10 Crunchyroll: comecei a assistir esse anime, uso ele para dormir, as vezes a Liza vai dormir mais cedo e preciso de pegar no sono coloco ele rapidinho durmo. A história é bem juvenil, dá para assistir, mas como boa parte dos anime começa meio arrastado e você precisa de paciência para criar conexão com os personagens.
Arrested Development 8/10 Netflix: sitcom básica. No começo, como em toda sitcom, você não vai achar meio sem graça, mas o divertimento está na hora das piadas com os esteriótipos dos personagens. O que eu mais gosto é do irmão dele o Gob, ele andando naquele aparelho pra todo lado é muito ridículo, isso me fez rir muito. Depois acho que colocaria um empate entre o filho George Michael e o cunhado Tobias, o George Michael tenta ser o cara serio enquanto que todo mundo naquela família é doido. Já o cunhado Tobias é um idiota por completo. O seriado é muito bom e vale a pena assistir.
The Fragrant Flower Blooms With Dignity – Netflix – 9/10: Comecei a assistir esse anime com a Laura, na verdade foi ela que começou a ler esse Manga e disse que era bom, mas acabamos não terminando porque chegamos na parte que eles estava lendo ai não queria spoliers. Uma escola de elite para meninas reside ao lado de uma escola para meninos para delinquentes. Um dia, dois alunos de cada escola, Kaoruko e Rintaro, se encontram e desenvolvem uma conexão.
Spy x Family – Netflix – 8/10: Esse outro anime começamos porque não conseguimos terminar o Kaoruko & Rin de cima. Laura está curtindo bastante, pois tem uma temática de família e ação com espiões. Um espião em uma missão secreta se casa e adota uma criança como parte de seu disfarce. Sua esposa e filha têm seus próprios segredos, e os três devem se esforçar para se manterem juntos.
One Piece 10/10 Crunchyrool: O melhor anime de todos. Estou na saga de Vegapunk. Assisto a One Piece há pelo menos 12 anos. Essa história me acompanha desde antes do nascimento da minha filha. Sem dúvidas, uma das histórias mais grandiosas e emocionantes que já vi. Um anime que me fez chorar, rir, sentir raiva, e me empolgar.
Então é isso, ficamos por aqui. Aproveitem as sugestões. Se você já viu algum desses, me diga o que achou no meu Twitter.
Aumentamos nossa posição na TRIN um dos BDC que tenho iniciado posição, também aportamos numa velha conhecida do blog, PAYX é uma empresa especializada em RH.
Meu aporte mensal foi de US$ 29,3 mil. Convertido, esse valor totaliza mais de R$ 146 mil investidos na bolsa americana. Sendo desse valor quase $7,5 mil para a nossa carteira de Trade de Valor, onde compramos a Celestica uma empresa canadense que vai se beneficiar da expansão dos Data Center de IA.
Essas aquisições adicionam aproximadamente US$ 1.066,56 em dividendos anuais à minha carteira, equivalente a R$ 5.312,93, considerando a cotação atual do dólar.
Isso representa cerca de +R$ 442,74 por mês em receita de dividendos, contribuindo para a construção da minha bola de neve rumo à independência financeira.
TRIN – TRINITY CAPITAL INC
Fizemos uma análise profunda do TRIN em dez deste último ano, lá mostramos detalhes dessa BDC. Confira esse artigo abaixo e verifique os pontos positivos e negativos da TRIN.
Essa aquisição adiciona US$ 526,32 à minha carteira de dividendos. Convertido pela cotação atual do dólar, isso representa um aumento de R$ 2.621,80 na minha renda de dividendos.
PAYX – PAYCHEX INC
Fizemos uma análise recente da PAYX nesse inicio do ano, recomendo darem uma olhada, onde abordamos a aquisição da Paycor.
Apesar do meu retorno na PAYX ser satisfatório a empresa está com um declínio das cotações alto nesse último ano, isso está abrindo grandes oportunidades para quem é um investidor de longo prazo.
Alguns dos motivos dessa queda poderíamos citar:
Crescimento orgânico mais fraco no segmento PME: O negócio principal da Paychex (pequenas e médias empresas) sofreu com o crescimento lento de empregos e contratações mais fracas no mercado americano. Muitos clientes estão em modo de contenção de custos ou “hiring freeze”.
Medo de “White-Collar Recession”: Ondas de layoffs em grandes empresas geraram preocupação de que isso se espalhe para as PMEs atendidas pela Paychex, reduzindo a demanda por serviços de folha de pagamento e RH.
Queda nas taxas de juros (impacto no “float”): Parte importante da receita da Paychex vem dos juros ganhos sobre o dinheiro dos clientes que ela gerencia antes de pagar impostos e salários. Com a queda de juros do Fed, essa receita de “float” diminuiu.
Aquisição da Paycor e custos de integração: A compra da Paycor (feita em 2025) trouxe forte crescimento reportado (18%+ em algumas receitas), mas também gerou custos elevados, dívida adicional e alguma pressão de margem em trimestres específicos. O guidance para 2026 veio ligeiramente abaixo do esperado em alguns momentos, frustrando o mercado.
Veja que esses pontos não são inerentes a empresa, exceto o último: aquisição da Paycor, os demais abordam problemas sistémicos do mercado. Isso a longo prazo tendem a passar, para quem é um investidor de tempo de mercado como eu, isso é um prato cheio.
A Paychex tem investido pesado em IA própria (mais de 500 ferramentas e agentes) para automatizar processos internos, melhorar o agendamento, aprovação de folhas e compliance. Isso tem ajudado a elevar margens e é visto como vantagem competitiva. A empresa argumenta que seus clientes (majoritariamente blue/grey-collar em PMEs) são menos impactados por substituição de empregos via IA.
Essa aquisição adiciona US$ 129,60 à minha carteira de dividendos. Convertido pela cotação atual do dólar, isso representa um aumento de R$ 645,59 na minha renda de dividendos.
TOP PICKS
Temos um serviço no blog para ajudar os investidores a investir na bolsa americana, ostrando como selecionar os ativos para montar uma carteira vencedora na bolsa de valores.
Temos diversas carteiras, entre elas, as Top Picks, as carteiras com as melhores ações da bolsa, ações que já retornaram +700% nos últimos 10 anos, confira aqui.
Essa aquisição adiciona US$ 410,64 à minha carteira de dividendos. Convertido pela cotação atual do dólar, isso representa um aumento de R$ 2.045,55 na minha renda de dividendos.
Publiquei as minhas compras detalhadas num post na área dos membros. Temos lá a posição completa da carteira e uma análise dos resultados dos ativos comprados!
Quatro novos ativos acabam de entrar na nossa Carteira de Ações Pública aqui no blog Viver de Dividendos. São eles:
The J.M. Smucker Company (SJM)
Huntington Ingalls Industries (HII)
Zions Bancorporation (ZION)
Farmers National Banc Corp. (FMNB)
Esses papéis vêm diretamente da nossa área de membros e agora passam a compor a carteira aberta para todos os leitores e seguidores do blog.
Essa movimentação faz parte da nossa estratégia de transparência e de compartilhar com a comunidade as melhores oportunidades que identificamos ao longo do tempo. Os quatro ativos já passaram por nossa análise interna, foram recomendados e acompanhados pelos membros e agora chegam ao público com todo o histórico de performance e convicção que construímos.
Por que esses ativos?
Cada um deles tem características que se encaixam perfeitamente no Jeito de investir do Viver de Dividendos: empresas sólidas, com histórico consistente de pagamento e crescimento de proventos, operando em setores defensivos ou com vantagens competitivas claras. São papéis que trazem diversificação para a carteira — tanto em setores (consumo, defesa, bancos regionais) quanto em perfis de yield e potencial de valorização.
Vamos falar um pouco sobre cada um (mas só o básico, porque o melhor ainda está por vir):
SJM (The J.M. Smucker Company): Gigante americana de alimentos e bebidas, dona de marcas icônicas como Folgers, Jif, Smucker’s, Dunkin’ e líderes em pet food. É um clássico “defensivo” com fluxo de caixa previsível e tradição de aumentar dividendos por décadas.
HII (Huntington Ingalls Industries): Maior construtora naval militar dos Estados Unidos. Atua no setor de defesa (um dos mais resilientes do mundo) com contratos de longo prazo junto ao governo americano. Combina estabilidade com crescimento de proventos consistente.
ZION (Zions Bancorporation): Banco regional forte no Oeste americano, com foco em clientes corporativos e alta qualidade de crédito. Tem demonstrado disciplina na gestão de capital e vem recompensando acionistas com dividendos crescentes.
FMNB (Farmers National Banc Corp.): Banco comunitário de pequeno porte, com operação focada em Ohio e arredores. É um daqueles “small caps” bancários que entregam yields atrativos e crescem de forma conservadora, priorizando o retorno ao acionista.
Nos próximos vídeos vamos destrinchar cada ativo com calma:
Indicadores fundamentalistas atualizados
Análise completa do case de investimento
Riscos específicos de cada empresa
Por que eles saíram da carteira restrita de membros e entraram na carteira pública
Vai ser conteúdo bem aprofundado, como vocês já estão acostumados por aqui. Vamos mostrar os números, os gráficos, os balanços e, principalmente, o porquê de acreditarmos que esses papéis merecem estar na carteira de quem busca viver de dividendos no longo prazo.
Fique por dentro
Se você ainda não é inscrito no canal do YouTube, ative o sininho para não perder nenhum vídeo da série.
Acompanhe também aqui no blog — vamos atualizando a Carteira Pública com os novos aportes e o desempenho mês a mês.
Membros da área premium já têm acesso antecipado às análises completas e ao nosso acompanhamento.
Novos ativos na carteira, novos vídeos no ar e o mesmo compromisso de sempre: gerar renda passiva com qualidade e disciplina.
Sou desenvolvedor sênior full stack e já vi muita coisa acontecer no universo de programação, mas certamente a introdução da IA, levamos ao fim da carreira de DEV como conhecíamos. Muito mudou desde que as IA generativas entraram com força no mercado.
Tenho utilizando basicamente dois modelos hoje em dia, Claude para documentar e planejar as features e GLM para implementar a parte bruta e depois Claude novamente para refinar.
Vou mostrar como tenho utilizado o Claude e outras IAs para desenvolver, primeiro de tudo essa é a nova estrutura que um dev deveria seguir nos dias atuais:
flowchart TD
A[Research] --> B[Plan] --> C[Todolist] --> D[Implement] --> E[Review and Fix] --> F[Final Documentation]
E -- com erros → volta para Implement --> D
Nós estamos falando de Spec-Driven Development que vai substituir as metodologias atuais. Onde saímos de um modelo centrado na codificação e passamos para um modelo centrado na especificação.
Meu público está acostumado a abordarmos material sobre investimentos, mas hoje vamos falar de desenvolvimento de software e abordar um pouco como essa área teve uma transformação gigantes com a maneira de trabalho.
Cada feature significativa deve ter um documento com uma pesquisa a fundo dos requisitos e regras de negócios. Eu tenho um prompt que já cria essa Research. Você pode usa-lo abaixo. Adapte ele para sua necessidades e crie um padrão parecido.
O projeto é um Banco Digital, uma das minhas fintechs, nele criamos uma opção onde o usuário pode gerenciar sua folha de pagamento pelo banco, para isso precisamos criar um controle de departamentos.
Onde instalar as Skills no Cline CLI
Primeiro eu invoco a Skill de Reseach, se estiver usando o Claude Code CLI, só digitar /research no seu prompt que ele irá buscar. Claro se você já tiver instalado a Skill conforme pasta acima.
No meu caso uso o Cline, então digito “/skills” e seleciono ela na lista.
Skill de Research rodando
Veja como modelei o prompt para gerar esse research de departamentos.
1. controle-departamentos
2. Um controle de departamentos para dentro do banco, onde o usuário pode gerenciar os setores de sua empresa para fazer a gestão de sua folha de pagamento.
3.
- Cadastro de departamento deve ter código e nome
- Nome não pode ter mais do que 100 chars
- Código é autoincremento único por tenant (conta bancária)
- Multi-tenant: usar account_id em todas as queries
- PK deve ser GUID
- Código não pode repetir dentro do mesmo tenant
- Log de alterações em tabela de audit separada
- Não permitir excluir departamento ativo em payroll
- Soft-delete
- Listagem com filtro por status (ativo/inativo)
- Mostrar quantidade de colaboradores na lista
- Botão para listar colaboradores ao abrir o departamento
- Usar trim ao salvar
4.
- Não teremos imagem
- Gestão de colaboradores e seu vínculo com departamentos
- Cargos e funções
- Hierarquia/organograma entre departamentos
- Centros de custo e rateios financeiros
- Regras específicas de folha de pagamento por departamento
- Cálculo, geração ou fechamento de folha
- Controle de ponto, férias, licenças
- Qualquer dado complementar (endereço, responsável, etc.)
- Importações em massa ou integrações externas
- Workflows de aprovação
Você vai definir as Skill para sua IA. Uma skill (habilidade) para uma IA é como um atalho inteligente ou um superpoder especializado que a IA ganha para fazer certas tarefas de forma mais rápida, melhor e mais eficiente.
No meu caso criei uma Skill chamada “Research” assim não preciso de escrever todo esse prompt abaixo todas as vezes.
---
name: research
description: Cria arquivo de research detalhado para uma feature. Use quando o usuário falar "Crie o arquivo de research usando a skill Research", "research skill", "ia/research/[nome]-research.md" ou similar.
---
# Research Skill
Você é um Engenheiro de Software Sênior especializado em sistemas grandes e de longa manutenção.
### Contexto Fixo do Projeto
- Sistema grande com manutenção constante.
- Foco em código legível, extensível e fácil de manter.
- **Problema crítico**: Tabelas do banco muito grandes → Performance é prioridade máxima em TODAS as decisões.
### Regras Obrigatórias
- Respeitar rigorosamente o arquivo `constitution.md` (não repetir suas informações).
- Performance em primeiro lugar: sempre priorizar soluções rápidas, índices inteligentes, queries leves e evitar scans em tabelas grandes.
- Manutenção de longo prazo é essencial.
- Ser extremamente prático, direto e objetivo. Usar listas e tabelas curtas.
### Estrutura Exata que você deve seguir
Gere sempre o arquivo com este formato exato:
---
# Research: [NOME_CURTO_DA_FEATURE]
## 1. Visão Geral
- Objetivo em 2-3 frases, incremente sempre que possivel as informações que te pasei no prompt.
- Tamanho estimado (dias / complexidade / risco).
## 2. Escopo (OBRIGATÓRIO respeitar)
- Liste os itens que coloquei no prompt como parte do escopo para que sejam seguidos rigorosamente.
- Adicione outros itens no escopo baseado na descrição geral que te passei no prompt.
## 2. Fora do Escopo
- Da lista que passei no prompt separe claramente tudo que NÃO será feito.
- Tente buscar outros pontos importantes e acrescente-os aqui.
## 3. Análise Técnica e Edge Cases
- Referência: Ver `requirements.md`.
- Principais edge cases e cenários de falha.
- Premissas e trade-offs importantes.
## 4. Decisões Arquiteturais
- Opções avaliadas.
- Tabela comparativa resumida (prós x contras).
- Decisão final + justificativa curta (com forte foco em performance).
## 5. Impacto no Código Existente
- O que vai mudar.
- Breaking changes possíveis.
- Estratégia de migração (se necessário).
## 6. Performance, Segurança e Custos
- Análise forte de performance.
- Como evitar consultas pesadas em tabelas grandes.
- Otimizações sugeridas (índices, cache, queries leves, etc).
- Segurança e compliance.
## 7. Dependências e Riscos
- Dependências principais.
- Riscos (especialmente de performance) e mitigação.
## 8. Perguntas Abertas
- Dúvidas que precisam de alinhamento.
---
**Instruções de Uso:**
Quando eu fornecer:
- Nome da Feature
- Descrição da Feature
- Escopo
- Fora do escopo
Você deve:
1. Usar exatamente essas informações.
2. Respeitar 100% das diretrizes que eu passar.
3. Gerar o arquivo completo imediatamente, sem introduções desnecessárias.
4. Colocar o nome curto da feature no título (# Research: nome-aqui).
Agora aguarde meu comando com as informações da feature.
Esse prompt não é o Research ele vai gerar o nosso Research, a ideia aqui é elencar alguns pontos chaves e não esgotar toda a análise, isso vamos fazer a duas mãos, nos com a IA na etapa mesmo de Research.
Aqui vamos listar os pontos importantes nesse tópico: Escopo (OBRIGATÓRIO respeitar) vamos colocar todos os requisitos que lembrarmos e também o que não deve ter, pois ele vai jogar isso no “Item 2 – Fora do escopo“.
Esse item 2 é particularmente importante para impedir que a IA crie ou invente coisas que não teremos. Vamos imaginar que você quer fazer uma tela de login para seu sistema e você não quer colocar um login via Google ou Facebook, você iria colocar um item especificando isso aqui, evitando que no futuro ela implemente algo do tipo.
Constitution: para o artigo não ficar gigante, nós não vamos abordar o Constitution nesse momento, mas você deve ter visto menção dele na nossa Skill, nesse caso o Constitution é um arquivo com as diretrizes do sistema de modo geral, coisas como: Stack, arquitetura, camadas de acesso a banco e outras coisas estarão especificadas aqui e serão a mesma coisa para todo o projeto.
Com isso em mãos o Claude vai gerar um Research para você, daí vá refinando essa research, ajuste os pontos que achar necessário, aqui é onde irá gastar tempo e uma boa iteração com a IA para que vocês dois chegam num denominador comum.
flowchart TD
subgraph Inputs
A[constitution.md\nstack, arquitetura, convenções]
B[Diretrizes da feature\nregras, restrições, preferências]
end
subgraph Etapa 1
C[Prompt de research]
end
subgraph Etapa 2
D[research.md gerado\ndecisões, edge cases, riscos]
end
subgraph Etapa 3
E[Revisão humana\naprovação ou ajustes]
end
subgraph Etapa 4
F[Prompt do plan\nusa research aprovado como base]
end
A --> C
B --> C
C -->|gera| D
D --> E
E -->|ajustes| C
E -->|aprovado| F
F -->|gera| G[plan.md]
Fase 2: Plan
Uma vez que você tenha o research.md finalizado, você deve pedir para o Claude gerar um plano de ação, seja bem especifico para ele não implementar isso, esse plano deve ser revisado por você.
Recomendável nessas etapas usar o modo Plan no agente de IA, para isso que ele existe.
Use a skill de Plan para isso, veja como ele já pede o arquivo de Research que criamos antes.
Essa seria um modelo de Skill para gerar o planejamento:
---
name: plan
description: Cria planejamento detalhado de execução a partir de um research.md. Use quando o usuário falar "Com base no arquivo @[feature]-research.md crie um planejamento", "skill Plan", "ia/plan/[nome]-plan.md" ou similar.
---
# Plan Skill
Você é um Expert em Planejamento Estratégico e Spec-Driven Development para projetos de IA.
Sua única tarefa é:
Ler o conteúdo completo do arquivo **research.md** fornecido e gerar um arquivo **ia/plan/[nome-feature]-plan.md** seguindo rigorosamente a estrutura abaixo.
### Regras obrigatórias:
- Baseie TODO o conteúdo exclusivamente no research.md que te passei como referência. Não invente informações.
- Seja extremamente prático, realista e acionável.
- Use linguagem clara, direta e profissional.
- Sempre que fizer sentido, sugira o uso de outras skills ou agentes que já existam no projeto.
- Se algo importante estiver faltando no research, destaque claramente na seção de riscos ou próximos passos.
### Estrutura exata do plan.md (use Markdown):
# Plano de Execução - [Título Curto e Impactante do Projeto/Skill]
## 🎯 Objetivo Principal
(Uma única frase clara, mensurável e orientada a resultado)
## 📊 Objetivos Secundários e KPIs
- KPI 1: ...
- KPI 2: ...
- KPI 3: ...
## 🔍 Insights Estratégicos do Research
Liste os 4 a 6 insights mais relevantes e de maior impacto extraídos do research.md.
## 🧭 Estratégia Geral
Descreva em 3-5 frases a abordagem de alto nível escolhida e por quê ela é a melhor.
## 🗄️ Modelagem de Banco de Dados
- **DDL Completo**: Forneça todos os comandos CREATE TABLE, ALTER TABLE, constraints, etc.
- **Índices com Justificativa**: Liste índices sugeridos e explique o motivo de cada um (performance, busca frequente, etc.).
- **Diagrama ER em Mermaid**: Forneça o código completo do diagrama em Mermaid (use sintaxe entityRelationship).
- **Queries Frequentes**: Liste as 5-8 queries SQL mais importantes esperadas no projeto, com explicação.
## ✅ Checklist por Camada
### Migrations
- [ ] Item 1
- [ ] ...
### Models / Entities
- [ ] ...
### Repositórios / Data Access
- [ ] ...
### Services / Business Logic
- [ ] ...
### Endpoints / API Controllers
- [ ] ...
### Frontend (se aplicável)
- [ ] ...
### Testes (Unitários, Integração, E2E)
- [ ] ...
## 📅 Ordem de Execução Recomendada
Liste as etapas na sequência ideal de implementação, numerada.
## ⏱️ Estimativa por Etapa
| Etapa | Descrição | Estimativa de Tempo (horas/dias) | Responsável |
## ⚠️ Riscos que Merecem Atenção
Liste os riscos mais relevantes (técnicos, de performance, de dados, de integração, etc.) com probabilidade e impacto.
| Risco | Probabilidade | Impacto | Mitigação |
## 🛠️ Recursos Necessários
- Tecnologias e ferramentas
- APIs externas, bibliotecas
- Tempo total estimado
- Dependências externas
## 📈 Métricas de Sucesso e Critérios de Aceitação
## 🚀 Próximos Passos Imediatos (próximas 24-48h)
Liste 3-5 ações concretas para iniciar imediatamente.
---
**Instruções de Uso:**
Quando eu fornecer:
- Referência do arquivo de research
Você deve:
1. Usar exatamente as informações no arquivo de resarch passado como referência.
2. Respeitar 100% das diretrizes que eu passar.
3. Gerar o arquivo completo imediatamente, sem introduções desnecessárias.
4. Colocar o nome curto da feature no título (# Research: nome-aqui).
Agora aguarde meu comando com as informações da feature.
O fluxo aqui vai ser bem semelhante ao que trabalhamos no research, todo a infra que ele criou no plano de implementação para realizarmos a tarefa.
flowchart TD
A[Claude escreve o plan.md]
B[Reviso no meu editor]
C[Adiciono notas inline]
D[Envio o documento de volta\n para o Claude]
E[Claude atualiza o plano]
F{Satisfeito?}
G[Solicitar todo list]
A --> B
B --> C
C --> D
D --> E
E --> F
F -->|Não| B
F -->|Sim| G
Depois que o Claude escreve o plano, eu abro no meu editor de texto, reviso e adiciono alguns pontos importantes diretamente no arquivo.
Isso vai agilizar muito para você, faça anotação do que você acha importante diretamente no arquivo, você pode colocar coisas como:
“Isso não deveria ser opcional”
“Remova qualquer lógica usando ORM e priorize RAW SQL”
“Remova essa sessão completamente não precisamos disso agora”
Escreva todos os pontos no arquivo diretamente e depois enviei para ele revisar e fazer um novo.
Isso vai funcionar melhor do que você ter que abrir uma sessão de chat e ficar conversando com ele e espertando o retorno de cada comando, ou mesmo tendo que escrever aqueles prompts gigantes e ficar apontando linhas. Será mais pratico escrever no artigo plan.md e mandar ele revisar.
Algumas idas e vindas e temos um plano bem estruturado, então tínhamos uma pesquisa genérica que gerou um plano de ação prático e agora podemos implementar isso no nosso sistema perfeitamente.
O Claude é bom em escrever código e implementar soluções, mas ele não vai conhecer das nuanças do seu produto e como o usuário vai se relacionar com o ferramenta que você criou depois de pronta. Aqui estamos dando uma boa ideia para que a sua IA possa prosseguir.
Fase 3: todo list
Depois do plano revisado, vamos pedir para ele adicionar no arquivo de planejamento um Todo List para implementação do plano.
Adicione uma lista detalhada de tarefas ao plano @plan.md, com todas as fases e tarefas individuais necessárias para concluir o plano - não implemente ainda.
Essa fase irá criar um task List para que a IA possa ir se organizando do que foi realizado e o que ainda falta para finalizar. Isso serve para que tenhamos ou outro dev saiba onde paramos na implementação da tarefa.
Fase 4: Implementation
Com o nosso Plano e Todo List finalizado podemos finalmente solicitar que a IA implemente o que planejamos.
Implemente tudo o que está nesse @plan.md. Quando terminar uma tarefa ou fase, marque-a como concluída no documento do plano. Não pare até que todas as tarefas e fases sejam concluídas.
Agora é aguardar a IA terminar de implementar todo o plano e depois revisar o que ela foi fazendo. Vamos fornecendo um Feedback durante essa implementação.
flowchart TD
A[Claude implements] --> B[I review / test]
B --> C{Correct?}
C -- No --> D[Brief correction]
D --> A
C -- Yes --> E{More tasks?}
E -- Yes --> A
E -- No --> F[Done]
classDef process fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
classDef decision fill:#fff3e0,stroke:#ef6c00,stroke-width:2px
classDef done fill:#c8e6c9,stroke:#2e7d32,stroke-width:2px
class A,B,D process
class C,E decision
class F done
Fase 5: Documentation
Essa etapa é como se estivéssemos gerando um novo research só que do que já foi implementado. Quando temos um projeto grande, precisamos de guardar as informações de forma concisa, até para que possamos depois buscar isso no futuro.
Aqueles arquivos de research e plan ficam de base para a implementação, mas o arquivo que utilizo para dar manutenção no futuro é esse arquivo com o resumo da tarefa.
Esse arquivo só será gerado depois que a feature for testada e aprovada e estiver na reta final. Vamos gerar uma documentação para a IA no futuro dar as devidas manutenções. Invoque a skill de Documentation que ele irá gerar o arquivo necessário:
O truque aqui está nas frases analise a fundo as pastas, entenda a fundo, pegue o que aprendeu. Esses verbos vão reforçar para que a IA faça um novo apanhado de tudo que foi desenvolvido e gere uma documentação final para manutenção. Sem especificar para que ela analise a fundo o módulo a IA irá passar superficialmente e gerará um documento pobre no final.
Esse é um exemplo de Skill para gerar a documentação final:
---
name: documentation
description: Gera documentação técnica completa de módulos do sistema. Ative quando o usuário falar "Análise em profundidade", "documentação do módulo", "ia/[nome].md", "mapa mental", "guia de manutenção" ou similar.
---
# Documentation Skill
Módulo em questão: Gere uma descrição do módulo passado no prompt.
Você é um engenheiro sênior full-stack especializado em [linguagem]. Sua tarefa é criar um documento de referência técnico em Markdown puro (sem imagens ou links externos) que sirva como "mapa mental" e guia de manutenção para este módulo específico do projeto.
Respeitar rigorosamente o arquivo `constitution.md` (não repetir suas informações). O arquivo de constitution vai trazer uma idéia de como deve ser estruturado nosso projeto.
Conteúdo que você deve analisar e resumir:
- Endpoints
- Endpoints principais da API (arquivos de Controller)
- Entity/InputModel e ViewModel mais relevantes
- Services/Repositories chave
- Fluxo de negócio principal
- Componentes Vue mais importantes (páginas, formulários, tabelas, etc.)
- Rotas Vue relacionadas
- Qualquer configuração especial (middleware, validações, autenticação, etc.)
- Arquivos de configuração ou enums importantes
————
**Objetivo principal do documento:**
- Facilitar a compreensão rápida do módulo por qualquer desenvolvedor (ou IA) que precise fazer manutenção, correções, refatorações ou adicionar features no futuro.
- Ser o mais claro, conciso e útil possível.
**Estrutura obrigatória do documento Markdown (siga exatamente essa ordem):**
```markdown
# [Nome do Módulo] - Documentação de Referência e Manutenção
## 1. Visão Geral do Módulo
Breve descrição do que o módulo faz no negócio (2-4 linhas).
## 2. Funcionalidades Principais
Lista numerada ou com bullets das principais features/fluxos.
## 3. Endpoints da API (Backend)
Tabela ou lista com:
- Método HTTP + caminho
- Descrição breve
- IputModel e ViewModel usados
- Verificar se passa no Middleware da API para autenticação de token ou se usa autenticação de token de serviço externo como o Token do BackOffice TokenBo.
## 4. Entity e ViewModels e InputModels Importantes
Liste os principais com breve descrição e campos chave.
## 5. Camada de Negócio (Services/Repositories)
Principais services e o que fazem (fluxo de chamadas).
## 6. Frontend - Estrutura
- Rotas relacionadas ao módulo (path + nome do componente)
- Componentes principais (páginas, formulários, modais, etc.)
- Stores ou composables usados
- Serviços de API (arquivos axios ou fetch)
## 7. Fluxo Principal de Uso (User Journey)
Descreva o fluxo mais comum do usuário (passo a passo).
## 8. Regras de Negócio e Validações Importantes
Regras críticas que precisam ser mantidas.
## 9. Pontos de Atenção / Dívida Técnica Conhecida
Problemas conhecidos, gambiarras, performance, segurança, etc.
## 10. Dependências Externas
Pacotes NuGet ou npm específicos deste módulo (se houver).
## 11. Estrutura de Arquivos (Resumo)
Liste as pastas e arquivos mais importantes do módulo, agrupados por backend e frontend, em formato de árvore resumida (use texto com indentação ou lista hierárquica).
## 12. Fluxo de Dados Completo
Desenhe (em texto puro, usando setas →, Mermaid ou ASCII art simples) os fluxos de dados mais comuns do módulo, por exemplo:
- Login → carregar perfil
- Editar perfil → PUT /api/user/profile → atualizar store + UI
- Trocar senha
- Upload de avatar
- Exclusão de conta
Inclua camadas: View → Store/Composable → Service API → Controller → Application (Handler) → Repository → Entity/DbContext
Seja o mais detalhado possível nas setas, mostrando InputModel → Entity → ViewModel → DTO frontend.
## 13. Impactos de Alterações e Dependências Cruzadas no Projeto
**Análise obrigatória de propagação de mudanças:**
Liste todos os pontos de atenção e riscos que uma alteração neste módulo (ex.: adição, remoção ou modificação de campos em Entity/InputModel/ViewModel, alteração de regras de negócio, endpoints, fluxos de serviços, validações, etc.) pode gerar em outras partes do sistema.
Seja explícito e prático. Para cada tipo de alteração comum, indique:
- **O que muda aqui** → **Onde impacta no resto do projeto** (mencione módulos, services, controllers, repositories, frontend components, stores, rotas, relatórios, jobs, etc.).
- **Possíveis bugs/regressões** que podem surgir se a mudança não for propagada corretamente.
- **Áreas críticas que devem ser verificadas/testadas** após a alteração.
**Exemplo de redação esperada (adaptar ao módulo real):**
- Adição de um novo campo `statusFinanceiro` na Entity de Cadastro de Caixa:
→ Impacta diretamente o módulo de **Fechamento de Caixa** (Service `FechamentoCaixaService` e cálculo de saldo), **Recebimento de Contas** (validação de contas vinculadas ao caixa), **Relatórios Financeiros** (queries de conciliação bancária) e o componente Vue de Dashboard Financeiro.
→ Risco: fechamento de caixa com valores incorretos ou relatórios com dados desatualizados.
→ Ação necessária: atualizar migration, ajustar todas as ViewModels que consomem Caixa, propagar o campo para os DTOs do frontend e revisar o composable `useCaixaStore`.
- Alteração na regra de validação de limite de crédito no módulo de Vendas:
→ Impacta o fluxo de **Aprovação de Pedidos**, **Contas a Receber** e o job de envio de notificações de inadimplência.
→ Risco de bug: pedidos aprovados indevidamente ou bloqueios falsos positivos.
Se não houver informações suficientes no conteúdo fornecido para identificar impactos concretos, escreva explicitamente:
**"Análise de impactos cruzados não possível com os dados atuais. Recomenda-se consultar a constitution.md e os demais módulos financeiros/operacionais para mapear dependências completas."**
Esta seção deve ser a mais técnica e preventiva possível, funcionando como um “checklist de segurança” para qualquer desenvolvedor que vá mexer no módulo no futuro.
## 14. Sugestões de Melhoria (opcional)
Ideias rápidas para refatoração ou melhorias.
Remova Testes unitários pois não utilizamos isso.
——
**Instruções de Uso:**
Quando eu fornecer:
- Informação sobre o módulo que desejo gerar a documentação.
Você deve:
1. Use linguagem clara, objetiva e técnica (evite fluff).
2. Use tabelas Markdown quando fizer sentido (especialmente para endpoints e modelos).
3. Tente manter o documento entre 800–2000 linhas (conciso mas completo).
4. Não invente informações — baseie-se apenas no conteúdo que eu forneci.
5. Se algo estiver faltando no conteúdo fornecido, mencione explicitamente como "Informação não fornecida".
Depois de gerar o documento completo em Markdown, salve-o na pasta /ai do projeto como nome da funcionalidade.
Agora aguarde meu comando com as informações do módulo que iremos documentar.
Essa documentação nós usamos depois que a feature está pronta e precisamos de dar alguma manutenção ou melhorar alguma outra solução dentro do módulo em questão.
Esse documento não deve ser gerado por feature, mas sim por módulo. Vamos dizer que você tem várias telas que abordam a gestão de usuários no sistema, esse documento deve pegar todas elas. Só quebre isso se o módulo for um GOD Class, são aquelas classes gigantes que ligam o sistema todo. Nesse caso aí quebro ela em várias partes menores.
Takeaway
Tente levantar as tarefas de forma profunda, tentando abordar todos os aspectos que conseguir. Escreva isso num arquivo de pesquisa e gere um plano, por fim passe para que a IA implemente até terminar.
A pesquisa evita que o Claude ou sua IA faça mudanças idiotas e sabemos como as IA tem tido complicações para trabalhar com projetos grandes.
O plano impede que a IA faça mudanças ignorantes e alterações erradas no projeto, uma vez com o Todolist criado nós conseguimos que o plano seja executado sem interrupções.
Para conhecer mais sobre esse ciclo recomendo aprofundar em Spec-Driven Development, alguns links que podem te ajudar nisso:
