Communitygithub.com

george351419-sys/Portfolio-Watch-Skill

Uma habilidade reutilizável de Monitoramento de Portfólio para Alva — transforma qualquer portfólio em um painel ao vivo + alertas silenciosos e ranqueados. Observa a tese de compra, não apenas o mercado. Construído sobre Alva, backtestado com dados de 5 anos e ao vivo.

O que é Portfolio-Watch-Skill?

Esta habilidade transforma uma solicitação simples como 'monitore minhas ações NVDA, TSLA, AAPL e me avise quando algo grande acontecer' em um 'Playbook de Monitoramento de Portfólio' hospedado. Ele fornece uma interface que o usuário abre para ver o que está acontecendo com seus investimentos, além de alertas push silenciosos e ranqueados que chegam ao telefone e vinculam de volta ao cartão correspondente. Projetado para funcionar em qualquer portfólio que o usuário nomeie, sem codificação rígida de limites percentuais. Em vez disso, todos os testes de anomalia são medidos em relação à linha de base estatística de cada ativo e ao desempenho do mercado e do setor no dia. A habilidade se integra perfeitamente ao ecossistema mais amplo do Alva, utilizando feeds de dados nativos e o módulo de carteira do Alva para ler automaticamente as participações reais do usuário a partir de corretoras conectadas. O monitoramento é organizado em camadas: movimentos anormais de preço e volume, eventos e arquivamentos, sentimento narrativo, posicionamento de insiders e indicadores macro que afetam o portfólio. O resultado é um sistema de inteligência de investimento pessoal que separa sinais materiais do ruído do mercado. A habilidade é uma estrutura metodológica que dita o que monitorar e o que relatar, enquanto utiliza os blocos de construção do Alva para execução mecânica.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add george351419-sys/Portfolio-Watch-Skill

Perguntar na sua IA favorita

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

Documentação

Monitor de Portfólio (Portfolio Watch)

Transforme uma solicitação de uma linha como "monitore minhas NVDA, TSLA, AAPL e me avise quando algo grande acontecer" em um Playbook de Monitoramento de Portfólio hospedado: uma interface que o usuário abre para ver o que está acontecendo com suas participações, além de alertas push silenciosos e ranqueados que chegam ao telefone e vinculam de volta ao cartão correspondente.

Esta habilidade é um modelo metodológico. Ela não substitui os mecanismos de construção do Alva — ela os direciona. O Alva possui os primitivos (Habilidades de Dados, feeds em tempo de execução, Altra, alpi, lançamento de playbook, push). Esta habilidade possui o julgamento de monitoramento: dimensões, limites, filtros de ruído e ranqueamento. Quando os dois entrarem em conflito sobre mecânica, siga a habilidade alva; sobre o que monitorar e o que dizer, siga este arquivo. O objetivo do produto é sinal, não cobertura — separe os sinais de investimento materiais do ruído do mercado para um portfólio que nunca viu antes.

Princípio Central: Todo Limite é Relativo

Não existem limites percentuais fixos. NVDA caindo 3% é um dia normal; Coca-Cola caindo 3% é notícia. A habilidade funciona em um portfólio desconhecido porque cada teste de anomalia é medido em relação à própria linha de base estatística da participação e em relação ao que o mercado e seu setor fizeram hoje, calculado na configuração. Este é o motor de reutilização inteiro — acerte isso e o resto flui.

Ordem de Construção (mapear para primitivos do Alva)

Siga o início da sessão e as portas da habilidade alva. A ordem específica da habilidade é:

  1. Captação — analisar participações, pesos, intenção, canal de alerta, horizonte de tempo.
  2. Feed de perfil — linha de base por participação + roteamento de benchmark (o motor de reutilização). Construa-o primeiro; todos os limites são lidos dele.
  3. Feed(s) de monitoramento — as camadas de monitoramento, emitindo sinais pontuados.
  4. Interface do Playbook — HTML de leitura ao vivo, quatro abas (Monitoramento / Incidente / Tese / Fórmulas — veja §A Interface); Tese e Fórmulas são obrigatórias, não opcionais.
  5. Carona de alerta — notify/message push, silencioso por padrão, com link direto.
  6. Lançamento + verificação — lançar, capturar tela, ativar alerta, confirmar uma execução real.

Use as Habilidades de Dados do Alva para cada número, @alva/feed para persistência, FeedAltra para matemática de nível de portfólio (pesos, drawdown, correlação, contribuição), @alva/pi para narrativa de uma linha e o fluxo de push de references/push-notifications.md. Nunca codifique valores financeiros diretamente em HTML.


