diff --git a/docs/active_context.md b/docs/active_context.md
new file mode 100644
index 0000000..de6f294
--- /dev/null
+++ b/docs/active_context.md
@@ -0,0 +1,58 @@
+# Active Context - api-ubigeo
+
+> Última actualización: 2026-03-10
+
+## Estado Actual
+
+**PRODUCCIÓN ACTIVA** — `https://api-ubigeo.darkcodex.dev` responde correctamente desde internet.
+
+- Health: `GET /api/v1/health` → `{"status":"ok"}`
+- Distritos: `GET /api/v1/ubigeo/distritos?q=lima&limit=10` → HTTP 200
+
+## Decisiones Recientes
+
+### 2026-03-10
+- **Traefik en Easypanel usa file provider con `main.yaml`** — NO es `directory:`, solo lee ese único archivo
+- El archivo `api-ubigeo.yaml` separado que creamos antes era ignorado por Traefik
+- **Solución**: inyectar los routers/services directamente en `main.yaml` usando `jq` vía `docker run -v`
+- El runner de Gitea corre en un contenedor sin acceso directo al host filesystem, pero puede usar `docker run -v /host/path:/container/path` para acceder a rutas del host
+- `main.yaml` está en JSON (no YAML real), Traefik lo acepta igual
+- Routers agregados: `http-ubigeo-0` (redirect https) y `https-ubigeo-0` (TLS letsencrypt)
+- Service: `ubigeo_api-0` → `http://ubigeo-api:3200/`
+
+## Infraestructura
+
+### Contenedor
+- Imagen: `ubigeo-api:latest` (multi-stage build, node:20-alpine)
+- Puerto interno: 3200
+- Redes: `api-ubigeo_ubigeo_network` + `easypanel`
+- Deploy path: `/home/deployer/api-ubigeo/`
+
+### Traefik
+- Config file: `/etc/easypanel/traefik/config/main.yaml` (JSON)
+- El CI inyecta routers via `jq` con `docker run -v`
+- Idempotente: verifica si `https-ubigeo-0` ya existe antes de agregar
+
+### CI/CD
+- Gitea runner: `contabo-runner` en `gitea_gitea_net`
+- Runner corre en contenedor pero con acceso a Docker socket del host
+- Workflow: `.github/workflows/deploy.yml`
+- Run exitoso: #29
+
+## Pendiente Próxima Sesión
+
+- Nada crítico en api-ubigeo
+- Pendiente en Impulsa Mobile: probar autocomplete de distrito con API live
+
+## Contexto Técnico
+
+### Workarounds
+- `main.yaml` se sobreescribe en cada deploy de Easypanel → el CI debe reinjectar la ruta si eso ocurre
+- El step `Register Traefik route` es idempotente (no duplica si ya existe)
+
+### Archivos Clave
+- `.github/workflows/deploy.yml` — CI/CD completo
+- `docker-compose.production.yml` — producción con red easypanel
+- `scripts/register-traefik.sh` — script legacy (ya no se usa, se puede eliminar)
+- `src/modules/ubigeo/ubigeo.controller.ts` — endpoints
+- `src/modules/ubigeo/dto/ubigeo.dto.ts` — DTOs