Rewrite financial-astrology agent guide following distillation pattern

Previous version was a comprehensive reference (like the repo-root files).
Now distilled to the agent-guide pattern matching natal/karmic/relationship:
- Tool call strategy with actual MCP tool names
- Step-by-step workflow using get_planetary_positions, get_transit_preview,
  calculate_natal_chart, calculate_transit_chart
- Concrete interpretation guidance (what to look for in tool output)
- Quick-reference tables
- Heuristics and interpretation tone section

Size: 433L repo -> 208L guide (48% ratio, within established 33-68% range).

agent-guides/financial-astrology.md

@@ -1,202 +1,90 @@
-# Financial Astrology — A Compiled Reference
+# Financial Astrology — Agent Interpretation Guide
 
-> Compiled from David Williams' *Financial Astrology: How To Forecast Business, and the Stock Market* (American Federation of Astrologers, 1982, 1984, 1988).
-> Additional sources: Edward R. Dewey's *Cycles: The Science of Prediction* (1947), Samuel Benner's *Prophecies of Future Ups and Downs in Prices* (1875), W. D. Gann, N. D. Kondratieff, and various cycle researchers.
+> For agents using the astro MCP to perform financial astrology analysis, market timing, and economic cycle interpretation.
+> Resource URI: `astro://guides/financial-astrology`
 
 ---
 
