Skip to content

ROADMAP.md

Latest commit

 

History

History
232 lines (156 loc) · 8.55 KB

ROADMAP.md

File metadata and controls

232 lines (156 loc) · 8.55 KB
Tipo: Plan Maestro
Categoría: Gestión de Proyecto
Versión: 0.2.0
Propósito: Plan maestro de trabajo y tracking de progreso
Objetivo: Documentar fases, epics, y estado actual del proyecto
Fecha actualización: 2026-03-27

ROADMAP - THYROX

Propósito

Plan maestro del proyecto THYROX. Fuente única de verdad para el estado del trabajo.

Convenciones

  • [ ] = Pendiente
  • [-] = En Progreso
  • [x] = Completado (YYYY-MM-DD)

FASE 1: Framework Base (v0.1.0)

Estructura del proyecto

  • Crear estructura de directorios (2026-03-25)
  • Inicializar repositorio Git (2026-03-25)
  • Crear README.md, ROADMAP.md, CHANGELOG.md (2026-03-25)
  • Crear ARCHITECTURE.md, CONTRIBUTING.md (2026-03-25)
  • Crear docs/API.md, docs/BUILD.md (2026-03-25)
  • Crear api/README.md, build/README.md (2026-03-25)

Skill pm-thyrox

  • SKILL.md con 7 fases SDLC (2026-03-25)
  • 20 references de documentación por fase (2026-03-25)
  • 30 assets/templates para output (2026-03-25)
  • ADRs iniciales (9 decisiones documentadas) (2026-03-25)

FASE 2: Consolidación y Coherencia (v0.2.0) — Sesión 2026-03-27

Limpieza de contenido

  • Eliminar referencias arc42 — 85 ocurrencias en 16 archivos (2026-03-27)
  • Convertir backtick refs a markdown links — 37 refs en 8 archivos (2026-03-27)
  • Limpiar .md del texto visible de links — 63 links en 19 archivos (2026-03-27)

Unificación de fases

  • Análisis de coherencia del proyecto completo (2026-03-27)
  • Análisis detallado de 20 references (2026-03-27)
  • Unificar orden de fases: ANALYZE primero en todos los archivos (2026-03-27)
  • Corregir numeración en SKILL.md tabla, exit conditions, project-state.md (2026-03-27)
  • Corregir phase headers en solution-strategy, spec-driven-dev, incremental-correction, context (2026-03-27)
  • Eliminar residuos de renombrado (requirements.md, requirements.md.template) (2026-03-27)

Integración y flujo

  • Integrar use-cases.md al flujo de Phase 1 (8 subsecciones) (2026-03-27)
  • Actualizar metadata genéricos Anthropic: ADT → THYROX (2026-03-27)
  • Conectar CLAUDE.md y README.md al SKILL (jerarquía SKILL > CLAUDE > README) (2026-03-27)
  • Corregir links rotos en decisions.md y docs/BUILD.md (2026-03-27)

Reorganización según anatomía oficial

  • templates/ → assets/ (30 archivos) (2026-03-27)
  • Crear scripts/ en pm-thyrox (mover scripts desde raíz y utils) (2026-03-27)
  • tracking/ → assets/ (AD_HOC_TASKS, REFACTORS como .template) (2026-03-27)
  • Mover epic example y templates sueltos a assets/ (2026-03-27)
  • Eliminar utils/ (reportes obsoletos), START-HERE.md (2026-03-27)
  • Mover validation guide a references/reference-validation.md (2026-03-27)

Scripts con responsabilidad única

  • detect/convert/validate para md-links (3 scripts Bash) (2026-03-27)
  • detect/convert/validate para broken-references (3 scripts Python) (2026-03-27)

Estructura context/

  • Crear context/analysis/ y mover análisis existentes (2026-03-27)
  • Crear context/epics/ para trabajo planificado (2026-03-27)
  • Documentar "Where Outputs Live" por fase en SKILL.md (2026-03-27)
  • Agregar <br> consistentes en metadata blocks (2026-03-27)

Documentación Phase 1-2

  • Phase 1: ANALYZE — 8 documentos completos (2026-03-27)
  • Phase 2: SOLUTION_STRATEGY — solution-strategy.md (2026-03-27)
  • Phase 3: PLAN — ROADMAP.md reescrito (2026-03-27)

FASE 3: Completar documentación del framework

SKILL.md optimización

  • Reducir SKILL.md a <500 líneas — 1084 → 246 (2026-03-27)
  • Mover contenido extenso a references/scalability.md (2026-03-27)

Documentación pública

  • Reescribir ARCHITECTURE.md reflejando estado real (2026-03-27)
  • Reescribir CONTRIBUTING.md con flujo actualizado (2026-03-27)
  • Actualizar CHANGELOG.md con trabajo real v0.1.0 y v0.2.0 (2026-03-27)

