Astro Natal МерКаБа

v2.6.0 — полная астрологическая платформа. 10 модулей: натал, транзиты, прогрессии, соляр, синастрия, композит, астероиды, релокация, ведические даши и ректификация. Каждый модуль выдаёт отдельный стилизованный DOCX-отчёт в палитре МерКаБа.

Cowork-скил для построения натальной астрологической карты по дате, времени и месту рождения. Поддерживает западную (тропический зодиак, система домов Плацидус) и ведическую (сидерический Лахири, 27 накшатр, Whole Sign) системы.

Расчёты — через Swiss Ephemeris (JPL DE431, точность <0.001°). На выходе — стилизованный DOCX 6-12 страниц с колесом карты, архетипической интерпретацией планет, аспектов, домов, накшатр и практическими рекомендациями. Интерпретации генерируются Claude в момент составления отчёта на основе классических архетипов из встроенных reference-библиотек.

Нужен расширенный 15-25-страничный отчёт? См. приватную версию astro-natal-simond-full — там интерпретации не генерируются LLM, а подставляются из встроенной библиотеки ~1849 заранее написанных архетипов.

---

⚠️ Дисклеймер

Скил даёт архетипический инструмент саморефлексии, а не предсказание событий, медицинский диагноз или психологическую консультацию. Натальная карта описывает энергетические тенденции и точки роста — не судьбу. Все жизненные решения — за вами.

---

Установка

Вариант A — Cowork (для команды)

1. Скачайте astro-natal-simond.skill из этого репо.
2. В Cowork: Customize → Skills → Upload — выберите файл.
3. Активация по триггерам в чате: натальная карта, астрологический расчёт, построй карту, астрологический разбор.

Вариант B — Локальный запуск

git clone https://github.com/klasnyi/astro-natal-simond.git
cd astro-natal-simond

# Зависимости (Python 3.11 рекомендуется — kerykeion может отставать на новых)
pip install kerykeion geopy timezonefinder python-docx matplotlib

# Smoke test (эталонная карта)
python3 scripts/build_chart.py \
  --date 13.08.1993 --time 5:30 --city "Москва" --name "Test" \
  --system western --outdir /tmp/astro-smoke

# Должен вернуть: Sun Лев 20.32° дом 1, ASC Лев 14.68°

Вариант C — Установка как Claude Code skill

git clone https://github.com/klasnyi/astro-natal-simond.git ~/.claude/skills/astro-natal-simond

---

Все 10 модулей

Модуль	Что даёт	Скрипты	Что нужно
🌟 Натал	Натальная карта 15-25 страниц с колесом, планетами, домами, аспектами, стихиями	build_chart.py + render_docx.py	Дата, время, место
🌠 Транзиты	Что прямо сейчас активирует карту, прогноз	build_transits.py + render_transits_docx.py	Натал из кэша + дата
📈 Прогрессии	Символическое развитие (1 день = 1 год)	build_progressions.py + render_progressions_docx.py	Натал
☀️ Соляр	Карта на год от ДР до ДР	build_solar.py + render_solar_docx.py	Натал + город пребывания в ДР
💞 Синастрия	Совместимость с партнёром: cross-аспекты + house overlays	build_synastry.py + render_synastry_docx.py	Две натальных карты
🌓 Композит	Карта отношений как третьей сущности (midpoint method)	build_composite.py + render_composite_docx.py	Две натальных карты
⚳ Астероиды	Церера, Паллада, Юнона, Веста + Хирон	build_asteroids.py + render_asteroids_docx.py	Натал
🌍 Релокация	Что меняется при переезде в другой город (новые ASC/MC/дома)	build_relocation.py + render_relocation_docx.py	Натал + целевой город
🕉 Ведические даши	Vimshottari mahadasha + antardasha (120-летний цикл)	build_dashas.py + render_dashas_docx.py	Натал с временем
🔍 Ректификация	Восстановление неизвестного времени рождения	build_rectification.py + render_rectification_docx.py	Натал (приблиз. время) + 3-7 событий жизни

