portfolio_balancer.analyze_allocation
Étape 2/4 du workflow portfolio_balancer
Analyse quotidienne du portefeuille Permanent Portfolio avec détection des écarts d'allocation et recommandations de rééquilibrage
Prérequis (Vérifier d'abord)
Avant de continuer, confirmez que ces étapes sont terminées :
/portfolio_balancer.collect_portfolio_data
Instructions
Objectif : Calculer les pourcentages d'allocation actuels, identifier les écarts par rapport aux cibles, analyser l'efficacité de la marge.
Analyser l'allocation
Objectif
Calculer les pourcentages d'allocation actuels par rapport aux cibles 25/25/25/25 du portefeuille Permanent Portfolio, identifier les écarts par rapport aux cibles et analyser l'efficacité de la marge.
Tâche
Analyser l'instantané du portefeuille pour déterminer comment les allocations actuelles se comparent aux cibles du portefeuille Permanent Portfolio de Harry Browne. Identifier les classes d'actifs en surpoids ou en sous-poids et évaluer si l'utilisation de la marge est rentable.
Processus
-
Lire l'instantané du portefeuille Charger
portfolio_balancer/data/portfolio_snapshot.ymldepuis l'étape collect_portfolio_data. -
Calculer les pourcentages d'allocation actuels Pour chaque classe d'actifs, calculer :
pourcentage_actuel = (valeur_classe_actifs / valeur_totale_portefeuille) * 100 -
Calculer l'écart par rapport aux cibles La cible du portefeuille Permanent Portfolio est de 25 % pour chaque classe d'actifs :
écart = pourcentage_actuel - 25.0- Écart positif = surpoids
- Écart négatif = sous-poids
-
Déterminer si un rééquilibrage est nécessaire Comparer l'écart de chaque classe d'actifs par rapport au
seuil_d_écartde l'instantané :- Si |écart| > seuil_d_écart, un rééquilibrage est recommandé
- Suivre quelles classes d'actifs spécifiques dépassent le seuil
-
Analyser l'allocation satellite (si activée) Si le suivi satellite est activé :
- Calculer le % satellite de l'allocation totale en actions
- Comparer à la cible (généralement 10-20 %)
- Déterminer si l'allocation satellite nécessite un ajustement
-
Analyser l'efficacité de la marge Si la marge est activée :
- Calculer le coût annuel de la marge :
solde_marge * taux_intérêt - Évaluer le rapport coût/bénéfice : Le rendement attendu des actifs sous marge est-il supérieur au coût de la marge ?
- Signaler si les frais de marge dépassent des seuils raisonnables
- Calculer le coût annuel de la marge :
-
Appliquer le contexte des Quatre Saisons Noter quelles conditions économiques favorisent les positions actuelles en surpoids/sous-poids :
- Printemps (Prospérité) : Les actions bénéficient
- Été (Inflation) : L'or bénéficie
- Automne (Argent rare) : Les liquidités bénéficient
- Hiver (Déflation) : Les obligations à long terme bénéficient
Format de sortie
portfolio_balancer/data/allocation_analysis.yml
Un fichier YAML contenant l'analyse complète de l'allocation.
Structure :
analysis_date: "YYYY-MM-DD"
seuil_d_écart: 5 # depuis l'instantané
valeur_totale_portefeuille: 100000.00
# Répartition de l'allocation
allocations:
actions:
pourcentage_cible: 25.0
pourcentage_actuel: 28.0
valeur_actuelle: 28000.00
écart: 3.0 # surpondéré de 3 %
dépasse_seuil: false
statut: "surpoids"
# Répartition satellite (si activée)
satellite:
activé: true
pourcentage_noyau: 89.3 # % des actions dans l'indice de base
pourcentage_satellite: 10.7 # % des actions dans les satellites
pourcentage_cible_satellite: 15.0
écart_satellite: -4.3 # sous-pondération des satellites
obligations_long_terme:
pourcentage_cible: 25.0
pourcentage_actuel: 24.0
valeur_actuelle: 24000.00
écart: -1.0 # sous-pondéré de 1 %
dépasse_seuil: false
statut: "sous-poids"
or:
pourcentage_cible: 25.0
pourcentage_actuel: 23.0
valeur_actuelle: 23000.00
écart: -2.0
dépasse_seuil: false
statut: "sous-poids"
liquidités_obligations_d_état:
pourcentage_cible: 25.0
pourcentage_actuel: 25.0
valeur_actuelle: 25000.00
écart: 0.0
dépasse_seuil: false
statut: "conforme"
# Évaluation globale du rééquilibrage
rééquilibrage:
nécessaire: false
raison: "Aucune classe d'actifs ne dépasse le seuil d'écart de 5 %"
actifs_dépassant_seuil: []
# Analyse de la marge
analyse_marge:
activée: true
solde_actuel: 5000.00
coût_annuel: 300.00 # solde * taux
coût_mensuel: 25.00
frais_mensuels_payés: 50.00
note_efficacité: "médiocre" # paie plus de frais que le coût calculé
recommandation: "Vérifier les frais de marge - paie 50 $/mois contre un coût attendu de 25 $/mois"
# Contexte des Quatre Saisons
contexte_économique:
surpoids_actuels:
- actif: "actions"
condition_favorable: "Prospérité/Croissance (Printemps)"
écart: 3.0
sous_poids_actuels:
- actif: "or"
condition_favorable: "Inflation (Été)"
écart: -2.0
- actif: "obligations_long_terme"
condition_favorable: "Déflation/Récession (Hiver)"
écart: -1.0
interprétation: "Portefeuille actuellement positionné pour la prospérité ; vulnérable à l'inflation"
Critères de qualité
- Les quatre classes d'actifs sont analysées avec le pourcentage actuel et l'écart
- Les calculs d'écart sont mathématiquement corrects
- La comparaison du seuil de rééquilibrage est précise
- L'analyse de l'efficacité de la marge est incluse si la marge est activée
- L'analyse satellite est incluse si le suivi satellite est activé
- Le contexte économique des Quatre Saisons est fourni
- Tous les pourcentages totalisent 100 % (avec une tolérance d'arrondi)
- Le YAML est valide et analysable
- Lorsque tous les critères sont satisfaits, incluez
<promise>✓ Critères de Qualité Satisfaits</promise>dans votre réponse
Contexte
Cette analyse est au cœur de la gestion du portefeuille Permanent Portfolio. Harry Browne a conçu l'allocation 25/25/25/25 pour assurer un équilibre dans toutes les conditions économiques - les "Quatre Saisons" du cycle économique. L'analyse des écarts aide à déterminer quand un rééquilibrage est nécessaire pour maintenir cet équilibre.
L'analyse de la marge aide les utilisateurs à comprendre si leur utilisation de la marge est rentable, en comparant les frais réels payés aux coûts calculés et aux avantages attendus.
Contexte du travail
Analyse automatisée quotidienne du portefeuille mettant en œuvre la stratégie du portefeuille Permanent Portfolio de Harry Browne.
Le portefeuille Permanent Portfolio maintient des allocations égales de 25 % sur quatre classes d'actifs conçues pour performer dans différentes conditions économiques :
- Actions (25 %) : Prospérité/Croissance
- Obligations à long terme (25 %) : Déflation/Récession
- Or (25 %) : Inflation
- Liquidités/Obligations d'État (25 %) : Argent rare/Récession
Ce workflow :
- Collecte les données du portefeuille via l'interface CLI
bin/robinhood positions --save - Analyse l'allocation actuelle par rapport aux cibles 25/25/25/25
- Suit les sélections d'actions satellites (optionnellement 10-20 % de l'allocation en actions)
- Évalue l'efficacité de l'utilisation de la marge par rapport aux frais payés
- Génère des recommandations de rééquilibrage lorsque l'écart dépasse le seuil défini par l'utilisateur
- Produit un rapport quotidien lisible par l'homme pour une révision manuelle
IMPORTANT : Ce système est en lecture seule. Aucune transaction n'est exécutée automatiquement. Toutes les recommandations nécessitent une révision et une exécution manuelles.
Entrées requises
Fichiers des étapes précédentes - Lisez-les d'abord :
portfolio_balancer/data/portfolio_snapshot.yml(decollect_portfolio_data)
Branche de travail
Utiliser le format de branche : deepwork/portfolio_balancer-[instance]-YYYYMMDD
- Si sur une branche de travail correspondante : continuez à l'utiliser
- Si sur main/master : créez une nouvelle branche avec
git checkout -b deepwork/portfolio_balancer-[instance]-$(date +%Y%m%d)
Sorties
Sorties requises :
portfolio_balancer/data/allocation_analysis.yml
Garde-fous
- Ne PAS sauter la vérification des prérequis si cette étape a des dépendances
- Ne PAS produire de sorties partielles ; terminez toutes les sorties requises avant de terminer
- Ne PAS continuer sans les entrées requises ; demandez à l'utilisateur si l'une d'elles manque
- Ne PAS modifier les fichiers en dehors du périmètre des sorties définies de cette étape
À la fin
- Vérifier que les sorties sont créées
- Informer l'utilisateur : "Étape 2/4 terminée, sorties : portfolio_balancer/data/allocation_analysis.yml"
- Continuer le workflow : Utiliser l'outil Skill pour invoquer
/portfolio_balancer.generate_recommendations
Fichiers de référence : .deepwork/jobs/portfolio_balancer/job.yml, .deepwork/jobs/portfolio_balancer/steps/analyze_allocation.md