⚡ Shape Up · Solo Mode Docs (Astro 6 + React 19)

Adaptación de la Metodología Shape Up de Basecamp para Desarrolladores Solitarios Potenciados por IA

Shape Up Solo es una plataforma y manual interactivo que reinventa el marco de trabajo Shape Up (creado por Ryan Singer en 37signals/Basecamp) diseñado específicamente para el ritmo de un Solo Developer + Agentes de IA. Elimina los backlogs interminables y los sprints burocráticos, sustituyéndolos por ciclos de entrega enfocados, apuestas (bets) acotadas y visualización en gráficos de colina (Hill Charts).


🧭 Pilares de la Metodología en Modo Solo + IA

flowchart LR
    A["📐 Shaping\n(Definir apetito y límites con IA)"] --> B["🎲 The Bet\n(Comprometerse a 2-4 semanas sin backlog)"]
    B --> C["🧗 Building & Hill Charts\n(Subida = Resolver incertidumbre\nBajada = Ejecución de código)"]
    C --> D["☕ Cool-down\n(1 semana libre para refactor y bugfixes)"]
    D --> A
  1. Shaping con Agentes Inteligentes:
    • En lugar de tickets detallados de antemano, se formula un Pitch de una página con el problema, el apetito de tiempo (ej. 2 semanas), los límites (no-gos) y la solución en wireframes toscos (fat-marker sketches), asistido por prompts estructurados.
  2. Cero Backlog Eterno:
    • Las ideas no se acumulan en listas infinitas de tareas olvidadas. Si una idea es relevante para la siguiente apuesta (Betting Table), se presenta fresca.
  3. Componente Interactivo en React 19:
    • Barra lateral reactiva con navegación fluida, seguimiento de fases del ciclo y visualización de progreso.
  4. Pruebas Automatizadas con Vitest:
    • Cobertura de funciones de cálculo de apetito y estado de los proyectos mediante Vitest.

🛠️ Stack Tecnológico

MóduloHerramientaRol
Framework BaseAstro 6.0.6Motor estático ultra rápido para documentación interactiva
Componentes de UIReact 19.2.4 (@astrojs/react)Hidratación parcial de paneles interactivos de navegación
Testing UnitarioVitest (vitest.config.ts, vitest.setup.ts)Verificación de utilidades y flujos de lógica
TipografíaSpace MonoEstética terminal técnica de alta legibilidad
Gestor de PaquetesPNPM & BunGestión determinista de dependencias con pnpm-lock.yaml

🚀 Comandos de Ejecución

# Instalación con pnpm o bun
pnpm install
# o con bun
bun install
 
# Iniciar servidor local (localhost:4321)
pnpm dev
 
# Ejecutar suite de pruebas con Vitest
pnpm vitest run
 
# Compilar para producción
pnpm build

🔗 Relación con el Sistema de Notas