Все модули используют общий пайплайн: натальная карта (через build_chart.py) кэшируется в ~/.astro-natal-simond/cache/, остальные модули читают из кэша. DRY-паттерн: константы и helpers — из build_transits.py, палитра DOCX — из render_docx.py.

---

Что делает скил (натальная карта)

Поддерживаемые системы

Система	Зодиак	Дома	Особенности
Западная	Тропический	Плацидус	Транзитная астрология, психология
Ведическая	Сидерический Лахири (~23.79°)	Whole Sign	27 накшатр, ведические даши
Солнечная (без времени)	По выбору	—	Только знаки планет, без ASC и домов

Что входит в отчёт натала

• 🌞 Солнце-Луна-Асцендент — синтез ядра карты
• 🪐 13 планет (Солнце → Меркурий → Венера → Марс → Юпитер → Сатурн → Уран → Нептун → Плутон → Северный Узел → Хирон → Лилит) — каждая 8-15 предложений с привязкой к градусу, дому, диспозитору, аспектам
• 🏠 Все 12 домов (если время известно) — управитель, планеты в доме, темы
• ⭐ 10+ ключевых аспектов (орб ≤3°) — каждый с расшифровкой 6-10 предложений
• 🔥💧🌍💨 Стихии и модальности — % распределение, дефицит, компенсация
• 🌌 Стеллиумы — если есть, отдельный анализ
• 🕉 Накшатры (ведический режим) — Луна и Асцендент с символами, божествами
• 🎯 8-12 практических рекомендаций — конкретно под карту, не общие

Архитектура

scripts/
├── build_chart.py + render_docx.py + astro_helpers.py     # натал + общая палитра + кэш
├── build_transits.py + render_transits_docx.py            # транзиты (источник DRY-констант)
├── build_progressions.py + render_progressions_docx.py    # прогрессии
├── build_solar.py + render_solar_docx.py                  # соляр
├── build_synastry.py + render_synastry_docx.py            # синастрия
├── build_composite.py + render_composite_docx.py          # композит
├── build_asteroids.py + render_asteroids_docx.py          # астероиды
├── build_relocation.py + render_relocation_docx.py        # релокация
├── build_dashas.py + render_dashas_docx.py                # vimshottari даши
└── build_rectification.py + render_rectification_docx.py  # ректификация

references/                                                # 5 JSON архетипов (натал)

Интерпретации генерирует Claude в момент составления отчёта — синтезируя chart.json с reference-файлами по промту в SKILL.md. Не pre-written: каждая карта получает уникальный текст.

---

Использование

В Cowork — chat-native flow

Скил спрашивает обычным сообщением (без модальных окон):

Для натальной карты нужно 5 данных:

1. Дата рождения (ДД.ММ.ГГГГ)
2. Время рождения (ЧЧ:ММ) — или скажи "время неизвестно"
3. Город рождения
4. Имя
5. Система — западная / ведическая / обе

Можно ответить одним сообщением — скил распарсит. Дополнительные модули запускаются по своим триггерам: транзиты, прогрессии, соляр, синастрия, композит, астероиды, релокация, ведические даши, ректификация.

Локально через CLI

Полные примеры команд для всех 10 модулей — в SKILL.md. Эталонный smoke натала:

python3 scripts/build_chart.py \
  --date 13.08.1993 \
  --time 5:30 \
  --city "Москва" \
  --name "Дмитрий" \
  --system western \
  --outdir /tmp/astro-dima

---

Эталонная карта (smoke test)

Тестовые данные: 13.08.1993, 05:30, Москва, западная система.

Ожидаемое ядро карты:

Параметр	Значение
☉ Солнце	Лев 20.32°, дом 1
☽ Луна	Близнецы 18.34°, дом 11
↑ Асцендент	Лев 14.68°
⊕ MC	Овен 23.35°
Доминанта стихий	Воздух 4 · Огонь 3 · Земля 2 · Вода 2

Сверхточные аспекты (орб <1°):

1. Уран ☌ Нептун — 0.07° (Козерог, 6 дом — поколенческая тема)
2. Сатурн ☍ Хирон — 0.38° (Водолей 7 ↔ Лев 1 — центральная ось)
3. Меркурий △ Лилит — 0.9° (Лев 12 / Овен 9)