-## Table of Contents
-
-1. [Core Principles](#core-principles)
-2. [The Planetary Cause of Sunspots](#the-planetary-cause-of-sunspots)
-3. [Planetary Cycles in Business and Markets](#planetary-cycles-in-business-and-markets)
-4. [Benner's Price Cycles](#benners-price-cycles)
-5. [The 56-Year Pattern in American Business](#the-56-year-pattern-in-american-business)
-6. [McWhirter's North Node Business Cycle](#mcwhirters-north-node-business-cycle)
-7. [The 9.2-Year Stock Market Cycle](#the-92-year-stock-market-cycle)
-8. [The 38-41 Month Cycle](#the-38-41-month-cycle)
-9. [The Decennial Pattern](#the-decennial-pattern)
-10. [Williams' Solar Ingress Method](#williams-solar-ingress-method)
-11. [Williams' Running Total Aspect Method](#williams-running-total-aspect-method)
-12. [Corporation Horoscope Analysis](#corporation-horoscope-analysis)
-13. [Personal Investing — Natal Chart Indicators](#personal-investing--natal-chart-indicators)
-14. [Which Stock to Buy](#which-stock-to-buy)
-15. [Gold and Silver Price Cycles](#gold-and-silver-price-cycles)
-16. [Interest Rate Cycles](#interest-rate-cycles)
-17. [The Kondratieff Wave](#the-kondratieff-wave)
-18. [Key Planetary Signatures for Markets](#key-planetary-signatures-for-markets)
-19. [Practical Rules and Heuristics](#practical-rules-and-heuristics)
-20. [Sources](#sources)
+## Quick Reference: Tool Call Strategy
 
----
-
-## Core Principles
-
-### The Law of Causality
-Everything that happens is the consequence of a previous state of things. Economic forecasting is predicated upon adequate knowledge of existing conditions. The Law of Periodical Repetition states that everything which has happened once must happen again — not capriciously, but at regular periods.
-
-### The Mental Mood Theory
-Business cycles begin and end in the minds of men. Nervousness about business prospects translates quickly into lower economic activity. Economics and psychology go hand in hand. As Jung stated: "Astrology represents the summation of all the psychological knowledge of Antiquity."
-
-### The Electromagnetic Hypothesis
-At the moment of birth, the resultant magnetic field of the Sun, Moon, and planets produces a type of sensitivity and selectivity in the individual. When a transiting planet re-enters the area of the natal planet, magnetic effects are produced that operate as a cause affecting the individual. Each planet radiates astral energy of a different frequency. The angles (aspects) between planets determine whether energies combine into harmony or discord.
-
-### Aspect Polarities
-- **Harmonious aspects**: 60° (sextile), 120° (trine) — favorable conditions
-- **Inharmonious aspects**: 0° (conjunction), 90° (square), 180° (opposition) — unfavorable conditions
-- **Orbs of influence**: conjunction 10°, opposition 8°, sextile/square/trine 5-6°
-- The potency of an aspect rises slowly as planets enter orb, accelerates toward exactitude, then declines. At 1/3 of orb distance = 1/4 potency; at 1/2 = 1/2 potency; at 2/3 = 3/4 potency.
-
-### The Planets That Matter Most for Business
-Jupiter, Uranus, and Saturn are the primary planets whose geometrical configurations affect the business cycle. Jupiter (11.86-year orbital period) correlates with the sunspot cycle. The synodical period of Jupiter-Uranus is 13.81 years; Jupiter-Saturn is 19.86 years; Saturn-Uranus is 45.36 years.
-
----
-
-## The Planetary Cause of Sunspots
-
-### Historical Evidence
-- **1801**: Sir William Herschel first proposed that sunspot activity affected agricultural yields and prices.
-- **1859**: Rudolph Wolf devised a formula using planetary mass, distance, and angular position to produce a curve matching the sunspot curve.
-- **1863**: R. C. Carrington showed correlation between Jupiter's Radius Vector maxima and sunspot maxima from 1770 onward.
-- **1944**: G. E. Hale proved sunspots are powerful electromagnetic vortices. The true sunspot cycle is 22-23 years (twice the 11.11-year period, due to magnetic polarity reversal).
-
-### The Earth-Venus-Jupiter Tidal Wave
-Jose (1965) calculated solar surface tides from known planetary positions since 1750 and found close correlation between tidal ebb and flow and peak/quiescent sunspot activity. This provides a physical mechanism for planetary influence on solar activity.
-
-### Terrestrial Effects of Solar Activity
-Sunspot activity correlates with:
-- Agricultural yields and commodity prices
-- Rainfall and temperature patterns
-- Hurricane frequency (6-8 per year at maxima vs. 1-2 at minima)
-- Magnetic storms and radio transmission disruption
-- Human health and psychological states
-
----
-
-## Planetary Cycles in Business and Markets
-
-### Jupiter Cycle (11.86 years)
-Jupiter is the largest planet and the primary driver of the sunspot cycle. Its major equinox occurs every 11.86 years. Benner found that pig iron price cycles of 1836, 1847, 1858, 1869 fell behind the Jovial cycle. Jupiter is considered the "ruling element in our price cycles of natural productions."
-
-### Venus Cycle (8 years)
-Moore's 8-year Venus cycle correlates with both business and sunspot cycles. Venus-Earth synodic period creates an 8-year rhythm that appears in commodity prices and stock market patterns.
-
-### Moon's Node Cycle (18.6 years)
-McWhirter's North Node business cycle: the Moon's North Node completes a full circle every 18.6 years. This creates a 4-year sub-cycle (90° increments) that correlates with market lows. The North Node in Leo (sign of speculation) in the 2nd house (money) of the NYSE chart is particularly significant.
-
-### Saturn Cycle (29.46 years)
-Saturn exerts influence regulating cycles in manufacture and trade. Its synodical period with Jupiter is 19.86 years. Saturn represents pessimism, contraction, and discipline in markets.
-
-### Uranus Cycle (84.02 years)
-Uranus, along with Neptune, "may send forth an electric influence affecting Jupiter, Saturn, and in turn, the earth." Uranus represents sudden change, innovation, and disruption.
-
----
-
-## Benner's Price Cycles
-
-Samuel Benner (1875) developed the most notable forecast of prices in existence, with a 45:1 gain-loss ratio over 60 years. His key patterns:
-
-### Pig Iron Price Pattern
-- **Low-priced years**: decreasing series of 11, 9, 7 years (repeat every 27 years)
-- **High-priced years**: increasing series of 8, 9, 10 years (repeat every 27 years)
-- Depressions ("C") occur at 7-11-9 year intervals (average 9 years = Juglar cycle)
-- Panics ("A") occur at 16-18-20 year intervals, with every third peak at 54-year intervals (Kondratieff long wave)
-
-### Other Commodity Patterns
-- **Corn and Hogs**: 11-year cycle broken into alternate 5 and 6-year cycles (beginning 1836)
-- **Cotton**: follows an 11-year cycle
-- **General principle**: "When certain combinations are ascertained which produce one legitimate invariable manifestation from an analysis of the operations of the combined solar system, we may be enabled to discover the cause producing our price cycles."
-
-### Planetary Attribution
-- Jupiter: ruling element in price cycles of natural productions
-- Saturn: regulates cycles in manufacture and trade
-- Uranus and Neptune: send electric influence affecting Jupiter, Saturn, and Earth
+```
+planetary positions on a date    → get_planetary_positions(date)
+transit-to-natal (date range)    → get_transit_preview(birth_data, start, end)
+transit-to-natal (single date)   → calculate_transit_chart(birth_data, transit_datetime)
+corporation "natal" chart        → calculate_natal_chart(incorp_datetime, lat, lon)
+                                 [treat as corp chart — see Step 5]
+```
 
----
-
-## The 56-Year Pattern in American Business
-
-J. M. Funk's 1932 chart "The Cycles of Prosperity and Depression" revealed a 56-year pattern in American business activity. Williams added Jupiter, Saturn, and Uranus aspects to this chart for 1761-1958 and found a 68% correlation with business cycle movements.
-
-### Four Periods of the 56-Year Pattern
-1. **1761-1816**: First period
-2. **1817-1872**: Second period
-3. **1873-1928**: Third period
-4. **1929-1984**: Fourth period (predicted serious depression in 1985)
-
-The ups and downs of Jupiter-Saturn-Uranus planetary cycles showed 68% correlation with business cycle movements during 1761-1958.
+*Note: astro-mcp provides calculation tools. Financial astrology interpretation is done by the agent using the frameworks below. There is no dedicated "Solar Ingress" or "market forecast" tool — the agent computes these from planetary position data.*
 
 ---
 
-## McWhirter's North Node Business Cycle
-
-W. D. McWhirter developed a stock market forecasting system based on the Moon's North Node:
-
-### Key Principles
-- The North Node's 18.6-year cycle creates a 4-year sub-cycle (quartering the circle)
-- Market lows correlate with the North Node at 0°, 90°, 180°, 270° of the zodiac
-- The North Node in Leo (speculation) in the 2nd house (money) of the NYSE chart is bullish
-- Favorable aspects from transiting planets to the North Node indicate rising markets
-- Unfavorable aspects indicate declining markets
+## Framework
 
-### McWhirter's NYSE Chart
-- **Date**: May 17, 1792, 8:52 a.m., New York City
-- Used for analyzing planetary aspects at each lunation (New Moon and Full Moon)
-- Aspects to natal NYSE planets indicate market direction for the following month
+Financial astrology applies astrological cycles to business, markets, and economics. Core insight: **planetary configurations correlate with mass psychological patterns** (greed/fear, optimism/pessimism) that drive collective economic behavior.
 
----
-
-## The 9.2-Year Stock Market Cycle
+**How it works (the causal chain):**
+1. Planetary gravitational/tidal forces → sunspot activity (Earth-Venus-Jupiter tidal wave, Jose 1965)
+2. Sunspots → electromagnetic disturbances → weather, crops, human psychology
+3. Mass psychology → business decisions → economic cycles
 
-Edward R. Dewey identified a 9.2-year cycle in stock prices (1830-1966):
-- **Statistical significance**: Bartel's test shows this cycle could not occur by chance more than once in 5,000 times
-- **Tops**: correctly indicated 100% of the time
-- **Lows**: correctly indicated 12 out of 14 times (86%)
-- More precisely 9.225 years from crest to crest
-- This is similar to the 9-year Juglar cycle in business
+**Aspect Polarities for Market Analysis:**
+- Harmonious (favorable/bullish): 60° sextile, 120° trine
+- Inharmonious (unfavorable/bearish): 0° conjunction, 90° square, 180° opposition
+- Orbs: conjunction 10°, opposition 8°, others 5-6°
 
-### Dewey's Recommendation
-Determine short-term cycles that have repeated so often they cannot be chance, then play them on an actuarial basis — expecting losses but expecting gains to exceed losses over the long run.
+**The Contrarian Principle:**
+- Market highs = preponderance of **positive** aspects (greed, "sky is the limit") → **SELL**
+- Market lows = preponderance of **negative** aspects (fear, "bottom will fall out") → **BUY**
 
 ---
 
-## The 38-41 Month Cycle
+## Standard Financial Astrology Workflow
 
-### Discovery
-- **1912**: A New York group of investors discovered a 40.68-month cycle in industrial common stock prices (learned from Rothschild analysis of British Consols)
-- **1935**: Professor W. L. Crum (Harvard) noted a 39-40-41 month cycle in commercial paper rates
-- **1935**: Professor Kitchin (Harvard) discovered a 40-month cycle in six economic time series
+### Step 1: Identify the Relevant Cycle
 
-### Behavior
-- Worked with amazing correspondence from 1868-1945 (through wars, peace, good times, depression)
-- Reversed direction 1946-1956
-- Average length changed from 40.68 months to 38 months after 1932
-- When combined with the 9.2-year cycle: downward movements from tops correctly indicated 100% of the time; upward movements from lows 90% correct
+| Cycle | Length | Key Planets | Use When |
+|---|---|---|---|
+| Kondratieff Wave | 47-60 yr | J-S-U | Long-term economic supercycle context |
+| 56-Year Pattern | 56 yr | J-S-U aspects | American business cycle positioning |
+| Benner Crash Cycle | 16-18-20 yr | Jupiter, Saturn | Major panic/depression timing |
+| Juglar Cycle | ~9 yr | Sunspot cycle | Business investment cycle |
+| 9.2-Year Stock Cycle | 9.225 yr | (Dewey) | Stock market price cycle |
+| Decennial Pattern | 10 yr | (historical) | Year-of-decade tendencies |
+| Venus Cycle | 8 yr | Venus-Earth synodic | Commodity/corn-hog pricing |
+| Kitchin Cycle | 38-41 mo | (business) | Short-term market swings |
+| Node Cycle | 18.6 yr (4yr sub) | Moon's North Node | McWhirter market low timing |
 
----
+### Step 2: Get Planetary Positions for Key Dates
 
-## The Decennial Pattern
+**Call**: `get_planetary_positions(date)` for:
+- The date in question (e.g., today, a market high/low date, incorporation date)
+- Solar Ingress dates (Sun entering cardinal signs: ~Mar 20, Jun 21, Sep 22, Dec 21)
+- Historical market turning points for comparison
 
-A 10-year pattern in stock prices where certain years of the decade consistently show bullish or bearish tendencies. This pattern has been observed across multiple decades and is one of the oldest recognized stock market cycles.
+**What to look for:**
+- Jupiter-Saturn aspects (19.86-year synodical cycle) — major economic shifts
+- Jupiter-Uranus aspects (13.81-year synodical cycle) — innovation/disruption periods
+- Saturn-Uranus aspects (45.36-year synodical cycle) — structural economic change
+- Moon's North Node position — McWhirter 4-year market low cycle
+- Stelliums in cardinal signs — Solar Ingress quarters
 
----
+### Step 3: Williams' Solar Ingress Method (Quarterly Forecast)
 
-## Williams' Solar Ingress Method
+**When to use:** "What's the market direction for the next quarter?"
 
-Williams published quarterly stock market forecasts in Dell's Horoscope magazine from 1964-1982 with 80% average accuracy. His method:
-
-### Procedure
-1. Obtain the Solar Ingress chart for each quarter (Sun entering cardinal signs: Aries, Cancer, Libra, Capricorn). The forecast year begins with the Winter Solstice (Capricorn ingress, ~December 22).
-2. Calculate the degrees of separation between each pair of planets.
-3. Circle negative aspects in RED, positive aspects in GREEN.
-4. Use orbs: conjunction 10°, opposition 8°, sextile/square/trine 5°.
-5. Assign values: conjunctions 10, oppositions 8, trines 6, sextiles and squares 4.
-6. Add positive and negative values. The excess = Net Aspect Value.
-7. **Positive Net Aspect Value** = market UP for the next 3 months. **Negative** = market DOWN.
-
-### Converting Signs to Longitude
-| Sign | Degrees | Sign | Degrees |
-|------|---------|------|---------|
+**Procedure:**
+1. Call `get_planetary_positions(ingress_date)` for the Solar Ingress (Sun entering Aries, Cancer, Libra, or Capricorn). Start the year at Winter Solstice (Capricorn ingress, ~Dec 22).
+2. Calculate angular separation between each pair of planets.
+3. Assign values: conjunctions=10, oppositions=8, trines=6, sextiles=4, squares=4.
+4. Use orbs: conjunction 10°, opposition 8°, others 5°.
+5. Sum positive aspects, sum negative aspects. Net = positive minus negative.
+6. **Positive Net** = market UP for next 3 months. **Negative Net** = DOWN.
+7. Minor aspects (30°, 45°, 135°, 150°) omitted — they cancel out.
+
+**Sign-to-Longitude Conversion:**
+| Sign | ° | Sign | ° |
+|---|---|---|---|
 | Aries | 0-30 | Libra | 180-210 |
 | Taurus | 30-60 | Scorpio | 210-240 |
 | Gemini | 60-90 | Sagittarius | 240-270 |
@@ -204,230 +92,117 @@ Williams published quarterly stock market forecasts in Dell's Horoscope magazine
 | Leo | 120-150 | Aquarius | 300-330 |
 | Virgo | 150-180 | Pisces | 330-360 |
 
-### Conjunction Polarity
-Use Table 31 for conjunction polarity (which conjunctions are positive vs. negative based on the planets involved). Sextiles and trines are always positive. Squares and oppositions are always negative.
+**Conjunction Polarity**: Sextiles and trines always positive. Squares and oppositions always negative. Conjunction polarity depends on the planets involved (Jupiter conjunct Venus = positive; Saturn conjunct Mars = negative).
 
-### Location
-Washington, D.C. is used (not New York) because the federal government plays an increasing role in economic life.
+### Step 4: Transit Analysis for Market Timing
 
----
+**Call**: `get_transit_preview(birth_data, start_date, end_date)` or `calculate_transit_chart(birth_data, transit_datetime)`
 
-## Williams' Running Total Aspect Method
+**For the NYSE "chart"**: Use May 17, 1792, 8:52 a.m., New York City as the natal reference. Pass this as the birth data to transit tools.
 
-An alternative/complementary technique:
+**What to look for:**
+- Transiting Jupiter/Uranus favorable aspects to natal NYSE Jupiter/Uranus = bullish
+- Transiting Saturn hard aspects to natal NYSE Sun/Jupiter = bearish
+- Transiting Node crossing cardinal points = potential market low (McWhirter)
+- Stellium in Taurus (money sign) in 11th house of NYSE chart = bullish
+- Sun/Moon opposition Neptune = bearish (illusion, uncertainty)
 
-### Procedure
-1. Start with a base value (e.g., 0 or the previous day's total).
-2. Each day, calculate all aspects between transiting planets and the natal planets of the NYSE chart (or a corporation's chart).
-3. Add positive aspect values and subtract negative aspect values.
-4. Plot the running total over time.
-5. **Preponderance of positive aspects at market highs** = time to SELL.
-6. **Preponderance of negative aspects at market lows** = time to BUY.
+### Step 5: Corporation Chart Analysis
 
-### Key Insight
-There is a preponderance of positive aspects at market highs (when everyone is optimistic) and a preponderance of negative aspects at market lows (when everyone is pessimistic). The contrarian signal is the astrological signal.
+**When to use:** "Should I buy [specific stock]?"
 
-### Aspect Values
-- Only five major aspects considered: conjunction, sextile, square, trine, opposition
-- Minor aspects (30°, 45°, 135°, 150°) are omitted as they tend to offset each other
-- Transiting Moon is omitted (too fleeting)
-- Orb: 1.5° for all aspects between transiting and natal planets
+**Call**: `calculate_natal_chart(incorporation_datetime, latitude, longitude)` using the corporation's incorporation date and headquarters location.
 
----
+**If time of incorporation is unknown**: Use a solar chart — pass noon UTC as the time, and the agent should note this is an approximate chart.
 
-## Corporation Horoscope Analysis
+**Interpretation:**
+- **Jupiter/Uranus** in favorable aspect to the Sun or chart ruler = upward price trend
+- **Saturn** favorable = conservative growth, stability, reliable dividends
+- **Neptune** prominent = management vision OR illusion/overpromise (check aspects)
+- **Pluto** prominent = transformation, mass psychology, potential for dramatic moves
+- **Mars** prominent = volatility, competitive drive, potential for sharp moves
 
-Corporations are living entities whose lives begin at incorporation. Their horoscopes can be analyzed like natal charts.
+**Stock-Planet Rulerships** (for sector analysis):
+| Industry | Planet |
+|---|---|
+| Iron & steel | Mars |
+| Copper | Venus |
+| Oil & gas | Neptune |
+| Electric utilities | Uranus |
+| Agriculture/real estate | Saturn |
+| Mining (underground) | Pluto |
+| Banking/finance | Jupiter |
+| Technology/innovation | Uranus |
+| Speculation/gambling | Neptune |
 
-### Constructing a Corporation Chart
-1. Use the date of incorporation. If time is unknown, use a solar chart (Sun on Ascendant) with Equal House system and noon planetary positions.
-2. Calculate angular separation between each pair of planets.
-3. Mark negative aspects in RED, positive aspects in GREEN/BLUE.
-4. Orbs: conjunctions 10°, oppositions 8°, sextiles/squares/trines 5°.
-5. Determine aspects from transiting planets (Pluto through Mercury) to natal planets — these indicate when big up/down movements will occur.
-6. Always consider aspects to the company's ruler (planet ruling the sign the Sun is in).
-
-### Interpreting Corporation Charts
-- **Jupiter and Uranus** in favorable aspect to the Sun or chart ruler = upward trend
-- **Saturn** in favorable aspect = conservative growth, stability
-- **Neptune** = management's vision or liability to illusion/delusion
-- **Pluto** = mass production, mass consumption, mass psychology
-- **Mars** = energy, drive, potential for volatility
-- **Venus** = financial harmony, value
-
-### Stock Rulerships
-- Iron and steel: **Mars**
-- Copper: **Venus**
-- Oil: **Neptune**
-- Electric utilities: **Uranus**
-- Agriculture and real estate: **Saturn**
-- Underground mining: **Pluto**
-- Jupiter: optimism/expansion; Saturn: pessimism/contraction; Neptune: illusion/speculation
+**Personal harmony check**: Compare the corporation's chart with the investor's natal chart. Favorable interchart aspects = good fit. Hard aspects = potential friction.
 
----
+### Step 6: Personal Investing Suitability
 
-## Personal Investing — Natal Chart Indicators
+**When to use:** "Should I invest or speculate?"
 
-### Who Should Invest or Speculate
-1. **2nd house** (money from own efforts): Sun, Moon, Venus, or Jupiter in 2nd house or ruling the 2nd house cusp = success through conservative investment. Mars, Saturn, Uranus, Neptune, or Pluto = difficulties.
-2. **5th house** (speculation): Sun, Moon, Venus, Jupiter, or Neptune in 5th house or on its cusp = successful speculation. Mars, Saturn, Uranus, or Pluto = losses.
-3. **Afflicted Jupiter or Neptune in 5th house** = bad judgment from overoptimism.
-4. **Well-aspected Saturn in 5th house** = caution (good for conservative investors).
-5. **Conservative investors** often have Saturn in 2nd or 5th house — should use CDs or Money Market Funds.
+**Call**: `calculate_natal_chart(birth_data, include_overview=true)`
 
-### The Formula for Picking Stocks
-"Buy only those stocks whose natal chart harmonizes with your own natal chart." (Advice from a retired VP of a major bank who went broke in 1929, then became a millionaire using astrology.)
+**What to look for:**
+1. **2nd house** (earned money/investment): Sun, Moon, Venus, or Jupiter in 2nd or ruling 2nd cusp = investment success. Mars, Saturn, Uranus, Neptune, Pluto = difficulties.
+2. **5th house** (speculation): Sun, Moon, Venus, Jupiter, or Neptune in 5th = speculation success. Mars, Saturn, Uranus, Pluto = losses.
+3. **Afflicted Jupiter/Neptune in 5th** = bad judgment from overoptimism. Well-aspected Saturn in 5th = caution (good for conservative investors).
+4. **Formula**: "Buy only stocks whose corporation chart harmonizes with your natal chart."
 
 ---
 
-## Which Stock to Buy
-
-### Practical Steps
-1. Determine your own natal chart's investment profile (2nd and 5th house analysis).
-2. Identify the corporation's natal chart (date of incorporation).
-3. Check for harmonious aspects between your natal planets and the corporation's natal planets.
-4. Analyze transiting aspects to the corporation's chart for timing.
-5. Look for favorable Jupiter and Uranus aspects to the company's Sun or ruler for upward price movement.
-6. Check for unfavorable Saturn, Mars, or Neptune aspects that might indicate decline.
-
-### Williams' Track Record
-Over 23 years of purchasing stocks for cash only, Williams achieved average annual gains of 25%.
-
----
+## Gold, Silver, and Interest Rate Cycles
 
-## Gold and Silver Price Cycles
+**Gold**: 22.11-year cycle (correlates with sunspot cycle). Peaks in gold prices correlate with sunspot peaks. Hedge against currency depreciation.
 
-### Gold
-- **22.11-year cycle** in U.S. gold prices (close to the 22-23 year sunspot cycle)
-- Peaks in gold prices correlate with peaks in sunspot activity
-- Gold is a traditional hedge against currency depreciation
+**Silver**: Similar to gold but more volatile. Industrial demand adds extra drivers.
 
-### Silver
-- Follows similar cyclical patterns to gold but with greater volatility
-- Industrial demand creates additional price drivers
+**Interest rates**: 54-year cycle in English rates (1729-1978). Rising rates = falling bond prices (headwind for stocks). Falling rates = rising bond prices (tailwind for stocks).
 
-### Precious Metals and Planets
-- Astrologers disagree on which planets rule gold and silver
-- Traditional associations: Sun = gold, Moon = silver
-- Some practitioners use Saturn for gold (as the "heavy" metal)
+**When to use**: Call `get_planetary_positions` for dates of interest rate decisions or precious metal market turning points. Look for Jupiter-Saturn aspects as primary drivers.
 
 ---
 
-## Interest Rate Cycles
-
-### The 54-Year Cycle
-The Foundation for the Study of Cycles identified a 54-year cycle in English interest rates (1729-1978), with an ideal high in 1978. There may also be a 60-year cycle at work.
+## Benner's Price Cycles (Quick Reference)
 
-### Dewey's Prediction
-In 1957, Dewey concluded: "As far as our knowledge of cycles goes, the indication is for generally upward interest rates for the next 20 years."
+| Pattern | Years | Rule |
+|---|---|---|
+| Pig iron lows | 11-9-7 | Decreasing series, repeat every 27 years |
+| Pig iron highs | 8-9-10 | Increasing series, repeat every 27 years |
+| Depressions ("C") | 7-11-9 | Average 9 years (Juglar cycle) |
+| Panics ("A") | 16-18-20 | Every third at 54-year intervals |
+| Full revolution | 54 years | Panics return in same order |
 
-### Practical Implications
-- Rising interest rates = falling bond prices = headwinds for stocks
-- Falling interest rates = rising bond prices = tailwinds for stocks
-- The relationship between interest rates and stock prices is inverse
+**Planetary attribution**: Jupiter rules natural production prices. Saturn regulates manufacture/trade. Uranus and Neptune send electric influence affecting Jupiter/Saturn/Earth.
 
 ---
 
-## The Kondratieff Wave
-
-### What It Is
-A 47-60 year cycle in economic activity identified by Russian economist N. D. Kondratieff (1919-21). Williams argues the popular "Prophets of Doom" interpretation is erroneous.
-
-### Williams' Critique
-- Shuman and Rosenau (1972) arbitrarily assumed a 50-year wavelength
-- They ignored Revolutionary War inflation (1780 peak)
-- They attempted prediction from only 2.5 cycles (insufficient data)
-- Actual cycle peaks: 34, 50, 56, 65 years (average 51.25 years)
-- The Kondratieff Wave is a useful framework but not a precise predictive tool
+## Kondratieff Wave: Corrected Understanding
 
-### The Real Pattern
-The 56-year pattern (Funk's chart) combined with planetary aspects provides a more reliable framework than the Kondratieff Wave alone.
+The popular "50-year Kondratieff Wave" is an oversimplification. Actual cycle peaks: 34, 50, 56, 65 years (average 51.25). The cycle length varies too much for precise prediction. Use as a **qualitative framework** (long-wave economic seasons), not a precise timing tool. Combine with Solar Ingress method and transit analysis for better results.
 
 ---
 
-## Key Planetary Signatures for Markets
-
-### Bull Market Indicators
-- Stellium in Taurus (money sign) in the 11th house of the NYSE chart
-- Jupiter-Saturn conjunction sextile North Node in Leo (speculation) in 2nd house (money)
-- Mercury conjunct Venus and sextile Pluto
-- Sun and Moon sextile Uranus
-- Saturn semi-sextile Uranus and Mercury
-- Mercury and Uranus trine Neptune
-- Predominance of trines and sextiles in Solar Ingress charts
-
-### Bear Market Indicators
-- Sun and Moon opposition Neptune
-- Sun and Moon square Jupiter
-- Sun and Moon semi-square Saturn
-- Predominance of squares and oppositions in Solar Ingress charts
-- Transiting Saturn semi-square or sesquiquadrate natal Jupiter or Neptune
-
-### Market Tops
-- Preponderance of positive aspects (everyone optimistic)
-- Greed dominates — "the sky is the limit" mentality
-- Time to SELL
-
-### Market Bottoms
-- Preponderance of negative aspects (everyone pessimistic)
-- Fear dominates — "the bottom will fall out" mentality
-- Time to BUY
-
-### The NYSE Natal Chart
-- **May 17, 1792, 8:52 a.m., New York City**
-- Used as the basis for McWhirter-style analysis
-- Planetary positions at this date are the "natal" planets of the exchange
+## Practical Heuristics for Agents
 
----
-
-## Practical Rules and Heuristics
-
-### Williams' Rules
-1. **Buy during panics, sell during booms.** (Baron Rothschild's principle)
-2. **Don't get married to any stock.** (Don't get hung up on any one forecasting technique.)
-3. **Never gamble with more than you can afford to lose.**
-4. **Don't buy on margin.** Williams lost $620 over 22 years of margin trading.
-5. **Don't sell short.** Williams considers it unethical.
-6. **Don't trade stock options.** Most option traders lose money.
-7. **Don't trade interest rate futures.** The risk is too high.
-8. **Keep emotions under control.** Greed and fear are the two levers that control markets.
-9. **Use cash only.** Williams achieved 25% annual gains buying stocks for cash.
-10. **Verify with multiple methods.** Use Solar Ingress + Running Total Aspects + Corporation charts.
-
-### Dewey's Rules
-1. Determine short-term cycles that have repeated so often they cannot be chance.
-2. Play cycles on an actuarial basis — expect losses but expect gains to exceed losses.
-3. Use moving averages to smooth cycle data.
-4. Watch for compound cycles (e.g., 9.2-year and 38-month cycles combining).
-5. Be aware that cycles can reverse or disappear (the 5.7-year cycle vanished after 1896).
-
-### Benner's Rules
-1. Pig iron prices follow 11-9-7 year low patterns and 8-9-10 year high patterns.
-2. Panics occur at 16-18-20 year intervals.
-3. It takes 54 years for panics to complete a revolution and return in the same order.
-4. The iron industry is the chief indicator of general business conditions.
-
-### Gann's Principles (referenced by Williams)
-- Prices move in cycles that repeat.
-- The square of price and time are key relationships.
-- Support and resistance levels follow geometric patterns.
+1. **Buy during panics, sell during booms** (Rothschild's principle)
+2. **Don't get married to any stock** — use multiple forecasting methods
+3. **Cash only** — avoid margin (Williams lost $620 over 22 years of margin trading)
+4. **Keep emotions under control** — greed and fear are the two levers that move markets
+5. **No technique is 100%** — use multiple methods and take the consensus
+6. **Dewey's actuarial approach**: Play cycles expecting losses, but expect gains to exceed losses over time
+7. **Corporate chart harmony**: Buy stocks whose corporation chart harmonizes with the investor's natal chart
+8. **Location for Solar Ingress**: Use Washington D.C. coordinates (not NYC) — federal economic influence
+9. **Contrarian signal**: Maximum optimism = astrological sell signal; maximum pessimism = astrological buy signal
+10. **Always contextualize**: State which cycle you're analyzing and where we are in it
 
 ---
 
-## Sources
-
-1. David Williams — *Financial Astrology: How To Forecast Business, and the Stock Market* (American Federation of Astrologers, 1982, 1984, 1988) ISBN: 0-86690-045-4
-2. David Williams — *Astro-Economics* (Llewellyn Publications, 1959)
-3. David Williams — *Business Cycle Forecasting* (Journal of Cycle Research, 1959)
-4. Edward R. Dewey & Edwin F. Dakin — *Cycles: The Science of Prediction* (1947)
-5. Edward R. Dewey — *Cycles: The Mysterious Forces that Trigger Events* (1971)
-6. Samuel Benner — *Benner's Prophecies of Future Ups and Downs in Prices* (1875, reprinted 1948)
-7. W. Stanley Jevons — "The Solar Period and the Price of Corn" (1875)
-8. W. D. Gann — *How to Make Profits in Commodities* (1942)
-9. N. D. Kondratieff — *The Long Waves in Economic Life* (1925)
-10. Foundation for the Study of Cycles — *Cycles* magazine (various issues)
-11. John H. Nelson — "Shortwave Radio Propagation Correlation and Planetary Positions" (RCA Review, 1951)
-12. R. C. Carrington — *Observations of the Spots on the Sun* (1863)
-13. Rudolph Wolf — Sunspot number formula (1852)
-14. Jose, P. D. — "Sun's Motion and Sunspots" (Astronomical Journal, 1965)
-15. W. D. McWhirter — Stock market forecasting system (various publications)
+## Interpretation Tone
+
+- **Probabilistic, not deterministic**: Planetary patterns correlate with tendencies, not certainties
+- **Cycle-aware**: Always contextualize within the relevant cycle (are we near a 9.2-year crest or trough?)
+- **Contrarian framing**: Maximum optimism = sell signal; maximum pessimism = buy signal
+- **Multiple method consensus**: Solar Ingress + Transit analysis + Corporation chart + cycle analysis
+- **Risk-aware**: Never present market forecasts as certain; always include the base rate and historical accuracy
+- **No financial disclaimers needed**: This is astrological analysis, not financial advice — but be clear about uncertainty