Etapa 0 — Integração e Pré-verificação (execute primeiro, a partir de uma linha)

Um usuário geralmente invoca esta habilidade a partir de um agente local novo sem nada configurado e diz uma linha — "monitore minhas NVDA, TSLA, AAPL e me avise sobre grandes movimentos." A partir dessa linha, conduza proativamente toda a configuração e construção — não faça o usuário configurar as coisas manualmente e não peça especificações que você pode definir como padrão. Antes de construir, verifique silenciosamente três pré-requisitos e guie o usuário apenas onde algo estiver faltando:

  1. Habilidade Alva base disponível? Esta habilidade declara builds_on: alva e precisa dos primitivos da plataforma Alva (feeds, lançamento de playbook, push). Se o agente não conseguir alcançar as ferramentas de construção do Alva, diga ao usuário para instalá-las uma vez e depois tentar novamente: npx skills add https://github.com/alva-ai/skills.
  2. Conectado ao Alva? O Playbook é criado sob a própria conta do usuário e os alertas são entregues a ele, portanto ele deve estar autenticado (alva whoami para verificar; alva auth login se não estiver). Guie o login único, se necessário.
  3. Canal de alerta conectado? Para que os pushes cheguem ao telefone, o usuário precisa de um active_channel (Discord / Telegram / Slack) vinculado em alva.ai/settings. Verifique alva whoami (active_channel); se não houver, anote agora, mas não bloqueie a construção — lembre novamente logo após o primeiro alerta estar pronto.

Em seguida, apenas construa: analise a linha (Etapa 1), configure os feeds de perfil + monitoramento e a interface, e conecte os alertas ao usuário (veja Os Alertas → Entregar a este usuário). Relate em uma linha: "Monitorando NVDA/TSLA/AAPL · interface: <link> · alertas → seu <canal>." Faça no máximo uma pergunta bloqueadora, e somente se for realmente ambígua. Defina tudo o mais como padrão (peso igual, sensibilidade Padrão, horizonte de longo prazo).

Etapa 1 — Captação (funciona em um portfólio desconhecido)

Extrair: tickers/ativos, ações ou nocional, pesos, base de custo, estilo de monitoramento, canal de alerta, fuso horário, horizonte de tempo.

Caminho preferencial de entrada zero — puxar o portfólio real do usuário. O Alva possui um módulo de Portfólio nativo (contas de corretora / cripto conectadas via TREX + SnapTrade). Se o usuário disser "monitore meu portfólio" e tiver uma conta vinculada, não peça para ele digitar tickers — leia as posições diretamente e preencha o conjunto monitorado:

  1. alva portfolio accounts → lista contas conectadas (trex:… / snaptrade:…). Se houver várias, pergunte qual (ou monitore todas, unidas).
  2. alva portfolio summary --account-id <id> → participações + saldo. Mapeie cada posição para {symbol, name, weight (de market value / total), sector} e escreva-a na configuração do conjunto monitorado (abaixo). Os pesos vêm gratuitamente dos saldos reais, então a classificação é exata em vez de peso igual.
  3. Confirme a lista resolvida de volta ao usuário em uma linha antes de monitorar; então o feed perfilha automaticamente cada nome (§Etapa 2) e as instruções da tese seguem.
  4. Sincronizar sob solicitação — "sincronizar meu portfólio" relê as contas e faz o diff em relação à configuração (novas compras adicionadas, saídas totais removidas); alva portfolio activities fornece a trilha de negociação recente. Isso é executado no Agente sob a própria identidade do usuário — um feed headless não pode se passar pelo usuário, portanto a atualização é acionada pelo usuário (ou via um token restrito armazenado), nunca uma busca silenciosa em segundo plano. Se nenhuma conta estiver vinculada, volte para a captação manual abaixo.

Padrões quando ausente:

  • Pesos — peso igual; rotule as estimativas de impacto no portfólio como aproximadas. Os pesos afetam apenas a classificação, nunca se uma anomalia é detectada.
  • Estilo de monitoramento — Padrão (P0 imediato, P1 digerido, P2 apenas na interface).
  • Horizonte de tempo — longo prazo; enfatize fundamentos, eventos, liquidez, arquivamentos e impacto no portfólio em vez de pequenos movimentos técnicos.
  • Ticker ambíguo — resolva para o título listado nos EUA mais provável com getStockCompanyDetail. Faça no máximo uma pergunta bloqueadora, e somente quando a ambiguidade mudar o tipo de ativo ou o modelo de monitoramento.

Não resolva nada silenciosamente: se um símbolo não resolver, informe o usuário e continue com o restante.

