CommunityPesquisa e Análise de Dadosgithub.com

Debate de Ações — motor de veredito bull/bear/PM

Mecanismo determinístico de debate entre touro/urso/gestor de portfólio para avaliar uma ação (ou cesta) e produzir um veredito de qualidade para decisão — substituição nativa do framework externo TradingAgents (que depende de crédito). ACIONE quando o usuário quiser uma recomendação de compra/venda/manter, um 'debate esta ação', um 'o que você acha de TICKER', um debate touro-vs-urso, uma verificação de sanidade de valuation, (re)avaliar um nome de SaaS/software, reavaliar um nome após resultados ou atualizar o hub Stock Pool. Construído para software/SaaS mas funciona para qualquer ação. NÃO acione para consultas puras de dados ou rebalanceamento de portfólio (use /rebalance).

O que é bear/PM?

O skill stock-debate é um motor de veredito determinístico e autossuficiente para tomar decisões de compra, venda ou espera sobre ações, com foco em empresas de software/SaaS, mas aplicável a qualquer ativo. Ele substitui frameworks externos como o TradingAgents, eliminando dependências de crédito e garantindo que o veredito seja baseado em dados numéricos rastreáveis e datados (via Alpha Vantage MCP e fallbacks como WebFetch e Robinhood). O processo é rigoroso e composto por cinco etapas: (1) coleta determinística de dados com carimbo de data, (2) verificação da qualidade do crescimento (evitando armadilhas de PEG), (3) três barreiras rígidas (catalisador, momentum e qualidade), (4) debate adversarial entre touro, urso e gestor de portfólio, e (5) pontuação em cinco lentes com um veredito limpo que inclui ponto de entrada, valor esperado e a 'rachadura' restante na tese. O skill é executado no ambiente Cowork (com suporte a scripts locais) e termina na análise — não executa trades. O veredito usa uma taxonomia completa (desde CONVICTION BUY até AVOID) e pode ser escrito de volta em um hub Notion para rastreamento.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AhSirJoe/agentic-investing-stack/tree/HEAD/skill/stock-debate

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

stock-debate — motor de veredito determinístico touro/urso/gestor de portfólio (v2)

Objetivo: maximizar upside absoluto ponderado por probabilidade sujeito a um catalisador realista, datado e momentum construtivo. Barateza sozinha nunca é compra; uma grande queda nunca é compra; um moonshot sem receita/ história de TAM nunca é compra. Produzir um veredito honesto e de qualidade para decisão ao (1) travar os números deterministicamente e carimbá-los com data, (2) verificar se o crescimento é real, (3) passar por três barreiras rígidas, (4) executar um debate adversarial touro/urso/gestor de portfólio, (5) pontuar no framework de 5 lentes, e (6) retornar um veredito limpo com ponto de entrada, valor esperado e a rachadura restante.

Regras rígidas: nunca recomendar compra sem verificar saldo de caixa; nunca operar com margem (caixa ≥ 0). Confirmar detalhes da operação antes de qualquer execução. Este skill TERMINA na análise — não realiza trades.


Etapa 1 — Dados determinísticos PRIMEIRO (fonte da verdade; nunca notícias/memória para números)

Todo preço/múltiplo/trajetória no veredito deve ser rastreável a uma coleta determinística abaixo, e cada métrica deve ter carimbo de data (registrar a data de referência / data do trimestre mais recente). O erro nº1 é um número desatualizado ou mal lido — proteja-o explicitamente: se os dados coletados forem anteriores à data do último balanço da empresa, colete novamente.

Principal no Cowork — MCP Alpha Vantage (estruturado, uma chamada cobre a maior parte da tela):

  • COMPANY_OVERVIEW(TICKER) → P/L futuro, P/L trailing, PEG, EV/EBITDA, EV/Receita, P/S, margens, ROE, Preço-Alvo do Analista + dispersão da classificação, MM50 e MM200, máxima/mínima de 52 semanas, crescimento de receita/lucro, LatestQuarter (usar como carimbo de atualização).
  • EARNINGS_ESTIMATES(TICKER) → estimativas futuras de EPS + receita (para PEG durável, Etapa 2).
  • CASH_FLOW(TICKER) + BALANCE_SHEET(TICKER) → calcular EV/FCF e margem FCF (a lente FCF-primeiro).
  • EARNINGS_CALENDAR / data de resultados → o relógio da barreira do catalisador.
  • RSI, MACD, ADX (e SMA 50/200 se não estiver na visão geral) → a barreira do momentum.
  • NEWS_SENTIMENT(TICKER) → catalisadores recentes / sentimento.
  • Orçamento: chave gratuita = 25 requisições/dia, ~1/segundo. Processar em lote ≤ 20 nomes/dia, espaçar chamadas e carimbar Métricas Atualizadas. Reservar chamadas para a shortlist de análise aprofundada; não atualizar todas as ~100 de uma vez.

