Señal — inglés de A1 a C2, del ruido a la señal

Documentación completa para construir Señal, tu web app personal para aprender inglés de A1 a C2 con foco en listening y reading, y tu plan de estudio para pasar de B1 a B2 mientras la construyes.

Escrita como tu profesor de inglés y como ingeniero de software. Versiones y servicios verificados en octubre de 2026 (Next.js 16, Supabase, Cloudflare R2, Azure AI Speech, Claude API, ts-fsrs). «Señal» es un nombre de trabajo: cámbialo cuando quieras.

---

Por dónde empezar

Si quieres…	Empieza por
Estudiar hoy mismo (sin esperar a la app)	Tu plan B1 → B2 → Rutina semanal
Construir la app	Visión → Roadmap → Entornos → Prompts por fase
Entender el método	Metodología → Listening

---

Decisiones de partida

Tema	Decisión
Público	Solo tú (un usuario), con user_id + RLS en todo por si algún día la abres
IA	Contenido pregenerado y revisado + corrección de writing en vivo con límite diario y tope de gasto
Stack	Next.js 16 + Supabase, PWA, audio en Cloudflare R2, TTS con Azure AI Speech, IA con la Claude API
Tu nivel	B1 → contenido producido primero para B1 y B2
Prioridad	Listening > Reading > Vocabulario > Writing > Speaking
Coste	≈ 0 € de infraestructura; IA ≈ 25–35 $ en total para todo el currículo + céntimos al mes de writing

---

Contenido del paquete

senal/
├── README.md                       ← estás aquí
├── CLAUDE.md                       ← instrucciones para Claude Code (va a la raíz del repo)
├── .claude/skills/crear-leccion/   ← skill de Claude Code para crear y publicar lecciones
├── skill-claude-ai/senal/          ← guía maestra en formato skill, para usar en claude.ai
└── docs/
    ├── 00-vision/                  visión, alcance y glosario
    ├── 01-pedagogia/               cómo se aprende con Señal (el «porqué» de cada función)
    ├── 02-curriculo/               un documento por nivel A1–C2
    ├── 03-producto/                funcionalidades, pantallas, plan diario, gamificación, diseño
    ├── 04-arquitectura/            stack, carpetas, BD (SQL), contenido (Zod), audio, IA, seguridad, PWA
    ├── 05-contenido/               pipeline, calidad, licencias, prompts y 2 lecciones de ejemplo
    ├── 06-desarrollo/              roadmap, convenciones, testing, despliegue, prompts por fase
    ├── 07-tu-plan/                 tu plan de estudio B1 → B2, rutina y recursos
    └── adr/                        10 decisiones de arquitectura

---

Índice completo

00 · Visión

• Visión y alcance — problema, propuesta en 5 pilares, alcance, métricas, riesgos.
• Glosario — términos de pedagogía, medición y técnica.

01 · Pedagogía

• El marco: MCER, horas, vocabulario y escala interna
• Metodología — diez principios y reparto de tiempo.
• Listening — por qué te cuesta, ciclo de escucha, dictado diagnóstico, drills, acentos.
• Reading — ciclo de lectura, subdestrezas, velocidad, volumen, selección de textos.
• Vocabulario y SRS — léxico personal, cobertura, FSRS, tipos de tarjeta.
• Gramática — formato de fichas y ficha de ejemplo.
• Writing y speaking — rúbrica, feedback, shadowing.
• Evaluación y nivel — test inicial, Elo, pruebas de confirmación.
• Errores típicos de hispanohablantes — sonidos, formas débiles, habla conectada, falsos amigos.

02 · Currículo

• Cómo leer el currículo · A1 · A2 · B1 · B2 · C1 · C2

03 · Producto

• Funcionalidades — catálogo con prioridad y fase; definición del MVP.
• Pantallas y flujos — rutas, wireframes, flujos, atajos.
• Motor del plan diario — algoritmo de «Hoy».
• Gamificación sana — XP, racha, barras de señal, logros.
• Sistema de diseño — cómo se aplica el diseño, componentes, accesibilidad. La fuente de verdad visual es design-system/senal/MASTER.md.

04 · Arquitectura

• Stack · Arquitectura y carpetas · Base de datos · Modelo de contenido · Audio y reproductor · IA · Seguridad y privacidad · PWA, rendimiento y accesibilidad

05 · Contenido

• Pipeline · Control de calidad · Fuentes y licencias · Prompts de generación
• Ejemplos: Watching the Orionids (escucha B1) · The Second Life of Old Games (lectura B1)

06 · Desarrollo

• Roadmap · Convenciones · Testing y calidad · Entornos y despliegue · Prompts por fase

07 · Tu plan

• Plan B1 → B2 · Rutina semanal · Recursos externos

ADR

• Índice de decisiones

---

Cómo usar este paquete

Con Claude Code (para construir):

1. Crea el proyecto siguiendo Entornos §2.
2. Copia docs/, CLAUDE.md y .claude/ a la raíz del repo y haz commit.
3. Abre Claude Code en el repo y pega el prompt de la fase 0.

En claude.ai (para pensar, planificar o generar lecciones en un chat): usa skill-claude-ai/senal/ como una skill más, igual que las de tus otros proyectos. Si copias docs/ dentro de esa carpeta, Claude podrá consultar el detalle.

Para estudiar: empieza hoy con tu plan. La app irá sustituyendo los recursos externos fase a fase.

---

Mantener la documentación viva

• Si cambia una decisión técnica → nuevo ADR, no edites el antiguo.
• Si cambia el método → actualiza el documento de pedagogía y, si afecta a la app, el de producto.
• Antes de instalar, comprueba las versiones actuales de los paquetes: esta documentación fija las decisiones, no los números de versión exactos.