Capture qualquer tese declarada. Se o usuário disser por que ele mantém algo ("MSTR como uma jogada alavancada de BTC", "NVDA para superar os semicondutores"), analise e armazene como uma tese por participação (holding · relation · reference · direction) — ela direciona o monitoramento vinculado à tese (§Vinculado à Tese). Opcional; a ausência significa apenas o modelo de mercado padrão.

O conjunto monitorado é uma configuração de propriedade do usuário (adição/remoção dinâmica)

A lista de tickers monitorados não é codificada — é uma configuração que o usuário possui (ex.: ~/feeds/pw-config/v1/holdings.json: [{symbol, name, weight, sector, thesis?}]). Pode ser preenchida automaticamente a partir do Portfólio Alva conectado (§Etapa 1 caminho de entrada zero) ou preenchida manualmente. Os feeds leem-na em tempo de execução, portanto alterar o que é monitorado nunca precisa de uma mudança de código:

  • Adicionar / remover a qualquer momento — duas maneiras, mesma configuração. (a) Fale com o Agente ("monitore também COIN", "pare de monitorar TSLA"); ele edita a configuração. (b) Faça isso na UI do Playbook: uma UDF (updateWatchlist) registrada permite que a caixa de pesquisa adicione um ticker e um ✕ em um chip remova um, escrevendo diretamente na configuração (sem cobrança; visualizadores não autenticados veem um prompt de login). Na adição, a UDF calcula a análise σ do novo ticker na hora e a retorna, para que a interface mostre o movimento/z_idio/tier do nome adicionado imediatamente; o perfilhamento completo + alertas seguem na próxima execução agendada. Verificado ao vivo: NVDA/TSLA/AAPL/MSTR → +COIN (evidência computada ao vivo, tese aplicada automaticamente) → −TSLA, por edição de configuração e por UDF.
  • Novos nomes recebem o tratamento completo automaticamente — um ticker recém-adicionado é perfilhado (sua própria linha de base σ/β/σ_ε), e se for recém-listado, entra no caminho de inicialização a frio (§Inicialização a Frio). Este é o requisito de reutilibilidade tornado operacional: a Habilidade funciona em qualquer conjunto que o usuário nomeie, e o conjunto está ao vivo.
  • Pesos são opcionais (padrão peso igual); thesis por participação é opcional.

Etapa 2 — Feed de Perfil (o motor de reutilização)

Antes de monitorar qualquer coisa, construa um feed que persista um perfil por participação a partir da configuração acima, usando o histórico das Habilidades de Dados. Isso é o que torna os limites relativos e o roteamento correto.

Por participação, calcule e armazene:

CampoFonte / métodoUsado para
asset_typedetalhe da empresa/ativoquais modelos se aplicam
sector, industrydetalhe da empresamodelo de setor + benchmark
sigma_ewma, sigma_mad, sigma_epsEWMA(λ=0.94) vol, piso robusto 1.4826·MAD e vol residual (idiossincrática) √(σ²−β²σ_m²)denominadores de z-score (§Etapa 4)
avg_vol_20d, avg_dollar_vol_20d (hora do dia se intradiário)histórico de volumeRVOL / giro / liquidez
free_floatdados de propriedadedenominador de giro
beta, primary_benchmark, sector_benchmark, peer_basketregredir nos benchmarks (veja Apêndice A)remoção de ruído de mercado/setor
liquidity_bucket, volatility_bucket, market_cap_bucketderivadosrigor da confirmação
options_available, short_interest_available, crypto_exposureflags de capacidadequais confirmadores ativam
earnings_next, ex_div_next, event_calendarendpoints de calendárioagendamento de eventos
week52_high, week52_lowklinessinais de marco

Atualize em uma cadência lenta (diária/semanal). Todos os limites downstream são lidos deste feed — mude o portfólio e as mesmas regras se reajustam automaticamente. Para nomes recém-listados ou com baixa liquidez, exija evidências mais fortes e marque a confiança como mais baixa.

Tipos de ativo a reconhecer: ação ordinária, ADR, ETF/ETP, fundo fechado, REIT, BDC, MLP, preferencial, SPAC/pós-SPAC, ativo cripto, ações vinculadas a cripto (exchanges, mineradores, empresas de tesouraria, corretoras, proxies de stablecoin/pagamento — COIN, MSTR, MARA, RIOT, CLSK, HOOD), outro título listado. Se uma participação abranger modelos, aplique todos os materiais e marque o direcionador principal.

Etapa 3 — O Que Monitorar (modelo em camadas)

Organize por por que um investidor se importa, não pela fonte de dados. Monitores universais se aplicam a cada participação quando os dados existem; modelos adicionam inteligência específica do ativo.

