How a Kalika Reading Is Actually Built

Most astrology services are opaque. You give them your birth details, you wait, a reading arrives. What happened in between is a black box.

We don't think it should be. Here's exactly what happens between the moment you submit your birth data and the moment the PDF lands in your inbox.

Step 1 — Birth data, validated

When you fill in the checkout form, the place-of-birth lookup uses OpenStreetMap and a timezone library to compute three things: latitude, longitude, and IANA timezone (e.g. Asia/Colombo). All three must be resolved before you can submit. We have one strict rule: we never default a missing timezone to UTC or any other fallback. If the lookup fails, you cannot proceed — because a reading anchored to the wrong timezone is anchored to the wrong sky.

Birth time is required to ten-minute precision for tiers that need angular accuracy (Compatibility, Life Time). A few minutes can move the ascendant across a sign boundary, which changes the chart's foundation.

Step 2 — Question classification

Your written question runs through a fast classifier (Anthropic's Claude Haiku 4.5, via OpenRouter) that places it in one of six domains: career, health, marriage, wealth, spirituality, or general. Each tier has a domain it focuses on:

• Career Directions expects a career question
• Health and Longevity expects a health question
• Compatibility expects a marriage / relationship question
• One Burning Question and Life Time accept any domain

If your question is classified outside the tier you chose, with high confidence, we stop you at checkout and offer you the right tier. We don't take payment for a reading that won't fit your question.

Step 3 — Stripe checkout, then payment

Once the question and tier match, you complete payment via Stripe Checkout. We never see your card. The order record we create on our side carries: your name, email, birth data, question, classifier result, and Stripe session ID. Nothing else.

The instant Stripe confirms payment, the order moves to "paid" status and the next four steps run automatically.

Step 4 — Pre-flight against the Kalika engine

A background job sends your chart to the Kalika engine — our calculation and rule-evaluation server. The engine computes:

• Your full natal chart in the sidereal zodiac
• The four dasha systems and which periods are active now and through 2050
• All applicable rules from our knowledge base, scored against your specific configuration
• Thirteen layers of current transits, weighted

This is the technical core. The output is a structured JSON payload (around 50 KB) that contains everything the human writer of your reading will see. Pre-flight typically completes within 4 seconds.

If the engine errors or times out, we keep the order in queue and an admin retries. We never substitute a partial or fallback computation. A reading that says something the engine did not actually compute is not honest, so we don't ship it.

Step 5 — Confirmation email, then human review

The moment payment clears, a confirmation email arrives in your inbox. It contains your order reference (an 8-character code like ABC12345) and your turnaround window (24 hours for single-chart readings, 48 hours for Compatibility and Life Time).

The pre-flight payload then queues for human writing. Nuwan reviews the engine output, applies the structural template for your tier (the seven-section Life Time format, the focused domain template for tier readings, etc.), and writes the prose that becomes your reading. The engine handles calculation. The human handles synthesis, pacing, ethical framing, and the difficult judgment calls about what to emphasize and what to handle gently.

The writing pass is where care happens. The validation work behind the rules makes that care possible — Nuwan trusts the calculations because they've been tested, and so the writing time is spent on you, not on second-guessing the math.

Step 6 — PDF assembly, delivery email

The completed reading is rendered to PDF using the kalika-reading skill. The PDF is signed (against tampering), uploaded to private storage on Cloudflare R2, and a 30-day signed download link is emailed to the address you provided at checkout.

The link is yours alone. Each click generates a fresh 15-minute access URL behind the scenes — we don't expose your reading at a public URL.

Step 7 — Aftercare

If you reply to the delivery email with a question about your reading, you reach Nuwan. We aim to answer follow-up questions on any specific section at no charge. The reading is yours; the conversation around it should be too.

If you lose the email, the order-status flow at /lookup lets you re-issue the link with just your email + the 8-character order reference.

What is and isn't automated

To summarise what each step looks like in terms of who does it:

Step	Automated	Human
Birth-data validation	✓
Question classification	✓
Payment	✓ (Stripe)
Pre-flight engine computation	✓
Reading prose		✓ Nuwan
PDF assembly	✓
Email delivery	✓
Aftercare		✓ Nuwan

The math is automated because it should be. The reading is hand-written because that's where the judgment lives. Both halves matter.

The reason for the discipline

Vedic astrology is one of the oldest knowledge traditions still in active practice. We try to honour it by being precise about what we do and transparent about what we know. Every layer of the workflow above — the validated rules, the no-fallback timezone, the engine-computed pre-flight, the hand-written prose, the signed download — exists because of one principle: we should never tell you something we did not actually find.

That's how a Kalika reading is built. Every reading. Every time.