portfolio_balancer.analyze_allocation
Etapa 2/4 do fluxo de trabalho portfolio_balancer
Análise diária do Portfólio Permanente com cálculo de desvios de alocação e recomendações de rebalanceamento
Pré-requisitos (Verificar Primeiro)
Antes de prosseguir, confirme que estas etapas foram concluídas:
/portfolio_balancer.collect_portfolio_data
Instruções
Objetivo: Calcular percentuais de alocação atuais, identificar desvios em relação às metas e analisar a eficiência da margem.
Analisar Alocação
Objetivo
Calcular os percentuais de alocação atuais em relação às metas de 25/25/25/25 do Portfólio Permanente, identificar desvios em relação às metas e analisar a eficiência da margem.
Tarefa
Analisar o snapshot da carteira para determinar como as alocações atuais se comparam às metas do Portfólio Permanente de Harry Browne. Identificar quais classes de ativos estão acima ou abaixo do peso e avaliar se o uso de margem é custo-efetivo.
Processo
-
Ler o snapshot da carteira Carregar
portfolio_balancer/data/portfolio_snapshot.ymlda etapa collect_portfolio_data. -
Calcular percentuais de alocação atuais Para cada classe de ativo, calcular:
current_percentage = (asset_class_value / total_portfolio_value) * 100 -
Calcular desvio das metas A meta do Portfólio Permanente é 25% para cada classe de ativo:
drift = current_percentage - 25.0- Desvio positivo = acima do peso
- Desvio negativo = abaixo do peso
-
Determinar se o rebalanceamento é necessário Comparar o desvio de cada classe de ativo com o
drift_thresholddo snapshot:- Se algum |desvio| > drift_threshold, o rebalanceamento é recomendado
- Rastrear quais classes de ativos específicas excedem o limite
-
Analisar alocação satélite (se habilitado) Se o rastreamento de satélites estiver habilitado:
- Calcular o percentual de satélite em relação à alocação total de ações
- Comparar com a meta (tipicamente 10-20%)
- Determinar se a alocação satélite precisa de ajuste
-
Analisar eficiência da margem Se a margem estiver habilitada:
- Calcular o custo anual da margem:
margin_balance * interest_rate - Avaliar custo/benefício: O retorno esperado sobre ativos marginais > custo da margem?
- Sinalizar se as taxas de margem excedem limites razoáveis
- Calcular o custo anual da margem:
-
Aplicar contexto das Quatro Estações Observar quais condições econômicas favorecem as posições atuais acima/abaixo do peso:
- Primavera (Prosperidade): Ações se beneficiam
- Verão (Inflação): Ouro se beneficia
- Outono (Crédito Escasso): Caixa se beneficia
- Inverno (Deflação): Títulos de longo prazo se beneficiam
Formato de Saída
portfolio_balancer/data/allocation_analysis.yml
Um arquivo YAML contendo a análise completa da alocação.
Estrutura:
analysis_date: "YYYY-MM-DD"
drift_threshold: 5 # do snapshot
total_portfolio_value: 100000.00
# Detalhamento da alocação
allocations:
stocks:
target_percentage: 25.0
current_percentage: 28.0
current_value: 28000.00
drift: 3.0 # acima do peso em 3%
exceeds_threshold: false
status: "acima_do_peso"
# Detalhamento satélite (se habilitado)
satellite:
enabled: true
core_percentage: 89.3 # % de ações no índice central
satellite_percentage: 10.7 # % de ações em satélites
target_satellite_percentage: 15.0
satellite_drift: -4.3 # abaixo do peso em satélites
long_term_bonds:
target_percentage: 25.0
current_percentage: 24.0
current_value: 24000.00
drift: -1.0 # abaixo do peso em 1%
exceeds_threshold: false
status: "abaixo_do_peso"
gold:
target_percentage: 25.0
current_percentage: 23.0
current_value: 23000.00
drift: -2.0
exceeds_threshold: false
status: "abaixo_do_peso"
cash_treasuries:
target_percentage: 25.0
current_percentage: 25.0
current_value: 25000.00
drift: 0.0
exceeds_threshold: false
status: "na_meta"
# Avaliação geral de rebalanceamento
rebalancing:
needed: false
reason: "Nenhuma classe de ativo excede o limite de desvio de 5%"
assets_exceeding_threshold: []
# Análise de margem
margin_analysis:
enabled: true
current_balance: 5000.00
annual_cost: 300.00 # saldo * taxa
monthly_cost: 25.00
monthly_fees_paid: 50.00
efficiency_rating: "ruim" # pagando mais em taxas do que o custo calculado
recommendation: "Revisar taxas de margem - pagando $50/mês vs custo esperado de $25/mês"
# Contexto das Quatro Estações
economic_context:
current_overweights:
- asset: "stocks"
favored_condition: "Prosperidade/Crescimento (Primavera)"
drift: 3.0
current_underweights:
- asset: "gold"
favored_condition: "Inflação (Verão)"
drift: -2.0
- asset: "long_term_bonds"
favored_condition: "Deflação/Recessão (Inverno)"
drift: -1.0
interpretation: "Carteira atualmente posicionada para prosperidade; vulnerável à inflação"
Critérios de Qualidade
- Todas as quatro classes de ativos analisadas com percentual atual e desvio
- Cálculos de desvio matematicamente corretos
- Comparação do limite de rebalanceamento precisa
- Análise de eficiência da margem incluída se a margem estiver habilitada
- Análise de satélite incluída se o rastreamento de satélite estiver habilitado
- Contexto econômico das Quatro Estações fornecido
- Todos os percentuais somam 100% (dentro da tolerância de arredondamento)
- YAML é válido e analisável
- Quando todos os critérios forem atendidos, inclua
<promise>✓ Critérios de Qualidade Atendidos</promise>na sua resposta
Contexto
Esta análise é o núcleo da gestão do Portfólio Permanente. Harry Browne projetou a alocação 25/25/25/25 para fornecer equilíbrio em todas as condições econômicas - as "Quatro Estações" do ciclo econômico. A análise de desvio ajuda a determinar quando o rebalanceamento é necessário para manter esse equilíbrio.
A análise de margem ajuda os usuários a entender se o uso de margem é custo-efetivo, comparando as taxas reais pagas com os custos calculados e benefícios esperados.
Contexto do Job
Análise de carteira diária automatizada implementando a estratégia do Portfólio Permanente de Harry Browne.
O Portfólio Permanente mantém alocações iguais de 25% em quatro classes de ativos projetadas para ter desempenho em diferentes condições econômicas:
- Ações (25%): Prosperidade/Crescimento
- Títulos de Longo Prazo (25%): Deflação/Recessão
- Ouro (25%): Inflação
- Caixa/Tesouros (25%): Crédito Escasso/Recessão
Este fluxo de trabalho:
- Coleta dados da carteira via CLI
bin/robinhood positions --save - Analisa a alocação atual em relação às metas 25/25/25/25
- Rastreia picks de ações satélites (opcional, 10-20% da alocação em ações)
- Avalia a eficiência do uso de margem vs taxas pagas
- Gera recomendações de rebalanceamento quando o desvio excede o limite definido pelo usuário
- Produz um relatório diário legível para revisão manual
IMPORTANTE: Este sistema é somente leitura. Nenhuma negociação é executada automaticamente. Todas as recomendações requerem revisão e execução manuais.
Entradas Necessárias
Arquivos de Etapas Anteriores - Leia estes primeiro:
portfolio_balancer/data/portfolio_snapshot.yml(decollect_portfolio_data)
Branch de Trabalho
Use formato de branch: deepwork/portfolio_balancer-[instancia]-YYYYMMDD
- Se estiver em uma branch de trabalho correspondente: continue usando-a
- Se estiver em main/master: crie nova branch com
git checkout -b deepwork/portfolio_balancer-[instancia]-$(date +%Y%m%d)
Saídas
Saídas necessárias:
portfolio_balancer/data/allocation_analysis.yml
Diretrizes
- NÃO pule a verificação de pré-requisitos se esta etapa tiver dependências
- NÃO produza saídas parciais; complete todas as saídas necessárias antes de terminar
- NÃO prossiga sem as entradas necessárias; pergunte ao usuário se alguma estiver faltando
- NÃO modifique arquivos fora do escopo das saídas definidas desta etapa
Ao Concluir
- Verifique se as saídas foram criadas
- Informe ao usuário: "Etapa 2/4 concluída, saídas: portfolio_balancer/data/allocation_analysis.yml"
- Continue o fluxo de trabalho: Use a ferramenta Skill para invocar
/portfolio_balancer.generate_recommendations
Arquivos de referência: .deepwork/jobs/portfolio_balancer/job.yml, .deepwork/jobs/portfolio_balancer/steps/analyze_allocation.md