Camada A — Preço, desempenho relativo, liquidez (poll intradiário/por hora)

SinalDefinição (relativa)Função
Movimento anormalz = day_return / sigma_20d (também 5d/1m/YTD, gap, abertura-para-fechamento)central
Movimento residualresidual = ticker_return − explained_market_sector_move; sinalizar quando mercado+setor explicam menos da metade do movimentocentral
Relativo ao setorz de (ticker_return − sector_benchmark_return) ≥ 2.0central
Anomalia de volumeRVOL = vol / avg_vol (ajustado por hora do dia); 2× notável, 3× forte, 5×+ catalisador importante. 5×+ é frequentemente climático/exaustão, não continuação — leia com a direção do preçoconfirmador
Girovol / free_float ≥ 2× mediana de 60d ou > 90º percentil; alto giro + avanço fracassado após boas notícias = distribuiçãoconfirmador
Estresse de liquidezspread bid-ask > 90º percentil para um nome líquido; paradas, LULD, SSRconfirmador
Quebra de faixaquebra de 20/50/200 dias com confirmação de volume, ou máxima/mínima de 52 semanas, máxima históricafraco
Tendência lentaN dias consecutivos de queda, ou movimento acumulado em 5 dias > 2σ (não significativo diariamente, significativo cumulativamente)lento

Camada B — Eventos e arquivamentos (orientado por calendário/arquivamento; muitos são conhecíveis antecipadamente)

  • Resultados: lembrete pré-anúncio (T−1/2) + resultado vs. estimativa + mudança de guidance.
  • Dividendos / desdobramentos / cisões / ex-dividendos; mudanças de índice; rebalanceamento de ETF.
  • Arquivamentos e propriedade: 8-K eventos materiais, 10-Q/10-K, linguagem de continuidade operacional, mudança de auditor/arquivamento tardio, reafirmações, financiamento/diluição (S-1/S-3/424B/ATM, conversíveis, ofertas secundárias), Formulário 4 transações de insiders, participações ativistas 13D. Melhore compras de insiders em mercado aberto, compras de executivos em cluster, financiamento para nomes que queimam caixa, 13D ativista. Construído (v1): uma sobreposição de Posicionamento de smart-money conta compras/vendas discricionárias de Form-4 em mercado aberto (10b5-1 excluído); um cluster de insiders (ou o CEO) comprando é um confirmador + um alerta de divergência de alta quando o preço está fraco — mostrado como contexto do portfólio, nunca um push por ação. Rebaixe vendas de rotina 10b5-1 e ajustes mecânicos de desdobramento/dividendo.
  • Lockup / unlocks PIPE (SPACs), risco de resgate.
  • Calendário macro (FOMC, CPI, taxas, dólar, petróleo) apenas quando o portfólio é sensível (beta alto ou setores expostos a taxas/commodities) ou várias participações compartilham a exposição — caso contrário, é ruído para este usuário.

Camada C — Informação e narrativa (orientada por notícias, não conhecível antecipadamente)

  • Notícias materiais da empresa: M&A, litígios, ação regulatória, mudança executiva, grande falha/recall de produto (Habilidades de Dados notícias + unified_search para contexto).
  • Mudanças de estimativa e classificação — agregadas, nunca por linha: uma pequena revisão é ruído; um grande cluster de revisões na mesma direção, ou uma mudança de alvo com uma mudança de estimativa/tese, é um sinal.
  • Exija múltiplas fontes confiáveis; suprima notícias velhas republicadas, rumores de fonte única e comentários genéricos de mercado. A velocidade social é um sinal fraco apenas.
  • Ciclo de semicondutores (índice de memória TrendForce DXI) — construído (v1) como uma sobreposição de contexto do setor: tendência DXI vs. suas MAs de 30/60 dias = um vento a favor/contrário do ciclo de memória mapeado para participações de semicondutores (mais direto para nomes de memória; uma leitura de ciclo ampla para GPU/AI via HBM). Fluxos de fundos do setor (rotação) e momentum de revisão de estimativa de consenso são especificados como confirmadores convencionais.
  • Mercados de previsão (Polymarket) como um sinal de evento estruturado — para eventos com um mercado líquido (decisões do Fed, eleições, alguns catalisadores), um movimento brusco na probabilidade do evento é uma re-precificação quantificada e muitas vezes precoce.
  • Nota de implementação na v1: a fonte de dados é getPolymarketMarketData com o parâmetro de slug mapeado do calendário de eventos; o monitoramento é orientado por gatilhos (verificar na programação quando um evento se aproxima) ou sob demanda se um ticker do evento for referenciado. A saída é anexada ao cartão do evento na aba Incidente, não como um alerta separado (a menos que uma grande oscilação de probabilidade ocorra sem uma notícia correspondente).
  • Sinais macro de inflação (CPI/PPI/rendimentos) vs. posicionamento do portfólio — construído (v1) como uma sobreposição de sensibilidade macro: para portfólios com alta exposição a ativos sensíveis a taxas (imobiliário, fintech, crescimento/precificação com base em DCF longo), a lacuna entra a leitura real do CPI/PPI e o consenso pré-liberação, combinada com a mudança de rendimento de 2/10 anos após a liberação, é sinalizada como contexto (nunca um alerta autônomo). Se várias participações se moverem correlatamente com um choque macro inesperado, a aba Incidente mostra o driver comum em vez de alarmes individuais.

