# Alwenna — una astróloga de AI personificada

Un producto de astrología de consumo construido sobre mi API de Astrolinkers: una astróloga de AI personificada que lee tu carta natal real (Western y Vedic) y la explica en lenguaje sencillo y cálido. Su estrella es la compatibilidad. El LLM está estrictamente anclado — solo reformula los hechos que calcula el motor de cartas, y nunca los inventa. En beta.

- **Author:** Fedor Chishchin
- **Role:** Solo founder-engineer
- **Period:** 2025 — presente
- **Stack:** TypeScript · Next.js · React · FastAPI · Python · PostgreSQL · Astrolinkers API · Railway
- **Source:** https://fedorthinks.com/es/work/alwenna

---

## El problema

La astrología de consumo se divide en dos formas malas. De un lado, apps de horóscopos superficiales que
le entregan a todo el mundo la misma frase diaria y vaga. Del otro, herramientas de cartas serias tan
densas de jerga — casas, aspectos, Ashtakoota — que solo los entusiastas pueden leerlas. Ninguna le dice
a una persona normal qué significa su cielo real para su vida, sus talentos y las personas que ama.

Alwenna está construida para ese hueco, y deliberadamente no es "una app". Es un _who_, no un _what_: una
astróloga personificada con la que conversás. Lee tu carta natal real — Western y Vedic — y la explica en
lenguaje sencillo, cálido y honesto. Sin horóscopos vagos, y nunca moralizante.

## Qué hace el producto

Le das a Alwenna tu fecha, hora y lugar de nacimiento; ella mapea tu cielo verdadero y empieza una
conversación. La estrella es la **compatibilidad**, pensada de a pares: traele dos personas y combina la
sinastría Western con el Ashtakoota Vedic para mostrar dónde fluyen, dónde chocan y cómo hacer que
funcione — en lenguaje sencillo, no en jerga, con un puntaje general de armonía desglosado en lo
emocional, la atracción, la comunicación y el largo plazo.

Alrededor de eso se ubica el resto: una **carta natal** real explicada posición por posición por lo que
significa en la vida; un **perfil de talentos** ordenado con las posiciones exactas detrás de cada
fortaleza; **Ask Alwenna** — una respuesta cálida y específica a una pregunta real sobre vos y alguien
que te importa, como escribirle a una amiga sabia; una **línea de tiempo** de tus temporadas de
crecimiento y tensión; y un **reporte profundo** escrito completo que podés exportar a PDF y conservar.
Multilingüe desde el primer día (inglés, español, portugués, ruso), mobile-first y con temas.

## Qué construí

**El producto de consumo sobre mi propia API.** Alwenna es la cara de consumo de
[Astrolinkers](/work/astrolinkers), la API de anclaje de cartas que construí. Astrolinkers calcula la
astrología — cartas Western y Vedic, sinastría, Ashtakoota, talentos — de forma determinista; Alwenna
convierte eso en una persona con la que podés hablar. El planteamiento del producto, la arquitectura, el
agente y la revisión son míos; la implementación la producen agentes de AI contra una especificación por
etapas, cada etapa construida de principio a fin con tests y un informe escrito.

**Un agente anclado, no un chatbot que "sabe" de astrología.** La regla dura: Astrolinkers es la única
fuente de hechos astrológicos. El LLM nunca inventa una posición, un puntaje ni una interpretación — solo
reformula afirmaciones ancladas en la voz cálida de Alwenna. Así, cada afirmación que hace se remonta a
una carta real, calculada, no a la imaginación del modelo. Esa es toda la diferencia entre una AI que
apenas suena segura y una en la que podés confiar.

**Una superficie de producto real.** Una PWA mobile-first, cuatro idiomas desde el primer día, temas, la
estrella de la compatibilidad, cartas natales, perfiles de talentos, una conversación "ask", reportes
profundos en PDF, y una escalera de planes de gratis a pago (gratis, y luego un nivel mensual y uno anual).

## Decisiones arquitectónicas

**El anclaje es una restricción arquitectónica, no un prompt.** "El LLM solo reformula" está garantizado
en el diseño: el agente envuelve a Astrolinkers para los hechos, y al modelo se lo invoca solo para
frasear — nunca para decidir qué es verdad. Es la misma disciplina sobre la que sigo escribiendo: anclá
el modelo en una fuente determinista, dejalo hablar, y nunca dejes que sea el autor de los hechos.

**Un motor, una voz.** Alwenna está construida sobre la API de Astrolinkers para los hechos, con una capa
de agente delgada encima. La web app solo habla con la API por HTTPS; la API es el agente que compone los
hechos anclados con una única pasada de reformulación del LLM. Los contratos compartidos se generan desde
el OpenAPI de la API hacia clientes TypeScript tipados y esquemas Zod, de modo que la web y la API nunca
puedan divergir.

**Clean architecture, estricta.** Ambos deployables siguen clean architecture — un dominio puro (sin IO,
sin tiempo, sin aleatoriedad), servicios cableados por dependency injection, adaptadores en el borde de
IO — con SOLID, sin precios ni listas de modelos hard-coded en la lógica, los fallos esperados como
valores Result en lugar de excepciones, y 100% de cobertura en dominio y servicios. La misma vara de
ingeniería que en el resto de mi trabajo.

**Mobile-first y multilingüe desde el primer día.** Es una PWA phone-first, diseñada en el viewport del
teléfono antes que en el desktop, con i18n como requisito de día uno — sin strings de cara al usuario
hard-coded en ningún lado — en inglés, español, portugués y ruso, porque la audiencia es global y la
lectura es personal, y ocurre en un teléfono.

## Estado actual

Alwenna está en vivo en beta en [alwenna.com](https://alwenna.com) — una PWA mobile-first con la estrella
de la compatibilidad, la carta natal, los talentos, "Ask Alwenna", la línea de tiempo y los reportes
profundos, en cuatro idiomas, sobre una escalera de planes de gratis a pago. Corre sobre la API de
Astrolinkers para los hechos anclados. Es la mitad de consumo de un par que construí en solitario:
Astrolinkers es el motor, Alwenna es la persona — y juntos son una demostración funcionando de aquello que
sigo defendiendo: un LLM que es útil precisamente porque está anclado, y al que nunca se le permite
inventar los hechos.