Fallback / verificação cruzada — WebFetch (rota através do serviço de busca da Anthropic; gratuito, sem necessidade de autorização):

  • Tela de valuation → https://stockanalysis.com/stocks/TICKER/statistics/ (preço, P/L futuro, PEG, EV/FCF, EV/EBITDA, P/S, margem FCF, margens, ROE). NOTA: esta página geralmente é renderizada com JS — se o WebFetch retornar um shell, escalar para as ferramentas Chrome ou confiar na coleta do Alpha Vantage.
  • Visão geral / trajetória de receita → .../stocks/TICKER/ e .../financials/?p=quarterly (últimos ~6 trimestres de receita + YoY% → Acelerando / Estabilizando / Desacelerando).
  • Arquivos 20-F / ADR estrangeiros sem página → WebSearch no último release de RI.

Preço ao vivo e opções → o conector Robinhood (get_equity_quotes, get_option_chains; conectado à conta, funciona no Cowork). Usar Robinhood para o print atual; o fechamento do Alpha Vantage pode defasar.

Macro/regime → WebSearch "SPY vs média móvel de 200 dias [mês ano]" (BULL acima / BEAR abaixo); também observar VIX e a tendência do juro de 10 anos (software de longa duração é sensível a juros). Nunca citar um catalisador macro de memória — verificar o ano.

Alternativa local (máquina com HTTP de saída, não Cowork): python scripts/finnhub_metrics.py TICKER e python scripts/cohort_trajectory_sec.py TICKER (trajetória XBRL da SEC; caminhos relativos à raiz do repositório). O sandbox do Cowork bloqueia HTTP de saída de python/curl, portanto os scripts são apenas locais.

Nota sobre PEG futuro: o PEG/P/L futuro da tela é uma tela apenas — a Etapa 2 recalcula o PEG durável com base na taxa de crescimento orgânico futuro proveniente do release de resultados real.


Etapa 2 — Verificação de qualidade de crescimento / ARMADILHA DE PEG (etapa de maior valor)

Um PEG baixo baseado em crescimento inflado ou baseado em passado é uma armadilha. Antes de confiar em qualquer múltiplo, recalcular o PEG com base no CRESCIMENTO FUTURO DURÁVEL. Eliminar: pull-forwards pontuais / licenças de prazo / reconhecimento EOL; crescimento inflado por M&A (encontrar a taxa ORGÂNICA ex-aquisição); crescimento de volume de PAGAMENTOS (usar GP/ARR recorrente, não receita mesclada); ganhos de margem pontuais que inflam o EPS; receita de float / juros que se inverte quando os juros caem.

PEG durável = P/L futuro ÷ % de crescimento futuro durável. Se PEG durável ≫ PEG da tela, a tese "barato" falha. Puxar NRR / RPO / orgânico ex-M&A do release de resultados principal / 8-K / transcrição (WebSearch / Tavily), nunca de um resumo de notícias. EV/EBITDA é frequentemente n/d para SaaS pré-EBITDA — apoiar-se em EV/FCF + margem FCF. Quando o FCF é negativo, EV/FCF também é n/d → exigir um caminho datado e crível para o FCF e julgar EV/S contra o crescimento durável; se o único suporte for narrativa de TAM, falha no piso de qualidade (Etapa 2.5c).


Etapa 2.5 — TRÊS BARREIRAS RÍGIDAS (uma COMPRA deve passar por todas as três)

Elas codificam o objetivo. Um nome que falhar em qualquer barreira não pode ser uma COMPRA — limitar a ESPERAR/MANTER/EVITAR.

(a) Barreira do catalisador. Deve haver um catalisador concreto, datado e realista dentro de ~2 trimestres (resultados, lançamento de produto, contrato/PPA, decisão regulatória, cadência de elevação de guidance). "Barato e paciente" não é um catalisador. Sem catalisador → veredito máximo = ESPERAR (ou MANTER se já possui por mérito).

(b) Barreira do momentum. NÃO iniciar uma COMPRA em uma tendência de queda confirmada — ou seja, preço abaixo de uma MM50 cadente E MM50 < MM200 (cruz da morte), ou RSI < ~40 com MACD negativo. Uma grande queda é motivo para cautela, não sinal de compra. Tais nomes são ESPERAR com um gatilho de retomada explícito (ex.: "comprar na retomada da MM50 a $X com volume"). Construtivo = preço ≥ MM50 ascendente, ou MM50 ≥ MM200, ou consolidação com RSI 45–65 virando para cima. (Momentum é timing para saídas/reduções, mas uma barreira para entradas.)

(c) Piso de qualidade / moonshot. EVITAR se: pré-receita ou sem caminho para lucro; FCF negativo sem caminho datado crível; valuation justificado apenas por TAM/história; ou um produto único subescala. Limita a cauda especulativa independentemente de quão grande o "upside" pareça.

Compounders duráveis de megacap (tipo CRM/NOW/WDAY/PANW) recebem benefício da dúvida de relevância estendida na barreira do momentum; o sinal de morte para eles é crescimento desacelerando, não uma oscilação de preço.


Etapa 3 — Executar o debate touro/urso/gestor de portfólio