Camada D — Posicionamento tático e inteligência de fluxo (convites de API estruturados)

  • Contexto de opções: para nomes com opções líquidas (veja perfil), a diferença IV vs. RV (volatilidade realizada) no gráfico de termo de 30 dias; garupa de opções (chamadas em aberto vs. colocadas em dinheiro). Esses são telas de configuração fracas, não alertas autônomos — eles qualificam o movimento do preço de uma ação: um pico de preço com garupa de opção calma não merece escalonamento.
  • Posicionamento institucional: mudanças trimestrais 13F em participações totais ou novas entradas proeminentes de gestores conhecidos (filtradas para evitar 'ruído de rebalanceamento'). Alimentado pela fonte de dados SEC 13F.
  • Dados de deslocamento (apenas v2): estrutura de mercado EUA vs. ex-EUA ponderada pelo portfólio; exposição cambial; deslocamento do setor de fatores de estilo (valor, momentum, baixa volatilidade).

Etapa 4 — Classificação de Alerta (o que aciona e onde ele pousa)

Nem todo sinal é um alerta. O trabalho da habilidade é ranquear a relevância, não despejar. Cada sinal recebe uma pontuação de prioridade (0-1000) e é colocado em um nível de urgência (P0, P1, P2), que determina se ele aparece como um push, um resumo ou apenas no painel.

Metric-based: pontuação = z_idio (movimento residual) × fator de ponderação. Para qualquer sinal, a probabilidade de alerta não é um limite fixo, mas uma função do quão incomum é para este ativo e quão importante é para o portfólio:

  • z_idio = movimento residual (idiossincrático / próprio) padronizado: o retorno do ticker menos a parte explicada por mercado + setor, dividido pelo desvio padrão residual (sigma_eps). Este é o denominador central. Quanto maior o |z_idio|, mais o movimento precisa de explicação. Para-choque em 6 para evitar dominância de cauda. Nota: z_idio é distinto do z-score de retorno bruto — ele é ajustado para exposição de mercado/setor, portanto Ações em alta beta não acionam falsos alarmes quando o mercado cai.
  • weight = ponderação do ativo no portfólio (0..1, de pesos reais ou padrão igual).
  • Pontuação = |z_idio| × (1 + weight × 3). (Um movimento de 3σ em uma posição de 20% = 3 × (1+0.6) = 4,8; mesmo movimento em uma posição de 2% = 3 × (1+0.06) = 3,18.)
  • Ajuste na v1: se o sinal for acionado por um evento negociável conhecido (resultados, CPI, arquivamento de insider, compra ativista), multiplique por 1,3 (o usuário pode agir). Se o sinal for puramente técnico sem catalisador óbvio, multiplique por 0,7 (o usuário provavelmente não agirá).

Níveis de urgência:

NívelFaixa de pontuaçãoAção
P0 — Imediato≥ 4.0Push com link direto para o cartão do ativo; resumo curto; notificação de telefone.
P1 — Digerido2.0 – 3.99Agrupado no push do próximo resumo periódico (horário/diário dependendo do estilo do usuário); nunca um push autônomo a menos que combinado com outros sinais para a mesma participação.
P2 — Apenas no painel< 2.0Mostrado na aba Incidente, mas nunca enviado como notificação. Os usuários que procuram detalhes no painel o veem; a caixa de entrada silencia.

Nota: P0 vs. P1 também leva em conta se o sinal pode ser explicado por um evento agendado conhecido (ex.: movimento de 4σ nos resultados é de alto interesse, mas o usuário pode vê-lo chegando). A habilidade atenua P0s esperados para P1, a menos que o resultado se desvie materialmente da faixa prevista.

Etapa 5 — A Interface

