Decisiones de funcionalidades futuras
Decisiones tomadas sobre nuevas funcionalidades a integrar en el ecosistema (segundo cerebro, auth portal, GitHub console). No implementar aún — documentar, evaluar y priorizar.
1. Transcripción de voz
Decisión: Agregar transcripción de voz para capturar ideas, notas y tareas sin escribir.
Contexto: El usuario quiere poder hablar en lugar de escribir, especialmente al llegar a casa o en movimiento. La bóveda ya tiene sincronización (Syncthing) y un segundo cerebro web.
Opciones consideradas:
- Web Speech API (navegador): gratis, sin backend, funciona en Chrome/Edge. Limitado a navegadores compatibles.
- Whisper (OpenAI): muy preciso, soporta español, requiere API key y backend.
- Whisper local (whisper.cpp): offline, privado, requiere instalación en el equipo.
- Coucou Flow dictation: Coucou ya tiene dictado por voz offline con Parakeet (Apple Silicon) o reconocimiento del sistema. Integrar con el ecosistema.
Decisión preliminar: Empezar con Web Speech API para el prototipo (gratis, sin backend). Evaluar Whisper local para mayor precisión. Integrar con Coucou si el usuario lo usa en Mac.
Dónde se implementa: Auth Portal (botón de micrófono en el dashboard) + endpoint en la bóveda (nota diaria por voz).
Dependencias: Ninguna para Web Speech API. Para Whisper: API key o instalación local.
2. Entender contexto IA para conversar según mi contexto
Decisión: La IA debe entender el contexto completo del usuario (notas, tareas, proyectos, bloqueos) para conversar de forma personalizada.
Contexto: El usuario quiere que OpenCode y Claude “entiendan” su situación actual: qué está estudiando, qué bloqueos tiene, qué tareas tiene pendientes, qué proyectos está desarrollando.
Opciones consideradas:
- RAG (Retrieval-Augmented Generation): Indexar la bóveda con embeddings y consultar por similitud semántica. Requiere vector database (Chroma, Pinecone, o local).
- Contexto completo en prompt: Enviar las notas relevantes como contexto en cada conversación. Limitado por el tamaño del contexto del modelo.
- MCP Server para Obsidian: Usar un servidor MCP que exponga la bóveda a Claude/OpenCode. Ya existe
realclaudianplugin para Obsidian. - Archivo de contexto: Un archivo
CONTEXTO.mdque se actualiza automáticamente con el estado actual (tareas pendientes, último sprint, bloqueos). Se envía como system prompt.
Decisión preliminar: Combinar enfoques:
- Crear un archivo
CONTEXTO.mden la bóveda que se actualiza con el estado actual (tareas pendientes, sprint activo, bloqueos). - Usar RAG para búsqueda semántica (evaluar Chroma local o embeddings de OpenAI).
- Mantener el plugin
realclaudianpara Claude en Obsidian. - Para OpenCode, agregar un comando que lea el contexto + notas relevantes antes de responder.
Dónde se implementa: Bóveda (archivo CONTEXTO.md) + OpenCode (comando personalizado) + Claude (via realclaudian).
Dependencias: Para RAG: vector database. Para contexto completo: ninguna (solo lectura de archivos).
3. Voz propia (text-to-speech con voz personalizada)
Decisión: Generar audio con la voz del usuario para leer notas, resúmenes y respuestas de IA.
Contexto: El usuario quiere escuchar sus notas o respuestas de IA con su propia voz, para revisar mientras camina o hace otras cosas.
Opciones consideradas:
- ElevenLabs: Clonación de voz de alta calidad. API de pago (free tier limitado).
- Coqui TTS: Open source, clonación de voz local. Requiere GPU.
- Web Speech API (SpeechSynthesis): Gratis, voces del sistema. No es la voz del usuario.
- Piper TTS: Open source, voces pre-entrenadas. No clona voz pero es offline y rápido.
- Coucou: Ya tiene TTS integrado para respuestas de IA (usa API keys del usuario).
Decisión preliminar: Empezar con Web Speech API para prototipo (gratis). Evaluar ElevenLabs para clonación real. Integrar con Coucou si el usuario lo usa en Mac.
Dónde se implementa: Auth Portal (botón “leer nota” en el dashboard) + segundo cerebro (botón en cada nota).
Dependencias: Para ElevenLabs: API key. Para Coqui: GPU + instalación.
4. Integración con GitHub
Decisión: Integrar GitHub más allá de SSH: issues, PRs, actividad, repositorios.
Contexto: El usuario ya tiene SSH configurado. Quiere ver su actividad de GitHub, crear issues, revisar PRs desde el ecosistema.
Opciones consideradas:
- GitHub API (REST/GraphQL): Acceso completo. Requiere token (PAT o OAuth).
- GitHub CLI (
gh): Ya instalado. Permite operaciones desde terminal. - GitHub Webhooks: Notificaciones de eventos (push, PR, issue) en tiempo real.
- GitHub Actions: Automatización (ya configurado para deploy de Quartz).
Decisión preliminar:
- Instalar
ghen el equipo (ya hecho). - Crear un endpoint en la consola de GitHub que muestre: repos recientes, issues abiertos, PRs pendientes, actividad.
- Agregar webhooks para notificaciones en el segundo cerebro.
- Usar la API de GitHub para crear issues desde notas (ej. “crear issue desde esta nota”).
Dónde se implementa: GitHub Access Console (extender con API) + segundo cerebro (widget de actividad).
Dependencias: Token de GitHub (PAT con scopes repo, read:user).
5. Integración con LinkedIn
Decisión: Integrar LinkedIn para networking y búsqueda de empleo.
Contexto: El usuario quiere conectar su segundo cerebro con LinkedIn para compartir aprendizajes, buscar oportunidades y mantener su perfil actualizado.
Opciones consideradas:
- LinkedIn API: Limitada. Requiere aprobación de app. Acceso a perfil, posts, conexiones.
- LinkedIn Share API: Compartir posts desde el ecosistema.
- Scraping (no recomendado): Viola ToS.
- RSS de LinkedIn: Algunos perfiles tienen feed RSS.
Decisión preliminar:
- Usar la API de LinkedIn para compartir posts (ej. “compartir esta nota en LinkedIn”).
- Mostrar estadísticas de perfil (conexiones, vistas) en el dashboard.
- Evaluar si vale la pena la complejidad de la aprobación de app.
Dónde se implementa: Auth Portal (widget de LinkedIn) + segundo cerebro (botón “compartir en LinkedIn”).
Dependencias: LinkedIn app aprobada + OAuth token.
6. Integración con bolsas de empleo
Decisión: Integrar búsqueda de empleo desde el ecosistema.
Contexto: El usuario está en formación (Sprint 0, Etapa 1-5) y eventualmente buscará empleo en desarrollo/forense. Quiere tener un dashboard de ofertas relevantes.
Opciones consideradas:
- APIs de bolsas de empleo: LinkedIn Jobs, Indeed, Glassdoor (la mayoría requieren partnership).
- RSS de búsquedas: Algunas bolsas ofrecen RSS de búsquedas guardadas.
- Scraping (no recomendado): Viola ToS.
- Manual: El usuario guarda ofertas interesantes como notas en la bóveda.
Decisión preliminar:
- Crear una carpeta
05_Profesional/Ofertas/en la bóveda para guardar ofertas manualmente. - Si se consigue acceso a APIs, crear un widget de búsqueda.
- Integrar con la bitácora: “ofertas aplicadas”, “entrevistas”, “seguimiento”.
Dónde se implementa: Bóveda (carpeta de ofertas) + segundo cerebro (widget de seguimiento).
Dependencias: APIs de bolsas de empleo (la mayoría requieren partnership).
7. Integración con Coucou
Decisión: Integrar Coucou (el companion de Mac notch) con el ecosistema.
Contexto: Coucou es un app open source (MIT) que vive en el notch del Mac y monitorea agentes de IA (Claude Code, OpenCode, Cursor, etc.). Tiene dictado por voz, TTS, chat con IA, notificaciones y más. El usuario ya lo usa (está en ~/coucou/).
Opciones consideradas:
- Coucou como monitor de agentes: Ya funciona. Muestra el estado de Claude Code/OpenCode en el notch.
- Coucou + bóveda: Coucou podría leer/escribir notas en la bóveda via MCP o API.
- Coucou + voz: Usar el dictado de Coucou para crear notas por voz.
- Coucou + notificaciones: Notificar cuando hay nuevas notas, recordatorios, etc.
Decisión preliminar:
- Usar Coucou como monitor de agentes (ya funciona).
- Crear un hook/MCP que permita a Coucou leer la bóveda (notas del día, tareas pendientes).
- Usar el dictado de Coucou para crear notas por voz (guardar en
02_Bitacora/). - Integrar notificaciones de Coucou con el segundo cerebro (ej. “tienes 3 tareas pendientes”).
Dónde se implementa: Coucou (hooks/MCP) + segundo cerebro (API de lectura) + bóveda.
Dependencias: Coucou instalado y configurado. MCP server para la bóveda.
Resumen de decisiones
| # | Funcionalidad | Prioridad | Complejidad | Dependencias |
|---|---|---|---|---|
| 1 | Transcripción de voz | Alta | Media | Web Speech API (gratis) o Whisper |
| 2 | Contexto IA | Alta | Alta | Vector DB (RAG) o archivo de contexto |
| 3 | Voz propia (TTS) | Media | Alta | ElevenLabs API key o Coqui local |
| 4 | GitHub (issues, PRs, actividad) | Media | Media | GitHub PAT |
| 5 | Baja | Alta | LinkedIn app aprobada | |
| 6 | Bolsas de empleo | Baja | Media | APIs de bolsas (partnership) |
| 7 | Coucou | Media | Media | Coucou instalado + MCP |
Próximos pasos sugeridos
- Empezar con transcripción de voz (Web Speech API) — gratis, sin backend, inmediato.
- Crear archivo CONTEXTO.md en la bóveda — sin dependencias, mejora inmediata del contexto IA.
- Integrar Coucou — ya está instalado, solo falta conectar con la bóveda.
- GitHub API — obtener un PAT y crear widget de actividad.
Estas son decisiones, no implementaciones. Cada una se evaluará y priorizará antes de construir.