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
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
03 · Producto
04 · Arquitectura
05 · Contenido
06 · Desarrollo
07 · Tu plan
ADR
Cómo usar este paquete
Con Claude Code (para construir):
- Crea el proyecto siguiendo Entornos §2.
- Copia
docs/, CLAUDE.md y .claude/ a la raíz del repo y haz commit.
- 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.