O Playbook tem quatro abas, Todas obrigatórias para todos os portfólios:

  • Monitoramento — grade cartão-visualização de cada participação; mostra movimento de 1d, sinalizadores de alerta de camada, tese e setor. Cada cartão é vinculável (clique abre a aba Incidente para aquele ativo).
  • Incidente — feed de sinal cronológico, com cartões de evento (cada um vinculável a um ativo). Um cartão deve ser o incidente principal (o sinal mais pontuado no período); outros ficam abaixo. Teoria e Fórmulas estão disponíveis dentro de cada cartão como uma seção sanfonada quando aplicável.
  • Tese — para cada participação, a tese declarada do usuário + seu status atual em relação a essa tese (Intacta / Desafiada / Viola / Catalisada). Se a participação foi adicionada sem tese, uma caixa de entrada "Descreva por que você possui isso" com alguns exemplos de modelos de uma linha. Veja §Vinculado à Tese.
  • Fórmulas — exposição translúcida de como as pontuações e os limites funcionam, para que o usuário possa auditar a lógica ("z_idio = retorno residual / sigma_eps; ..."). Se um sinal de alerta específico surpreender o usuário, esta aba responde "por que" e lhe dá permissão para ajustar (veja §Ajustes).

A aba Incidente tem três modos de visualização (botão de alternância, lembrete de sessão):

  1. Agrupado por ativo (padrão) — uma seção por ativo; cartões classificados por pontuação dentro de cada ativo; o ativo com a maior pontuação agregada fica no topo. Melhor para usuários que pensam por participação.
  2. Linha do tempo — todos os sinais em ordem cronológica com o ativo rotulado. Melhor para compreensão geral do mercado.
  3. Agrupado por camada — Camada A (preço) / B (eventos/arquivamentos) / C (narrativa) / D (posicionamento). Melhor para entender a fonte do ruído.

Vinculado à Tese

Se o usuário forneceu uma tese para uma participação (ou uma é inferida do contexto de sua adição), a interface a mostra e a monitora:

  • Estado da tese: derivado de dados de movimento do ativo + evento em relação à direção da tese (alta/baixa). Se a tese para NVDA é "vencer os semicondutores" e a NVDA está caindo enquanto o setor sobe, o estado da tese muda para Desafiada e o cartão da aba Monitoramento mostra isso imediatamente — sem esperar que a pontuação de alerta atinja P0.
  • Mudança de estado aciona um cartão de Incidente (nível P1, a menos que combinado com um movimento de preço P0, então P0). O cartão diz "Sua tese (NVDA → vencer os semicondutores) está sendo desafiada: NVDA -2%, setor +1,5% hoje. Confira."
  • A tese alimenta prioridade: um movimento que contradiz a tese do usuário é 1,2× mais provável de ser escalado do que um movimento que a favorece (viés de aversão à perda).
  • A coluna Tese na aba Monitoramento tem um pequeno indicador de saúde (🟢 Intacta / 🟡 Desafiada / 🔴 Viola).

Ajustes

Um formulário de ajuste está disponível na aba Fórmulas (ou em um diálogo no nível do portfólio) que permite ao usuário:

  • Ajustar o limite P0/P1 (multiplicador global: "Mais alertas" / "Menos alertas" — escala a faixa de pontuação; Padrão = 1,0; 0,5 = alerta com metade da evidência; 2,0 = alerta com o dobro da evidência).
  • Por ativo: um controle deslizante de sensibilidade (mais/sensível/padrão/menos/desligado).
  • Ocultar camadas: desativar Camada A Price, Camada D Positioning etc. para todo o portfólio ou por ativo.
  • Visualizar amostra: "Mostre-me como teria sido o alerta para meus ativos na semana passada" (reproduzir sinais passados da programação).

Aba de Resumo do Portfólio (uma quinta aba, se forem dados suficientes)

Se o usuário forneceu pesos de ativos (ou eles foram puxados do módulo de portfólio Alva conectado → pesos exatos), o Playbook ganha uma quinta aba Resumo que mostra métricas de nível de portfólio:

  • Retorno do portfólio hoje desde o fechamento anterior (ponderado por peso).
  • Drawdown do portfólio do pico histórico (se os preços de custo/base estiverem disponíveis) ou do pico de 52 semanas.
  • Concentração do portfólio (Índice Herfindahl do maior N ativos, com um alerta de texto se o ativo principal > 20%).
  • Exposição setorial (alocação agregada em setores GICS com quem está liderando/ficando para trás hoje).
  • Beta do portfólio (ponderado pelo beta de cada ativo do feed de perfil — aproximado, mas estável).
  • Correlação: matriz pareada dos 10 maiores ativos; um aviso se a correlação média pareada for alta > 0,7 (baixa diversificação).
  • Contribuição: quais ativos estão impulsionando o retorno e o risco do portfólio na data de hoje e no acumulado do mês.

