💼 _WORKING - Tu Sistema de Trabajo Diario¶

Sistema Transversal de Gestión de Proyectos y Tareas

Este es tu espacio de trabajo activo donde gestionas proyectos, tareas y workflows del día a día.

📂 ESTRUCTURA¶

_WORKING/
├── workflows/                  # Metodologías y procesos canon
│   └── WORKFLOW_METHODOLOGY.md # Metodología universal (LÉELO PRIMERO)
│
├── tasks/                      # Sistema de tareas
│   ├── templates/              # Tareas pendientes de ejecutar
│   ├── in_progress/            # Tareas en desarrollo activo
│   └── completed/              # Tareas completadas (historial)
│
└── projects/                   # Proyectos específicos
    ├── 001_CORE_TESTING/       # Proyecto: Testing de 04_CORE
    │   ├── AUDIT_REPORT.md     # Auditoría inicial
    │   ├── ACTION_PLAN.md      # Plan de acción
    │   ├── PROGRESS.md         # Tracking en tiempo real
    │   └── POST_MORTEM.md      # Análisis post-proyecto (al terminar)
    │
    └── 002_[NEXT_PROJECT]/

🎯 PROPÓSITO¶

¿Por qué existe _WORKING?¶

AudioLab es un proyecto grande y complejo: - 16 subsistemas en 04_CORE - Múltiples módulos en 05_MODULES - Plugins, tests, documentación, CI/CD, etc.

Sin un sistema de gestión profesional, es fácil: - ❌ Perder el hilo en proyectos largos - ❌ Olvidar qué falta por hacer - ❌ No tener trazabilidad de decisiones - ❌ Repetir errores del pasado

_WORKING resuelve esto con un workflow profesional y trazable.

Relación con 00_PIPELINE¶

00_PIPELINE: El sistema de orquestación que define CÓMO funciona el proceso (80 fases, gates, automatización)
_WORKING: Tu espacio de ejecución donde APLICAS el proceso (proyectos y tareas concretas)

El PIPELINE orquesta, _WORKING ejecuta.

🚀 CÓMO USAR ESTE SISTEMA¶

1. LEER LA METODOLOGÍA (5 minutos)¶

# Primero, lee esto:
_WORKING/workflows/WORKFLOW_METHODOLOGY.md

Este documento define el proceso estándar para todos los proyectos.

2. NAVEGAR PROYECTOS ACTIVOS¶

# Ver proyectos en progreso:
ls _WORKING/projects/

# Abrir proyecto específico:
cd _WORKING/projects/001_CORE_TESTING/

# Revisar estado:
cat PROGRESS.md

3. TRABAJAR EN TAREAS¶

# Ver tareas disponibles:
ls _WORKING/tasks/templates/

# Iniciar una tarea:
mv _WORKING/tasks/templates/TASK-001_Install_Catch2.md \
   _WORKING/tasks/in_progress/

# Marcar como in_progress en el archivo
# Seguir los pasos documentados

# Al completar:
mv _WORKING/tasks/in_progress/TASK-001_Install_Catch2.md \
   _WORKING/tasks/completed/2025-10-17_TASK-001.md

4. CREAR NUEVO PROYECTO (Siguen metodología)¶

# 1. Crear carpeta de proyecto
mkdir _WORKING/projects/002_MY_PROJECT/

# 2. FASE 1: AUDIT
# Crear AUDIT_REPORT.md
# Documentar estado actual

# 3. FASE 2: DESIGN
# Crear ACTION_PLAN.md
# Definir objetivos, fases, tareas

# 4. FASE 3: DIVIDE
# Crear tareas en tasks/templates/
# Usar TASK_TEMPLATE.md

# 5. FASE 4: EXECUTE
# Ejecutar tareas una a una
# Actualizar PROGRESS.md

# 6. FASE 5: VERIFY
# Crear POST_MORTEM.md
# Documentar aprendizajes

📋 PROYECTOS ACTIVOS¶

001_CORE_TESTING (🔄 IN PROGRESS)¶

Objetivo: Verificar que 04_CORE funciona correctamente

Status: Día 1 - Planning completado
Progress: 0/20 tasks (0%)
Next: TASK-001 - Install Catch2

Ver detalles: - ACTION_PLAN.md - PROGRESS.md