Para 1–2 tickers, raciocinar inline. Para uma cesta, usar subagentes Opus, pipeline por ticker: parallel(touro, urso) → gestor. Cada agente recebe os números TRAVADOS e com carimbo de data (não pode alucinar preço/valuation) e pode usar WebSearch APENAS para catalisadores recentes.

  • Touro — caso longo mais forte baseado em evidências: fosso/gargalo + poder de precificação, crescimento durável, o catalisador datado e a configuração de momentum.
  • Urso — caso mais forte contra: comoditização/risco de participante, desaceleração, disrupção, valuation, ruptura técnica/momentum, governança, o binário que poderia quebrá-lo.
  • Gestor de portfólio — atribuir probabilidades aos cenários touro/base/urso, calcular um valor esperado (VE) probabilístico para ~12 meses e a assimetria, verificar as três barreiras e então decidir.

Etapa 4 — Pontuar nas 5 lentes (gargalo primeiro)

  1. Gargalo vs participante (primário) — possui um gargalo de oferta/demanda com poder de precificação (sistema de registro, gravidade de dados, custo de troca) vs um participante comoditizável. Participante barato = armadilha de valor; gargalo durável = ganha seu múltiplo.
  2. Trajetória (2ª derivada) — Acelerando / Estabilizando / Desacelerando.
  3. Crescimento absoluto — nível real de % YoY vs pares de mesmo porte.
  4. Valuation (FCF primeiro) — PEG durável (Etapa 2), margem FCF, EV/FCF sobre Regra dos 40.
  5. Momentum (BARREIRA para entradas; contexto para saídas) — Posição e inclinação MM50/200, RSI/MACD, posição em 52 semanas. De acordo com o objetivo, isso é uma barreira para novas compras, não um desempate. → Balde de bifurcação IA: Acelerador / Sobrevivente / Disruptado.

Etapa 5 — Veredito (folha limpa) + VE + a rachadura

Julgar cada nome como se não possuísse nenhum: "eu iniciaria hoje, a este preço?" Possuir é uma nota fiscal. Uma COMPRA exige: todas as três barreiras superadas + VE ponderado por probabilidade para 12 meses ≥ ~+20–25% com assimetria positiva. Classificar COMPRAS por VE.

Taxonomia (mapeada para a Decisão do hub Stock Pool):

VereditoDecisão do HubSignificado
COMPRA CONVICTACompra ConvictaMaior VE, todas as barreiras, gargalo durável a um preço justo para crescimento durável
COMPRACompraPossuir hoje; barreiras superadas; meta de VE atingida
ACUMULAR / ESCALARAcumularQualidade que você quer, mas entrar em etapas (momentum ainda não construtivo, ou em uma zona de entrada definida)
ESPERARObservarNome certo, nível/timing errado — dar o gatilho explícito de entrada/retomada
MANTERManterPossuído, manter por mérito, não adicionar
REDUZIR (manter núcleo)ReduzirDurável mas estendido/caro e ainda crescendo → ajustar tamanho, não sair
DIMINUIRReduzir / Vender-SairEstendido e desacelerando, ou tese quebrada → vender parte/sair
EVITAREvitarParticipante / armadilha de valor / preço-não-fosso / moonshot

Terminar com:

  • A rachadura — a tese é à prova de balas, ou há uma rachadura restante? Diga a única coisa que mais a ameaça.
  • Entrada / tamanho — nível(níveis) de entrada; tamanho por regime (menor em BEAR), convicção, e adequação ao portfólio (penalizar adicionar a um fator já concentrado — ex.: se o livro já está concentrado em um tema, um novo nome nesse tema compete com essa concentração). Nunca exceder caixa; nunca usar margem.
  • Monitorar (o que inverte isso) — a métrica única cuja mudança reverte o veredito.
  • Direcionadores de confiança — MENOR para: cobertura fraca, arquivos 20-F estrangeiros, NRR não divulgado, binário pré-resultados, distorção pesada de M&A/pagamentos/float, ou dados mais antigos que o último balanço.
  • Ponto no tempo — carimbar a data do veredito; reexecutar no próximo balanço.

Triangular o alvo — não confiar apenas no Preço-Alvo do Analista sell-side (defasado/otimista, e descontá-lo quando a dispersão de classificação for ampla). Verificar cruzado com DCF reverso ou EPS futuro × múltiplo justificado.


Escrever de volta no Stock Pool — Hub Mestre

Se o usuário mantiver o hub Notion, oferecer para atualizar a linha por nome, mapeando: Decisão (taxonomia acima) · P/L Futuro · PEG (durável) · % Upside Alvo · Tendência (Alta/Mista/Baixa da barreira de momentum) · Último Preço + Preço Verificado em (Robinhood) · Métricas Atualizadas em (Alpha Vantage LatestQuarter/hoje) · Racional (tese em uma linha + a rachadura) · Métricas-Chave (PEG durável, EV/FCF, margem FCF, crescimento). Sempre carimbar as datas de atualização para que a desatualização seja visível. O título da página de análise por nome permanece TICKER — YYYY-MM-DD — VEREDITO.

Habilidades Relacionadas