Nota: Retorno do portfólio requer que os preços de compra sejam conhecidos ou que o usuário forneça a base. Se faltar a base, mostre o movimento intradiário do portfólio e rotule as métricas de retorno como aproximadas.

Etapa 6 — Os Alertas

Propriedade

Esta habilidade tem um conceito de assinante de alerta: um usuário que invocou a habilidade e para quem os alertas devem ser entregues. Alerte o assinante, não qualquer feed ou canal configurado manualmente. Se a habilidade for executada por um agente em nome de um usuário autenticado (alva whoami → [email protected] com active_channel: discord), os alertas vão para o canal desse usuário. Se vários usuários usarem o mesmo Playbook, cada um vê o mesmo painel, mas os alertas são endereçados ao seu próprio canal se eles estiverem autenticados ao invocar o alerta? Resposta na v1: um assinante. Se mais forem necessários, adicione uma matriz de assinantes na configuração.

Classificação

  • A classificação de alerta usa a métrica da Etapa 4: pontuação = |z_idio| × (1 + weight × 3), com o multiplicador de evento/catalisador (1,3 se acionado por evento, 0,7 se puramente técnico).
  • O resultado da classificação determina o nível de urgência (P0/P1/P2) e se um alerta é enviado como push, resumo periódico ou apenas no painel.
  • Para portfólios com mais de 5 participações, os alertas P1 são agrupados por drivers comuns: se 3 ativos eletrônicos de consumo caírem juntos, um único cartão de incidente "Rotação para fora do consumo discricionário" é acionado em vez de 3 alertas separados.

Ruído e Limite

  • Silêncio padrão: esta habilidade não envia buzina de alerta a cada movimento. Ela fica em silêncio até que um sinal ultrapasse o limite P0. O usuário pode ajustar a sensibilidade na aba Fórmulas.
  • Desduplicação de alerta: um alerta que apareceu nas últimas 24 horas para o mesmo ativo + mesmo tipo de sinal não é reenviado como um alerta separado; é mesclado no cartão de incidente existente com um indicador de atualização.
  • Supressão de abertura: para evitar alarmes falsos no primeiro minuto de negociação, atrase os sinais P0 da Camada A em 15 minutos após a abertura (a menos que o movimento supere 5 × o limite — então é real).

Construção de push:

O formato de mensagem de push é:

[P0] NVDA agora em $720 (-4,2%) · z_idio: 3.1
Sua tese 'vencer os semicondutores' está sendo desafiada.
Incidente: <link do cartão do ativo>
  • Cada alerta P0 tem um link direto para o cartão do ativo na interface do Playbook.
  • As mensagens são curtas o suficiente para caber em uma visualização de notificação sem truncamento.

Inicialização a Frio (Para participações sem histórico de dados de 20 dias)

Se dados forem escassos (< 20 dias de negociação ou ticker recém-listado):

  • Use o sigma do benchmark do setor (do perfil) escalado para a volatilidade esperada do setor vs. mercado geral como um sigma provisório.
  • Dobre os limites (exija 2 × a evidência para um alerta): isso evita que nomes de baixo volume disparem alarmes nas primeiras semanas.
  • Marque a confiança do perfil como baixa e mostre-a como tal na interface. O usuário vê uma etiqueta "Inicialização" no cartão do ativo.
  • Atualize para estimativas completas de sigma/grep assim que 20 pontos de dados estiverem disponíveis; então remova a etiqueta de inicialização.

Padrão de Construção — Evidência de uma Execução Real

Esta seção documenta que a habilidade foi construída e executada com sucesso para um conjunto de portfólio real — não é uma especificação para construir, é prova de que o projeto funciona.

A execução bem-sucedida envolveu:

  • captação (manual, sem módulo de portfólio): NVDA, TSLA, AAPL, MSTR, pesos iguais
  • feed de perfil construído com sigma_ewma, sigma_mad, sigma_eps para todos os 4 nomes, benchmarks roteados (QQQ, XLK, XLY, IBIT e uma cesta de pares de mineração de BTC para MSTR)
  • feeds de monitoramento produzindo z_idio, z_bruto, setor-relativo, RVOL, z_score_earnings, arquivamento de insider (Form 4), calendário de resultados, contexto macro CPI/PPI, sentimento de notícias, e sinais de mercado de previsão (CPI da Polymarket); todos os sinais visíveis na interface e no histórico de execução
  • alertas classificados e rolados: P0 z_idio > 4 por MSTR em um único dia; alerta P1 para NVDA (resultados); P1 para TSLA (registro de Form 4 de Elon)
  • interface: abas Monitoramento + Incidente + Tese + Fórmulas; teses inseridas ("BTC alavancado" para MSTR, "vencer os semicondutores" para NVDA); estado muda quando desafiado
  • alerta push entregue para o assinante (slack) com link direto; link abre a aba Incidente do ativo no painel
  • rastreamento de ações de usuário registrado ("Isso foi útil?" prompt)
  • UDF de ajuste de limite funcional

