portfolio_balancer.analyze_allocation
Etapa 2/4 do fluxo portfolio_balancer
Análise diária da Carteira Permanente com 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 os percentuais de alocação atuais, identificar desvios em relação às metas, analisar a eficiência da margem.
Analisar Alocação
Objetivo
Calcular os percentuais de alocação atuais em relação às metas 25/25/25/25 da Carteira Permanente, identificar desvios das metas e analisar a eficiência da margem.
Tarefa
Analisar o snapshot do portfólio para determinar como as alocações atuais se comparam às metas da Carteira Permanente de Harry Browne. Identificar quais classes de ativos estão acima ou abaixo do peso e avaliar se o uso de margem é rentável.
Processo
-
Ler o snapshot do portfólio Carregar
portfolio_balancer/data/portfolio_snapshot.ymlda etapa collect_portfolio_data. -
Calcular os percentuais de alocação atuais Para cada classe de ativo, calcular:
porcentagem_atual = (valor_classe_ativo / valor_total_portfolio) * 100 -
Calcular o desvio das metas A meta da Carteira Permanente é 25% para cada classe de ativo:
desvio = porcentagem_atual - 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
limite_de_desviodo snapshot:- Se algum |desvio| > limite_de_desvio, o rebalanceamento é recomendado
- Rastrear quais classes de ativos específicas excedem o limite
-
Analisar a alocação de satélites (se ativado) Se o rastreamento de satélites estiver ativado:
- Calcular a % de satélites em relação ao total de ações
- Comparar com a meta (geralmente 10-20%)
- Determinar se a alocação de satélites precisa de ajuste
-
Analisar a eficiência da margem Se a margem estiver ativada:
- Calcular o custo anual da margem:
saldo_margem * taxa_juros - Avaliar custo/benefício: O retorno esperado dos ativos com margem é maior que o custo da margem?
- Sinalizar se as taxas de margem excederem limites razoáveis
- Calcular o custo anual da margem:
-
Aplicar o 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 Restrito): 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 de alocação.
Estrutura:
data_analise: "AAAA-MM-DD"
limite_desvio: 5 # do snapshot
valor_total_portfolio: 100000.00
# Detalhamento de alocação
alocacoes:
acoes:
porcentagem_meta: 25.0
porcentagem_atual: 28.0
valor_atual: 28000.00
desvio: 3.0 # acima do peso em 3%
excede_limite: false
status: "acima_do_peso"
# Detalhamento de satélites (se ativado)
satelite:
ativado: true
porcentagem_core: 89.3 # % de ações no índice principal
porcentagem_satelite: 10.7 # % de ações em satélites
porcentagem_meta_satelite: 15.0
desvio_satelite: -4.3 # abaixo do peso em satélites
titulos_longo_prazo:
porcentagem_meta: 25.0
porcentagem_atual: 24.0
valor_atual: 24000.00
desvio: -1.0 # abaixo do peso em 1%
excede_limite: false
status: "abaixo_do_peso"
ouro:
porcentagem_meta: 25.0
porcentagem_atual: 23.0
valor_atual: 23000.00
desvio: -2.0
excede_limite: false
status: "abaixo_do_peso"
caixa_tesouro:
porcentagem_meta: 25.0
porcentagem_atual: 25.0
valor_atual: 25000.00
desvio: 0.0
excede_limite: false
status: "na_meta"
# Avaliação geral de rebalanceamento
rebalanceamento:
necessario: false
motivo: "Nenhuma classe de ativo excede o limite de desvio de 5%"
ativos_excedendo_limite: []
# Análise de margem
analise_margem:
ativada: true
saldo_atual: 5000.00
custo_anual: 300.00 # saldo * taxa
custo_mensal: 25.00
taxas_mensais_pagas: 50.00
classificacao_eficiencia: "ruim" # pagando mais em taxas do que o custo calculado
recomendacao: "Revisar taxas de margem - pagando $50/mês vs custo esperado de $25/mês"
# Contexto das Quatro Estações
contexto_economico:
ativos_acima_peso_atual:
- ativo: "acoes"
condicao_favorecida: "Prosperidade/Crescimento (Primavera)"
desvio: 3.0
ativos_abaixo_peso_atual:
- ativo: "ouro"
condicao_favorecida: "Inflação (Verão)"
desvio: -2.0
- ativo: "titulos_longo_prazo"
condicao_favorecida: "Deflação/Recessão (Inverno)"
desvio: -1.0
interpretacao: "Portfólio atualmente posicionado para prosperidade; vulnerável à inflação"
Critérios de Qualidade
- Todas as quatro classes de ativos analisadas com porcentagem atual e desvio
- Cálculos de desvio matematicamente corretos
- Comparação do limite de rebalanceamento precisa
- Análise de eficiência de margem incluída se a margem estiver ativada
- Análise de satélites incluída se o rastreamento de satélites estiver ativado
- Contexto econômico das Quatro Estações fornecido
- Todas as porcentagens 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>em sua resposta
Contexto
Esta análise é o núcleo da gestão da Carteira 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 é rentável, comparando as taxas reais pagas com os custos calculados e benefícios esperados.
Contexto do Job
Análise automatizada diária de portfólio implementando a estratégia da Carteira Permanente de Harry Browne.
A Carteira Permanente mantém alocações iguais de 25% em quatro classes de ativos projetadas para ter bom 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 Restrito/Recessão
Este fluxo:
- Coleta dados do portfólio via CLI
bin/robinhood positions --save - Analisa a alocação atual contra as metas 25/25/25/25
- Rastreia seleções de ações satélites (opcional 10-20% da alocação de ações)
- Avalia a eficiência do uso de margem versus 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 exigem 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
Usar formato de branch: deepwork/portfolio_balancer-[instancia]-AAAAMMDD
- Se estiver em uma branch de trabalho correspondente: continuar usando-a
- Se estiver em main/master: criar 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; conclua todas as saídas necessárias antes de finalizar
- 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 nesta etapa
Ao Finalizar
- Verificar se as saídas foram criadas
- Informar ao usuário: "Etapa 2/4 concluída, saídas: portfolio_balancer/data/allocation_analysis.yml"
- Continuar o fluxo: Usar 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