name	portfolio_balancer.analyze_allocation
description	Calculate current allocation percentages, identify drift from targets, analyze margin efficiency
user-invocable	false

portfolio_balancer.analyze_allocation

Step 2/4 in portfolio_balancer workflow

Daily Permanent Portfolio analysis with allocation drift and rebalancing recommendations

Prerequisites (Verify First)

Before proceeding, confirm these steps are complete:

/portfolio_balancer.collect_portfolio_data

Instructions

Goal: Calculate current allocation percentages, identify drift from targets, analyze margin efficiency

Analyze Allocation

Objective

Calculate current allocation percentages against the 25/25/25/25 Permanent Portfolio targets, identify drift from targets, and analyze margin efficiency.

Task

Analyze the portfolio snapshot to determine how current allocations compare to Harry Browne's Permanent Portfolio targets. Identify which asset classes are over or underweight and assess whether margin usage is cost-effective.

Process

Read the portfolio snapshot Load portfolio_balancer/data/portfolio_snapshot.yml from the collect_portfolio_data step.

Calculate current allocation percentages For each asset class, calculate:

current_percentage = (asset_class_value / total_portfolio_value) * 100

Calculate drift from targets The Permanent Portfolio target is 25% for each asset class:
```
drift = current_percentage - 25.0
```
- Positive drift = overweight
- Negative drift = underweight
Determine if rebalancing is needed Compare each asset class drift against the drift_threshold from the snapshot:
- If any |drift| > drift_threshold, rebalancing is recommended
- Track which specific asset classes exceed the threshold
Analyze satellite allocation (if enabled) If satellite_tracking is enabled:
- Calculate satellite % of total stock allocation
- Compare against target (typically 10-20%)
- Determine if satellite allocation needs adjustment
Analyze margin efficiency If margin is enabled:
- Calculate annual margin cost: margin_balance * interest_rate
- Assess cost/benefit: Is the expected return on margined assets > margin cost?
- Flag if margin fees exceed reasonable thresholds
Apply Four Seasons context Note which economic conditions favor current over/underweight positions:
- Spring (Prosperity): Stocks benefit
- Summer (Inflation): Gold benefits
- Autumn (Tight Money): Cash benefits
- Winter (Deflation): Long-term bonds benefit

Output Format

portfolio_balancer/data/allocation_analysis.yml

A YAML file containing the complete allocation analysis.

Structure:

analysis_date: "YYYY-MM-DD"
drift_threshold: 5  # from snapshot

total_portfolio_value: 100000.00

# Allocation breakdown
allocations:
  stocks:
    target_percentage: 25.0
    current_percentage: 28.0
    current_value: 28000.00
    drift: 3.0  # overweight by 3%
    exceeds_threshold: false
    status: "overweight"
    # Satellite breakdown (if enabled)
    satellite:
      enabled: true
      core_percentage: 89.3  # % of stocks in core index
      satellite_percentage: 10.7  # % of stocks in satellites
      target_satellite_percentage: 15.0
      satellite_drift: -4.3  # underweight satellites

  long_term_bonds:
    target_percentage: 25.0
    current_percentage: 24.0
    current_value: 24000.00
    drift: -1.0  # underweight by 1%
    exceeds_threshold: false
    status: "underweight"

  gold:
    target_percentage: 25.0
    current_percentage: 23.0
    current_value: 23000.00
    drift: -2.0
    exceeds_threshold: false
    status: "underweight"

  cash_treasuries:
    target_percentage: 25.0
    current_percentage: 25.0
    current_value: 25000.00
    drift: 0.0
    exceeds_threshold: false
    status: "on_target"

# Overall rebalancing assessment
rebalancing:
  needed: false
  reason: "No asset class exceeds 5% drift threshold"
  assets_exceeding_threshold: []

# Margin analysis
margin_analysis:
  enabled: true
  current_balance: 5000.00
  annual_cost: 300.00  # balance * rate
  monthly_cost: 25.00
  monthly_fees_paid: 50.00
  efficiency_rating: "poor"  # paying more in fees than calculated cost
  recommendation: "Review margin fees - paying $50/mo vs $25/mo expected cost"

# Four Seasons context
economic_context:
  current_overweights:
    - asset: "stocks"
      favored_condition: "Prosperity/Growth (Spring)"
      drift: 3.0
  current_underweights:
    - asset: "gold"
      favored_condition: "Inflation (Summer)"
      drift: -2.0
    - asset: "long_term_bonds"
      favored_condition: "Deflation/Recession (Winter)"
      drift: -1.0
  interpretation: "Portfolio currently positioned for prosperity; vulnerable to inflation"

Quality Criteria

All four asset classes analyzed with current percentage and drift
Drift calculations are mathematically correct
Rebalancing threshold comparison is accurate
Margin efficiency analysis included if margin is enabled
Satellite analysis included if satellite tracking is enabled
Four Seasons economic context provided
All percentages sum to 100% (within rounding tolerance)
YAML is valid and parseable
When all criteria are met, include <promise>✓ Quality Criteria Met</promise> in your response

Context

This analysis is the core of Permanent Portfolio management. Harry Browne designed the 25/25/25/25 allocation to provide balance across all economic conditions - the "Four Seasons" of the economic cycle. Drift analysis helps determine when rebalancing is needed to maintain this balance.

The margin analysis helps users understand whether their use of margin is cost-effective, comparing actual fees paid against calculated costs and expected benefits.

Job Context

Automated daily portfolio analysis implementing Harry Browne's Permanent Portfolio strategy.

The Permanent Portfolio maintains equal 25% allocations across four asset classes designed to perform in different economic conditions:

Stocks (25%): Prosperity/Growth
Long-Term Bonds (25%): Deflation/Recession
Gold (25%): Inflation
Cash/Treasuries (25%): Tight Money/Recession

This workflow:

Collects portfolio data via bin/robinhood positions --save CLI
Analyzes current allocation against 25/25/25/25 targets
Tracks satellite stock picks (optional 10-20% of stock allocation)
Evaluates margin usage efficiency vs fees paid
Generates rebalancing recommendations when drift exceeds user-defined threshold
Produces a human-readable daily report for manual review

IMPORTANT: This system is read-only. No trades are executed automatically. All recommendations require manual review and execution.

Required Inputs

Files from Previous Steps - Read these first:

portfolio_balancer/data/portfolio_snapshot.yml (from collect_portfolio_data)

Work Branch

Use branch format: deepwork/portfolio_balancer-[instance]-YYYYMMDD

If on a matching work branch: continue using it
If on main/master: create new branch with git checkout -b deepwork/portfolio_balancer-[instance]-$(date +%Y%m%d)

Outputs

Required outputs:

portfolio_balancer/data/allocation_analysis.yml

Guardrails

Do NOT skip prerequisite verification if this step has dependencies
Do NOT produce partial outputs; complete all required outputs before finishing
Do NOT proceed without required inputs; ask the user if any are missing
Do NOT modify files outside the scope of this step's defined outputs

On Completion

Verify outputs are created
Inform user: "Step 2/4 complete, outputs: portfolio_balancer/data/allocation_analysis.yml"
Continue workflow: Use Skill tool to invoke /portfolio_balancer.generate_recommendations

Reference files: .deepwork/jobs/portfolio_balancer/job.yml, .deepwork/jobs/portfolio_balancer/steps/analyze_allocation.md