Covariancia — Consistencia entre archivos

  • Análisis de covariancia: 5 leyes verificadas en 9 archivos (2026-03-28)
  • Solution strategy: fuente canónica + referencia (2026-03-28)
  • LAW 4: Jerarquía — Level 1/2/3 en SKILL, CLAUDE, README (2026-03-28)
  • LAW 2: Estructura — scripts/ en SKILL.md, prds/ eliminado de CLAUDE.md (2026-03-28)
  • LAW 3: Naming — convenciones explícitas en SKILL.md (2026-03-28)
  • LAW 2: conventions.md — estructura actualizada (2026-03-28)
  • Verificación: 5 leyes invariantes confirmadas por grep (2026-03-28)

Validación final

  • Ejecutar detect_broken_references.py y corregir
  • Ejecutar validate-missing-md-links.sh → exit 0
  • Verificar covariancia: las 5 leyes invariantes en los 9 archivos

Tracking de errores

  • ERR-001: Análisis no documentado en context/analysis/ (2026-03-28)
  • ERR-002: Clasificación incorrecta de tamaño del proyecto (2026-03-28)
  • ERR-006: Saltar fases de nuevo — reincidencia de ERR-002 (2026-03-28)

FASE 3b: Adopción de conceptos spec-kit

Epic: context/analysis/spec-kit-adoption-solution-strategy.md

Nuevos templates

  • Crear assets/spec-quality-checklist.md.template (ERR-003) (2026-03-28)
  • Crear assets/constitution.md.template (ERR-004) (2026-03-28)

Mejorar artefactos existentes

  • assets/EXIT_CONDITIONS.md.template — gates mandatorios + constitution check (ERR-008) (2026-03-28)
  • references/solution-strategy.md — Research Step explícito (ERR-006) (2026-03-28)
  • references/conventions.md — convención ROADMAP → epic link (ERR-007) (2026-03-28)
  • SKILL.md — constitution y checklist en flujo de fases (ERR-003, ERR-004) (2026-03-28)

Enriquecer fases con pasos ejecutables

  • Phase 3 (PLAN): pasos numerados en SKILL.md (ERR-005) (2026-03-28)
  • Phase 5 (DECOMPOSE): pasos numerados en SKILL.md (ERR-005) (2026-03-28)
  • Phase 6 (EXECUTE): pasos numerados en SKILL.md (ERR-005) (2026-03-28)

Tracking de errores (spec-kit adoption)

  • ERR-003: Sin validación de specs → checklist template creado (2026-03-28)
  • ERR-004: Sin constitution → constitution template creado (2026-03-28)
  • ERR-005: Fases no ejecutables → pasos numerados en SKILL.md (2026-03-28)
  • ERR-006: Saltar fases de nuevo → documentado como reincidencia (2026-03-28)
  • ERR-007: ROADMAP sin links a epics → convención agregada (2026-03-28)
  • ERR-008: Exit conditions informativas → gates mandatorios (2026-03-28)

FASE 3c: Adopción profunda de spec-kit (mecanismos de calidad)

Epic: context/analysis/spec-kit-deep-adoption-strategy.md

Script nuevo

  • Crear scripts/validate-phase-readiness.sh — verifica artefactos por fase (D4) (2026-03-28)

Mejorar templates existentes

  • assets/tasks.md.template — traceability T-NNN → R-N (D3) (2026-03-28)
  • assets/spec-quality-checklist.md.template — [NEEDS CLARIFICATION] check + [Spec §] refs (D1, D3) (2026-03-28)
  • assets/EXIT_CONDITIONS.md.template — double constitution check + markers gate (D2) (2026-03-28)

Mejorar references

  • references/conventions.md — priority mapping + traceability IDs table (D5) (2026-03-28)

SKILL.md updates

  • Phase 2: double constitution check pre + post design (D2) (2026-03-28)
  • Phase 4: zero [NEEDS CLARIFICATION] markers gate (D1) (2026-03-28)
  • Phase 5: task traceability T-NNN → R-N (D3) (2026-03-28)

Tracking de errores (deep analysis)

  • ERR-012: No hay cadena input/output entre fases → validate-phase-readiness.sh (2026-03-28)
  • ERR-013: No hay [NEEDS CLARIFICATION] mechanism → checklist + convención (2026-03-28)
  • ERR-016: No hay double constitution check → pre + post design (2026-03-28)
  • ERR-017: No hay priority→phase mapping → convención documentada (2026-03-28)
  • ERR-018: No hay trazabilidad req→task→checklist → IDs en templates (2026-03-28)

FASE 4: Template listo para reutilización (futuro)

Generalización

  • Limpiar contenido específico de THYROX para hacerlo template genérico
  • Crear guía de "cómo usar este template para tu proyecto"
  • Testear copiando pm-thyrox/ a un proyecto nuevo

CI/CD

  • GitHub Actions con validate-* scripts
  • Pre-commit hooks para conventional commits
  • Automatización de changelog

Métricas de Progreso

FASE 1: Framework Base       — 100% ✓
FASE 2: Consolidación        — 100% ✓
FASE 3: Completar docs       —   0%
FASE 4: Template reutilizable —   0%

Sesión 2026-03-27: ~30 cambios implementados, 20+ commits

Última actualización: 2026-03-27