Если ваш прогон даёт другие значения — что-то сломалось (см. секцию Точность ниже).

---

Качество интерпретаций — стандарты

Закреплены в SKILL.md:

• 8-15 предложений на планету с привязкой к градусу, дому, диспозитору, аспектам
• 10+ аспектов с орбом ≤3°, каждый 6-10 предложений с движением (applying/separating) и интенсивностью
• Все 12 домов (если has_time=true)
• Стеллиумы — если есть, отдельный анализ
• Стихии и модальности — % с расшифровкой дефицита и компенсаторных практик
• Итог — DOCX 15-25 страниц, ~15-25 тыс. слов

Конкретика обязательна:

• ❌ «У вас сильное Солнце»
• ✅ «Солнце во Льве 20.32° в 1.5° от ASC, в соединении с Хироном 27° — ядро идентичности слито с маской и раной»

---

Точность

Параметр	Значение
Эфемерида	Swiss Ephemeris (JPL DE431)
Точность планет	<0.001°
Геокодинг	Nominatim (OpenStreetMap)
Таймзоны	timezonefinder (оффлайн БД с историческими TZ)
ASC/MC формула	Истинное местное звёздное время
Дома (западная)	Алгоритм Плацидуса (Meeus, Astronomical Algorithms)
Аянамша (ведическая)	Лахири (Chitrapaksha)
Solar return	Бинарный поиск 0.0001° (~0.36 arcsec)
Vimshottari	Полные 120 лет с pratyantardasha (опц.)
Композит	Midpoint через короткую сторону круга

Чтобы проверить точность — сравните с astro.com (бесплатный профессиональный калькулятор).

---

Релизы

См. CHANGELOG.md. Краткая лента:

• v2.6.0 (2026-04-26) — Lite scope expansion: signs_on_cusps (192) + aspects_archetypes (225) перенесены из Full
• v2.5.0 (2026-04-26) — Lite scope expansion: 8 планет × 12 домов/знаков (240 entries из Full v1.4.2)
• v2.4.x (2026-04-26) — Sun/Moon polish + sync from Full
• v2.0.0 — финальный релиз 10 модулей: единая палитра МерКаБа
• v1.10.0 — Phase 11: Ректификация (восстановление времени по событиям)
• v1.9.0 — Phase 7: Vedic dashas (Vimshottari mahadasha + antardasha)
• v1.8.0 — Phase 9: Релокация (recast for new city)
• v1.7.0 — Phase 8: Астероиды (Ceres, Pallas, Juno, Vesta + Chiron)
• v1.6.0 — Phase 6: Композит (midpoint method)
• v1.5.0 — Phase 5: Синастрия (cross-aspects + house overlays)
• v1.4.0 — Phase 4: Соляр (Solar Return бинарным поиском)
• v1.3.0 — Phase 3: Прогрессии (secondary progressions)
• v1.2.0 — Phase 2: Транзиты (transit-to-natal aspects)
• v1.1.x — Phase 1: Foundation (cache, slug, parsers, authorship cleanup)
• v1.0.0 — натал: GitHub baseline

---

Технический стек

• Python 3.11 (3.12+ может работать, но kerykeion отстаёт)
• kerykeion 5.12.8 — обёртка над Swiss Ephemeris
• pyswisseph 2.10.03 — Python-биндинги Swiss Ephemeris (JPL DE431)
• python-docx 1.2.0 — DOCX генерация
• matplotlib 3.10.9 — колесо карты PNG
• geopy — геокодинг через Nominatim
• timezonefinder — оффлайн TZ resolution

---

Лицензия

MIT.

Swiss Ephemeris данные распространяются по двойной лицензии (GPL/коммерческая) — используется через kerykeion обёртку.

---

Связанные проекты

• karmic-numerology-simond — Cowork-скил Циклической Матрицы МерКаБа (нумерология).

---

Автор

Дмитрий (@klasnyi · dimkaklasnyi@gmail.com) — концепция и разработка.

Бренд МерКаБа — стилевая идентичность серии скилов саморефлексии (золото / тёмно-серый / синий-акцент, типографика палитры Calibri 11pt).