# 🚀 Bienvenido a Taskr - El Gestor de Proyectos de tu IA

## 1.1 ¿De qué trata Taskr?

### La Versión Sencilla

¿Sabes que cuando le pides a la IA que te ayude con un proyecto grande, a veces olvida lo que estaba haciendo? ¿O se confunde a mitad del camino? **Taskr soluciona eso.**

Piensa en Taskr como una **lista de tareas inteligente que tu asistente de IA puede leer y actualizar automáticamente**. Es como darle a tu IA una memoria perfecta y el cerebro de un gestor de proyectos.

### ¿Qué hace especial a Taskr?

Esto es lo que Taskr hace y que una IA normal no puede:

**🧠 Nunca olvida el contexto**
- Tu IA recuerda todo sobre tu proyecto, incluso después de que cierres tu computadora y regreses días después.
- Sabe exactamente dónde se quedó y qué hacer a continuación.
- Se acabaron los "¿espera, en qué estábamos trabajando?".

**📋 Gestión inteligente de tareas**
- Divide automáticamente los proyectos grandes en piezas pequeñas.
- Sabe qué tareas dependen de otras.
- Trabaja en ellas en el orden correcto (sin saltar de un lado a otro al azar).

**👥 Ideal para equipos**
- Múltiples agentes de IA pueden trabajar en el mismo proyecto sin estorbarse entre sí.
- Cada agente sabe quién está haciendo qué.
- Perfecto para cuando quieres que un agente programe mientras otro se encarga de la investigación o la planificación.

**📝 Mantiene notas perfectas**
- Documenta todo lo que hace automáticamente.
- Puedes ver qué archivos se cambiaron, qué decisiones se tomaron y por qué.
- Ideal para entender qué construyó realmente tu IA.

### Cómo funciona realmente (Lo técnico, explicado de forma sencilla)

**La idea general:** Taskr es como un puente entre tú y tu IA que mantiene todo organizado.

Aquí está el flujo:

1. **Tu IA (Cursor, Claude Desktop, OpenClaw, etc.) se conecta a Taskr** mediante una configuración rápida de una sola vez.
2. **Le dices a tu IA lo que quieres hacer** (como "Quiero una aplicación que rastree mi rutina de ejercicios" o "investiga competidores para mi nuevo producto").
3. **Tu IA crea un plan inteligente** — un desglose multinivel basado en la nube que vive en Taskr (no solo una lista de tareas plana).
4. **A medida que trabaja, actualiza Taskr** con lo que ha hecho y lo que ha aprendido.
5. **Puedes ver el progreso** en tiempo real a través de la extensión de Taskr o el sitio web.

La magia ocurre a través de algo llamado **MCP (Model Context Protocol)** — pero no te preocupes por el nombre. Solo ten en cuenta que es la tecnología que permite a tu IA hablar con Taskr automáticamente, de forma parecida a como las aplicaciones de tu teléfono se comunican con internet.

### Las herramientas que obtiene tu IA (12 superpoderes)

Cuando se conecta a Taskr, tu IA obtiene 12 habilidades especiales que no tenía antes:

**Para gestionar el trabajo:**
- Crear nuevas tareas cuando descubre que algo necesita hacerse.
- Actualizar tareas a medida que las completa.
- Eliminar tareas que ya no son necesarias.
- Obtener la siguiente tarea automáticamente (ya no hay que preguntar "¿qué sigue?").
- Ver la estructura completa del proyecto a la vez.
- Sincronizar el trabajo completado retroactivamente (ponerse al día con cualquier cosa que haya olvidado registrar).

**Para mantener notas:**
- Anotar en qué está trabajando.
- Actualizar notas a medida que las cosas cambian.
- Eliminar notas que están desactualizadas.
- Navegar por toda la documentación del proyecto.
- Leer notas específicas cuando sea necesario.
- Buscar en todo lo que ha escrito.

¡Estas herramientas significan que tu IA puede gestionarse a sí misma; tú solo le dices qué construir y ella se encarga del resto!

### Conceptos clave (Cosas que verás)

Antes de sumergirnos, aquí están las cosas principales que encontrarás:

**Proyectos** 📁
- Piensa en ellos como carpetas para las diferentes cosas que estás construyendo.
- Cada proyecto es completamente independiente (tu aplicación de recetas no se mezclará con tu rastreador de ejercicios).
- Obtienes un ID único para cada proyecto (se ve como: `PR_01JGYV...` - 26 caracteres después de PR_).

**Tareas** ✅
- Cosas individuales que deben hacerse.
- Organizadas como un esquema (1.0, 1.1, 1.2, 2.0, etc.).
- Cada una tiene un tipo: setup (preparación), analysis (investigación), implementation (construcción), validation (verificación) o testing (pruebas).
- El estado muestra si está esperando, en proceso, terminada o saltada.

**Notas** 📝
- Documentación que tu IA escribe mientras trabaja.
- Diferentes tipos para diferente información:
  - **FILE_LIST** - Qué archivos fueron creados o cambiados.
  - **PROGRESS** - Hitos importantes alcanzados.
  - **CONTEXT** - Información de fondo y decisiones tomadas.
  - **FINDING** - Problemas descubiertos y cómo se solucionaron.
  - **OTHER** - Todo lo demás.

**Guía (Guidance)** 🎯
- Pistas inteligentes que Taskr le da a tu IA para mantenerla en el camino correcto.
- Cambia según lo que la IA esté haciendo.
- Evita que tu IA se confunda o se desvíe del camino.

---