🎓 FILOSOFÍA DEL SISTEMA¶

Principios¶

AUDITAR antes de Actuar
No empezar sin entender el estado actual
DISEÑAR antes de Implementar
Plan detallado, dividido en tareas
TAREA A TAREA
Una cosa a la vez, completamente
TRAZABILIDAD TOTAL
Documentar todo: por qué, cómo, resultado
PROFESIONALISMO CANON
Hacerlo bien, no "just make it work"

📊 MÉTRICAS DEL SISTEMA¶

Proyectos¶

Total: 1
Activos: 1
Completados: 0

Tareas¶

Templates: 1 (TASK-001 + template)
In Progress: 0
Completed: 0

🔧 HERRAMIENTAS¶

Templates Disponibles¶

TASK_TEMPLATE.md - Template para crear nuevas tareas
Más templates se añadirán según necesidad

Scripts (Futuros)¶

create_project.sh - Automatizar creación de proyectos
create_task.sh - Automatizar creación de tareas
update_progress.sh - Actualizar PROGRESS.md

📝 CONVENCIONES¶

Nomenclatura de Proyectos¶

NNN_PROJECT_NAME/

- NNN: Número secuencial (001, 002, ...) - PROJECT_NAME: Nombre descriptivo en CAPS_SNAKE_CASE

Nomenclatura de Tareas¶

TASK-NNN: [Verbo] [Objeto] [Contexto]

Ejemplos: - TASK-001: Install Catch2 via vcpkg - TASK-010: Fix failing tests in critical components

Estados de Tareas¶

TODO - Por hacer
IN_PROGRESS - En desarrollo
BLOCKED - Bloqueada por dependencia
COMPLETED - Terminada y verificada

🎯 ROADMAP DE _WORKING¶

Versión Actual: 1.0¶

Metodología documentada
Estructura de directorios
Templates básicos
Proyecto 001 creado

Versión 1.1 (Próximamente)¶

Scripts de automatización
Dashboard de progreso
Integración con git hooks
Métricas automatizadas

Versión 2.0 (Futuro)¶

Web dashboard
API para tracking
Integration con GitHub Projects
Visualizaciones de progreso

🤝 CONTRIBUIR¶

Mejorar el Sistema¶

Si encuentras formas de mejorar _WORKING:

Documentar la mejora propuesta
Crear issue/discussion
Implementar y documentar
Actualizar templates si aplica

Reportar Problemas¶

Metodología confusa → Mejorar docs
Template incompleto → Añadir secciones
Proceso lento → Optimizar workflow

📚 RECURSOS¶

Documentación Clave¶

WORKFLOW_METHODOLOGY.md - LÉELO PRIMERO
TASK_TEMPLATE.md - Template para tareas
001_CORE_TESTING/ACTION_PLAN.md - Ejemplo real

Lecturas Recomendadas¶

Getting Things Done (GTD) - David Allen
The Phoenix Project - Gene Kim
Agile Project Management

🎓 APRENDIZAJES¶

Lo Que Funciona ✅¶

Documentar ANTES de codificar
Tareas atómicas (<2h)
Verificación en cada paso
Trazabilidad completa

Lo Que NO Funciona ❌¶

"Quick fixes" sin documentar
Múltiples tareas en paralelo
Código sin tests
Decisiones sin justificación

📊 ESTADÍSTICAS¶

Se actualizarán conforme avancemos

Proyectos completados:     0
Tareas completadas:        0
Horas trabajadas:          2h (planning)
Tests verificados:         0/74
Líneas documentadas:       ~5,000

🚀 PRÓXIMOS PASOS¶

Completar 001_CORE_TESTING
Ejecutar 20 tareas
Verificar CORE funciona
Documentar aprendizajes
Aplicar metodología a siguientes proyectos
002_MODULES_DEVELOPMENT
003_PLUGIN_EXAMPLES
004_CI_CD_SETUP
Refinar sistema basado en experiencia
Post-mortems
Mejoras a templates
Automatizaciones

ESTE ES TU ESPACIO DE TRABAJO DE AUDIOLAB. 💼

Todo proyecto grande necesita gestión profesional. _WORKING es donde haces el trabajo real.

Version: 1.0.0 Created: 2025-10-17 Status: ACTIVE ✅ Maintainer: AudioLab Core Team