numerology/CYCLES-DOCUMENTATION.md

Numerology Timing Cycles - Complete Documentation

🌟 Overview

The timing cycles system calculates your personal energy patterns and universal (global) energy to help you plan activities, make decisions, and align your actions with natural rhythms.

📊 The Layered Cycle System

1. Universal Cycles (Global Energy)

Calculated from the current calendar date. Affects everyone on the planet.

• Universal Year - The overarching theme for the entire year globally
• Universal Month - Global monthly energy within the year
• Universal Day - The collective daily energy

2. Personal Cycles (Your Individual Energy)

Calculated from your birthdate + current date. Unique to you.

• Personal Year - Your major theme for the year (9-year cycle)
• Personal Month - Your monthly focus within your yearly theme
• Personal Day - Your daily energy and optimal activities

3. Combined Interpretation

Your personal cycles operate WITHIN universal cycles, creating a layered understanding of timing and energy.

Example:

• Personal Year 5 (Change/Freedom) within Universal Year 8 (Power/Achievement)
• This means: You're seeking freedom and change while the world focuses on power structures
• Strategy: Use global power structures to create personal freedom

🔢 The Pythagorean Math

Why Pythagorean is "Easier"

The Pythagorean system uses sequential reduction with modular calculation:

1. Reduce each component separately
2. Combine the reduced components
3. Reduce the final result
4. Check for master numbers (11, 22, 33) at each step

Calculation Formulas

Universal Cycles

Universal Year = Reduce(Current Year)
Example: 2025 → 2+0+2+5 = 9

Universal Month = Reduce(Universal Year + Current Month)
Example: Year 9 + October (10→1) = 9+1 = 10 → 1

Universal Day = Reduce(Universal Month + Current Day)
Example: Month 1 + 13th = 1+4 = 5

Personal Cycles

Personal Year = Reduce(Birth Month + Birth Day + Current Year)
Example: Born 5/13, Year 2025
  5 + (1+3=4) + (2+0+2+5=9) = 18 → 9

Personal Month = Reduce(Personal Year + Current Month)
Example: PY 9 + October (10→1) = 10 → 1

Personal Day = Reduce(Personal Month + Current Day)
Example: PM 1 + 13th (1+3=4) = 5

Master Number Rules

Master numbers (11, 22, 33) are NOT reduced further.

They appear when:

• A sum equals exactly 11, 22, or 33
• They represent heightened spiritual energy
• They carry both the master number meaning AND the reduced meaning

Example:

• Life Path 11 = 11 (master) + 2 (1+1) energy combined
• Personal Year 22 = 22 (master builder) + 4 (2+2) foundation energy

📅 The 9-Year Personal Year Cycle

Your life operates in repeating 9-year cycles. Each year has a specific theme and energy.

Year-by-Year Breakdown

Year 1 - New Beginnings

• Plant seeds for new 9-year cycle
• Start fresh projects, relationships, ventures
• Be bold and independent
• Best for: Starting businesses, moving, career changes

Year 2 - Patience & Cooperation

• Nurture what was planted
• Build partnerships
• Focus on details
• Best for: Marriage, collaborations, developing relationships

Year 3 - Expression & Creativity

• Creative projects bloom
• Social life expands
• Express yourself fully
• Best for: Creative projects, public speaking, networking

Year 4 - Hard Work & Foundation

• Build solid foundations
• Work hard, get organized
• Create lasting structures
• Best for: Buying property, fitness goals, financial planning

Year 5 - Change & Freedom

• Major life changes possible
• Travel and explore
• Break free from limitations
• Best for: Travel, moving, changing careers, exploration

Year 6 - Responsibility & Service

• Focus on home and family
• Take on responsibilities
• Serve others
• Best for: Marriage, having children, home improvements, teaching

Year 7 - Introspection & Spirituality

• Turn inward
• Spiritual growth emphasized
• Rest and analyze
• Best for: Spiritual retreats, therapy, research, sabbaticals

Year 8 - Achievement & Power

• Harvest time!
• Financial rewards possible
• Career advancement
• Best for: Business expansion, promotions, real estate, authority roles

Year 9 - Completion & Release

• End of 9-year cycle
• Let go of what's finished
• Clear space for new cycle
• Best for: Ending relationships, selling property, clearing clutter

Master Years (11, 22, 33)

• Heightened spiritual energy
• Greater responsibility
• Opportunities for significant impact
• Can be challenging due to intensity

🎯 Practical Applications

Weekly Planning

Use Personal Days to plan your week:

Monday - Personal Day 1:

• Start new projects
• Take initiative
• Be independent

Tuesday - Personal Day 2:

• Collaborate with others
• Handle details
• Be diplomatic

Wednesday - Personal Day 3:

• Creative work
• Socialize
• Communicate ideas

Thursday - Personal Day 4:

• Organize and work hard
• Build foundations
• Be practical

Friday - Personal Day 5:

• Be flexible
• Try new approaches
• Embrace variety

Saturday - Personal Day 6:

• Family time
• Home projects
• Help others

Sunday - Personal Day 7:

• Rest and reflect
• Spiritual practice
• Study

Monthly Planning

Use Personal Months to plan your month:

Month 1: Start new initiatives Month 2: Build partnerships, handle details Month 3: Launch creative projects, socialize Month 4: Work hard, organize, build Month 5: Make changes, travel, explore Month 6: Focus on home/family, take responsibility Month 7: Rest, study, spiritual focus Month 8: Push for achievement, handle business Month 9: Complete projects, clear clutter

Yearly Planning

Use Personal Year to plan major decisions:

Planning to start a business? → Wait for Personal Year 1 or 8 Planning to get married? → Personal Year 2 or 6 ideal Planning major travel? → Personal Year 5 perfect Need to rest and recharge? → Personal Year 7 necessary Want to complete old projects? → Personal Year 9 is completion time

🔮 Advanced Applications

Finding Optimal Days

Want to know which days this month are best for specific activities?

Looking for Personal Day 1 days (new beginnings):

bun cycles.ts find-optimal --birthdate "5/13/1982" --month 10 --year 2025 --number 1

Result: Days 13, 22, 31 are Personal Day 1 in October 2025 → Schedule important meetings, launches, or first steps on these days

Year-Ahead Planning

Generate your entire year's Personal Month cycle:

bun cycles.ts year-ahead --birthdate "5/13/1982" --year 2025

Use this to:

• Schedule major events in optimal months
• Know when to push (Month 1, 8) vs rest (Month 7, 9)
• Plan travel for Month 5
• Schedule family events in Month 6

Relationship Compatibility Timing

Compare two people's cycles to find optimal collaboration times:

When both people are in complementary cycles:

• Person A in Personal Year 1 (pioneering) + Person B in Personal Year 2 (supporting) = Great partnership potential
• Person A in Personal Year 5 (change) + Person B in Personal Year 4 (stability) = Potential conflict or balance

🎯 Telos Integration (Advanced)

Aligning Goals with Cycles

The Power of Alignment: When your telos goals align with your current cycles, success comes more easily.

Example Alignments:

Personal Year 1 + Career Change Goal: ✅ PERFECT ALIGNMENT - Year 1 is for new beginnings → Take bold action, make the change

Personal Year 7 + Certification Study Goal: ✅ PERFECT ALIGNMENT - Year 7 is for deep study → This is your year to go deep into learning

Personal Year 9 + Starting New Business: ❌ MISALIGNMENT - Year 9 is for endings, not beginnings → Wait for next year (Personal Year 1)

Weekly Goal Planning

Match your weekly tasks to your Personal Days:

Your Weekly Telos Tasks:

• Write blog post (Creative - Day 3)
• Client meeting (Cooperation - Day 2)
• Strategic planning (Achievement - Day 8)
• Deep research (Introspection - Day 7)
• Start new project (Initiation - Day 1)

Optimal Schedule:

• Monday (Day 1): Start new project
• Tuesday (Day 2): Client meeting
• Wednesday (Day 3): Write blog post
• Thursday (Day 7): Deep research
• Friday (Day 8): Strategic planning

🛠️ Command Reference

Basic Usage

# Show today's cycles
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles

# Show cycles for specific date
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles --date "12/25/2025"

# Show chart + cycles
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --detailed --cycles

# Export to markdown
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles --format markdown > cycles-report.md

Advanced Usage (Coming Soon)

# Weekly planner
bun telos-week.ts --birthdate "mm/dd/yyyy"

# Analyze goal-cycle alignment
bun telos-cycles-analyze.ts

# Find optimal days for activity
bun cycles.ts find-optimal --birthdate "mm/dd/yyyy" --month 11 --year 2025 --number 8

# Year-ahead cycle calendar
bun cycles.ts year-ahead --birthdate "mm/dd/yyyy" --year 2025

📚 Interpretation Guidelines

Reading Your Cycles

1. Start with Personal Year - This is your overarching theme
2. Add Personal Month context - How the year's energy manifests this month
3. Use Personal Day for daily decisions - Tactical timing
4. Consider Universal cycles - The collective backdrop

When Cycles Conflict

Sometimes your Personal cycle conflicts with Universal cycle or your goals:

Personal Year 7 (rest) in Universal Year 8 (achievement):

• The world pushes for achievement while you need rest
• Strategy: Take strategic rest to prepare for your Personal Year 8 next year

Personal Day 7 (introspection) but urgent deadline:

• Honor both: Do the work but minimize meetings and external focus
• Schedule deep work, avoid starting new things

Master Number Years

Personal Year 11, 22, or 33:

• Heightened responsibility and opportunity
• More intense than regular years
• Potential for significant spiritual growth
• Can be overwhelming - extra self-care needed
• Greater impact on others possible

If you're in a Master Year:

• Trust your intuition more
• Expect big opportunities
• Practice nervous system regulation
• Don't force - allow things to flow
• Serve others from overflow, not depletion

🎓 Learning Numerology Cycles

Beginner Level

1. Calculate your current Personal Year
2. Read the year's theme
3. Notice how it manifests in your life

Intermediate Level

1. Track your Personal Month themes
2. Plan major decisions based on yearly cycles
3. Use Personal Days for weekly planning

Advanced Level

1. Combine with telos goal planning
2. Analyze multi-year patterns
3. Use for relationship and business timing
4. Teach others about their cycles

📖 Recommended Reading

Books:

• "Numerology: The Complete Guide, Vol 1 & 2" by Matthew Oliver Goodwin
• "The Complete Book of Numerology" by David A. Phillips
• "Numerology and the Divine Triangle" by Faith Javane

Practice:

• Track your cycles for 3 months
• Note alignments and conflicts
• Adjust planning based on cycles
• Share insights with friends

🚀 Future Enhancements

Planned Features:

1. Telos-Cycles Integration - Auto-analyze goal alignment
2. Weekly Planner - Personal Day calendar with task suggestions
3. Compatibility Analysis - Compare two people's cycles
4. Life Stages/Pinnacles - Long-term cycle predictions
5. Challenge Numbers - Karmic lessons and obstacles
6. Optimal Days Finder - Find best days for specific activities

---

Remember: Numerology is a tool for understanding energy and timing, not fate. You always have free will. Use cycles as guidance, not rigid rules.

The key insight: Working WITH your natural rhythms makes life easier. Fighting against them creates unnecessary struggle.