Apêndices

Apêndice A — Roteamento de Benchmark

Para cada participação, atribua benchmarks primários e de setor:

Tipo de ativoBenchmark primárioBenchmark do setorNotas
Ação dos EUA^GSPC (S&P 500)ETF do setor GICS (XLF, XLK …)
ADR^GSPC + ETF do país de origemGlobal sector ETF
Ação não americanaETF do país de origem (EWZ, EWW …)Global sector ETF
ETFO benchmark do ETF (se indexado) ou a classe de ativos que ele rastreiaN/A (entidade)
CriptoBTC (se altcoin), ou a cesta de ativos cripto (índice TMM)Setor cripto (se cripto-linked equity)
Fixed income (se suportado)^TYX (10Y yield), ETF agregado (AGG)Duration-matched sector

Se um benchmark não estiver disponível, use a média do portfólio como proxy.

Apêndice B — Fontes de Dados (mapeamento para Habilidades de Dados do Alva)

DadoHabilidade de DadosParâmetrosNotas
Preço histórico (diário)getStockCandles ou getCryptoKlinesticker, intervalo, lookback
Preço intradiáriogetStockCandles com intervalo '1m' / '5m'ticker, intervalo, lookback
Detalhes da empresagetStockCompanyDetail (ou getCryptoAssetDetail)tickerSetor, indústria, capitalização de mercado, free float
Arquivamentos 8-K/10-Q/10-K/Form 4Fonte de dados SEC EDGAR ou getFilingsticker, tipo de arquivamento, intervalo de datas
Previsões de resultadosFonte de dados Estimize ou getEarningsCalendarticker, próximo/último
NotíciasgetNews (ou unified_search)ticker, intervalo de datas, fontes
Dados econômicos (CPI, PPI)Fonte FRED ou getEconomicIndicatorindicador, data
Mercados de previsãogetPolymarketMarketDataslug, intervalo
Volatilidade de opçõesFonte Options ou getOptionsChainticker, data de expiraçãoPara IV vs. RV
Contexto de criptogetCryptoAssetDetail, getCryptoKlines, getCryptoNewsticker, intervalo

Apêndice C — Tratamento de Erros e Estados Limite

  • Dado ausente: Um campo de perfil vazio (ex.: sem avg_dollar_vol_20d para uma ação pouco negociada) não bloqueia o restante do perfil. Preencha com null e ignore os monitores que dependem dele; marque o perfil como incompleto na interface. Exemplo: para BDC com dados escassos de volume, a Camada A de liquidez fica em branco; as Camadas B, C e D ainda funcionam.
  • Quebra de API ou tempo limite: Se uma fonte de dados da Camada B falhar (ex.: resultados não retornam), registre uma entrada de erro na aba Incidente ("Não foi possível buscar resultados para NVDA — tentando novamente na próxima varredura"), mas não pare o processamento nem bloqueie a interface. As demais Camadas continuam.
  • Remoção de participação: Se o usuário remover uma participação da configuração, remova-a de todos os feeds e da interface dentro do ciclo de atualização (pule-a na próxima execução do feed de perfil). Se a participação estava gerando um alerta ativo no momento da remoção, cancele o alerta.
  • Portfólio vazio: Se a configuração não tiver participações, mostre uma tela de boas-vindas "Adicione seu primeiro ativo" com um prompt de entrada e um botão de integração com o módulo de portfólio do Alva.
  • Sobreposição de teses: Se duas teses se aplicarem ao mesmo ativo (ex.: "BTC alavancado" e "jogada de semicondutores" para MSTR), selecione a tese com a prioridade inferida mais alta (a primeira declarada vence); mostre ambas no cartão com a tese primária marcada.

Apêndice D — Segurança e Privacidade

  • O Playbook é criado sob a conta do usuário e acessível apenas a ele (a menos que ele compartilhe o link explicitamente).
  • Dados de portfólio (símbolos, pesos) nunca são registrados em logs ou armazenados fora dos feeds do Alva.
  • Alertas são entregues apenas ao canal autenticado do usuário; nenhum dado de terceiros é exposto.

Habilidades Relacionadas