Files
system-docs/v4-archive/vision-builder/README.md
2025-12-24 17:28:34 +00:00

4.4 KiB

VISION BUILDER

Estado

Interfaz de Diseño de Vida - Ecosistema TZZR

Descripción

Vision Builder es la interfaz principal para crear y gestionar visiones personales que se transforman en acciones concretas. Conecta con THE FACTORY para refinar iterativamente cada visión hasta que sea coherente y accionable.

Concepto

USUARIO DESCRIBE VISIÓN
        │
        ▼
THE FACTORY REFINA (3-5 iteraciones)
        │
        ▼
SE GENERAN MST (Milestones)
        │
        ▼
CADA MST TIENE ACCIONES + HÁBITOS
        │
        ▼
USUARIO VALIDA CON BCK (Evidencias)

Tipos de Visión

Tipo Icono Descripción Ejemplo
fitness 💪 Transformación física Perder peso, ganar músculo
career 📈 Desarrollo profesional Ascenso, cambio de carrera
project 🎯 Proyecto específico Lanzar MVP, escribir libro
habit 🔄 Crear/eliminar hábito Meditar, dejar de fumar
learning 📚 Aprendizaje Dominar Python, aprender idioma
finance 💰 Finanzas personales Ahorrar, invertir

Acciones vs Hábitos

Concepto Frecuencia Tracking Ejemplo
Acción Una vez Completado/Pendiente Comprar báscula
Hábito Recurrente Racha, % cumplimiento Entrenar 5x/semana

Flujo Completo

1. VISIÓN: "Quiero transformar mi físico"
        │
        ▼
2. FACTORY REFINA:
   • Objetivo clarificado
   • Motivación articulada
   • Estado actual vs deseado
   • Obstáculos identificados
   • 3-5 Milestones con fechas
        │
        ▼
3. MST (Milestones):
   • Semana 1: Establecer hábitos base
   • Semana 4: Completar primer ciclo PPL
   • Semana 8: Revisar progreso
   • Semana 12: Evaluación final
        │
        ▼
4. ACCIONES + HÁBITOS:
   ACCIONES (únicas):        HÁBITOS (recurrentes):
   • Comprar báscula         • Entrenar 5x/semana
   • Apuntarse al gym        • Beber 2.5L agua/día
   • Configurar app          • Dormir 7+ horas
        │
        ▼
5. BCK (Evidencias):
   • Foto de progreso
   • Registro de entrenamiento
   • Screenshot de báscula

Dimensiones de Evaluación

Dimensión Pregunta Peso (fitness)
clarity ¿Se entiende? 10%
coherence ¿Las partes encajan? 15%
completeness ¿Está completa? 10%
feasibility ¿Es realizable? 10%
actionability ¿Se puede actuar? 25%
motivation ¿Inspira? 25%

Schema SQL

deck_visiones (id, titulo, tipo, contenido_refinado, estado, progreso)
deck_milestones (id, vision_id, titulo, dia_relativo, criterio_exito)
deck_acciones (id, milestone_id, titulo, tipo, prioridad, estado)
deck_habitos (id, vision_id, titulo, frecuencia_tipo, racha_actual)
deck_habito_registros (id, habito_id, fecha, completado, valor)
deck_bck (id, vision_id, tipo, titulo, imagen_ref, datos)

Estructura

vision-builder/
├── src/
│   ├── components/
│   │   ├── VisionBuilder.jsx      # Principal
│   │   ├── VisionCreator.jsx      # Formulario
│   │   ├── VisionDetail.jsx       # Vista detalle
│   │   ├── MilestoneCard.jsx      # Tarjeta MST
│   │   └── HabitTracker.jsx       # Tracker hábitos
│   ├── hooks/
│   │   ├── useVisions.js
│   │   └── useFactory.js
│   └── api/
│       └── visionApi.js
├── styles/
└── docs/

Integración

// ALFRED detecta "crear visión" → envía a FACTORY
const alfred = new Alfred();
const vision = await alfred.process("crear visión fitness", {
  title: "Transformación 2025",
  seed: "Quiero perder 10kg...",
  timeframe: 90
});

Repositorios Relacionados

Repo Rol
deck Servidor que ejecuta Vision Builder
the-factory Refina visiones
contratos-comunes Schema y componentes
alfred Orquestador

Roadmap

  • Concepto Vision → MST → Actions/Habits → BCK
  • UI component principal
  • Schema SQL
  • Integración FACTORY
  • App móvil
  • Notificaciones
  • Templates de visión