trackops 1.0.0

package/locales/en.json

@@ -0,0 +1,142 @@
+{
+  "status.pending": "Pending",
+  "status.in_progress": "In progress",
+  "status.in_review": "In review",
+  "status.blocked": "Blocked",
+  "status.completed": "Completed",
+  "status.cancelled": "Cancelled",
+
+  "doc.header.taskPlan": "{projectName} — Task Plan (task_plan.md)",
+  "doc.header.progress": "{projectName} — Progress Log (progress.md)",
+  "doc.header.findings": "{projectName} — Findings Library (findings.md)",
+  "doc.autogenerated": "AUTO-GENERATED from `project_control.json`. Do not edit manually.",
+
+  "doc.section.operativeState": "Operative State",
+  "doc.section.externalDecisions": "Pending external decisions",
+  "doc.section.readyTasks": "Next ready tasks",
+  "doc.section.currentState": "Current State",
+  "doc.section.executionSummary": "Execution Summary",
+  "doc.section.activeTasks": "Active tasks",
+  "doc.section.reviewTasks": "Tasks in review",
+  "doc.section.activeBlockers": "Active blockers",
+  "doc.section.recentActivity": "Recent activity",
+  "doc.section.milestones": "Registered Milestones",
+  "doc.section.openFindings": "Open Findings",
+  "doc.section.resolvedFindings": "Resolved Findings",
+  "doc.section.phase": "Phase {phaseId} — {phaseLabel}",
+
+  "doc.label.activePhase": "Active phase",
+  "doc.label.currentFocus": "Current focus",
+  "doc.label.deliveryTarget": "Delivery target",
+  "doc.label.blockers": "Blockers",
+  "doc.label.nextStep": "Recommended next step",
+  "doc.label.phase": "Phase",
+  "doc.label.lastTest": "Last test",
+  "doc.label.nextStepShort": "Next step",
+  "doc.label.lastUpdate": "Last operational update",
+  "doc.label.progress": "Progress: {completed}/{total} required tasks completed",
+  "doc.label.phaseActive": "Active",
+  "doc.label.phaseClosed": "Closed",
+  "doc.label.phasePending": "Pending",
+  "doc.label.totalTasks": "Total tasks",
+  "doc.label.completedTasks": "Completed",
+  "doc.label.inProgressTasks": "In progress",
+  "doc.label.inReviewTasks": "In review",
+  "doc.label.pendingTasks": "Pending",
+  "doc.label.blockedTasks": "Blocked",
+  "doc.label.findingOpen": "open",
+  "doc.label.findingResolved": "resolved",
+  "doc.label.findingStatus": "Status",
+  "doc.label.findingDetail": "Detail",
+  "doc.label.findingImpact": "Impact",
+
+  "doc.label.noBlockers": "None",
+  "doc.label.noOpenTasks": "No open tasks",
+  "doc.label.noReadyTasks": "No ready tasks; check blockers.",
+  "doc.label.noTasks": "No registered tasks",
+  "doc.label.noFindings": "No open findings.",
+  "doc.label.noResolvedFindings": "No resolved findings on record.",
+  "doc.label.noDecisions": "None",
+  "doc.label.noActiveTasks": "No tasks in progress at the moment.",
+  "doc.label.noReviewTasks": "No tasks in review.",
+  "doc.label.noActiveBlockers": "No active blockers.",
+  "doc.label.noHistory": "No recorded movements.",
+
+  "cli.runtimeUpdated": "Runtime updated at {path}",
+  "cli.docsSynced": "Operational documentation synced.",
+  "cli.taskUpdated": "Task '{taskId}' updated with action '{action}'.",
+  "cli.taskNotFound": "Task '{taskId}' not found.",
+  "cli.actionNotSupported": "Unsupported action: {action}",
+  "cli.mustProvideActionAndId": "You must specify action and task id.",
+  "cli.noReadyTasks": "No ready tasks. Check blockers and dependencies.",
+  "cli.hooksInstalled": "Git hooks installed in .githooks",
+  "cli.hooksError": "Could not configure core.hooksPath.",
+  "cli.noProjectFound": "No project_control.json found in this directory or parents.",
+  "cli.emptyNote": "Empty note.",
+  "cli.undocumentedBlocker": "Undocumented blocker.",
+
+  "cli.status.title": "{projectName} — Operational Control",
+  "cli.status.focus": "Focus: {focus}",
+  "cli.status.activePhase": "Active phase: {phaseId} — {phaseLabel}",
+  "cli.status.tasks": "Tasks: {completed} completed, {inProgress} in progress, {inReview} in review, {pending} pending, {blocked} blocked",
+  "cli.status.readyTasks": "Next ready tasks:",
+  "cli.status.noReadyTasks": "No ready tasks; check blockers or dependencies.",
+  "cli.status.blockers": "Blockers:",
+  "cli.status.noBlockers": "No blockers.",
+  "cli.status.decisions": "External decisions:",
+  "cli.status.noDecisions": "None.",
+  "cli.status.repo": "Repository:",
+  "cli.status.branch": "Branch: {branch} | Tree: {treeStatus}",
+  "cli.status.treeClean": "clean",
+  "cli.status.treeDirty": "dirty ({staged} staged, {unstaged} unstaged, {untracked} untracked)",
+  "cli.status.lastCommit": "Last commit: {hash} {subject}",
+  "cli.status.divergence": "Divergence: ahead {ahead}, behind {behind}",
+  "cli.status.runtime": "Runtime: {path}",
+  "cli.status.docsSynced": "Docs synced: {status}",
+  "cli.status.docsSyncedYes": "yes",
+  "cli.status.docsSyncedNo": "no ({files})",
+
+  "cli.next.phase": "phase",
+  "cli.next.priority": "priority",
+  "cli.next.stream": "stream",
+  "cli.next.summary": "summary",
+
+  "cli.help.title": "Project operational control",
+  "cli.help.usage": "Usage:",
+
+  "server.ready": "Ops dashboard ready at http://{host}:{port}",
+  "server.defaultProject": "Default project: {name} ({id})",
+  "server.titleRequired": "Title is required.",
+  "server.taskCreatedNote": "Task created from dashboard.",
+  "server.taskEditedNote": "Task edited from dashboard.",
+  "server.payloadTooLarge": "Payload too large (>{limit}).",
+  "server.invalidJson": "Invalid JSON.",
+  "server.sessionNotFound": "Session not found.",
+  "server.noActiveSession": "No active session to start stream.",
+  "server.commandRequired": "A command is required.",
+  "server.projectNotResolved": "Could not resolve project.",
+
+  "init.welcome": "Project initialized with trackops.",
+  "init.opsExists": "Ops is already installed in this project.",
+  "init.created": "Created {file}",
+  "init.updated": "Updated {file}",
+  "init.registered": "Project registered in the global portfolio.",
+  "init.defaultFocus": "Operational project bootstrap",
+  "init.defaultTarget": "Project managed with trackops",
+  "init.defaultTaskTitle": "Set up project with trackops",
+  "init.defaultTaskSummary": "Verify initial structure, adjust phases and confirm operational integration.",
+
+  "opera.installed": "OPERA methodology installed (v{version}).",
+  "opera.alreadyInstalled": "OPERA is already installed in this project (v{version}).",
+  "opera.notInstalled": "OPERA is not installed in this project.",
+  "opera.upgraded": "OPERA upgraded to v{version}.",
+  "opera.primitiveDetected": "Existing OPERA installation detected (not managed by Ops).",
+
+  "skill.installed": "Skill '{name}' installed.",
+  "skill.removed": "Skill '{name}' uninstalled.",
+  "skill.notFound": "Skill '{name}' not found in the catalog.",
+  "skill.alreadyInstalled": "Skill '{name}' is already installed.",
+  "skill.notInstalled": "Skill '{name}' is not installed.",
+  "skill.catalogTitle": "Available skills:",
+  "skill.listTitle": "Installed skills:"
+}

package/locales/es.json

@@ -0,0 +1,142 @@
+{
+  "status.pending": "Pendiente",
+  "status.in_progress": "En progreso",
+  "status.in_review": "En revision",
+  "status.blocked": "Bloqueada",
+  "status.completed": "Completada",
+  "status.cancelled": "Cancelada",
+
+  "doc.header.taskPlan": "{projectName} — Plan de Tareas (task_plan.md)",
+  "doc.header.progress": "{projectName} — Diario de Progreso (progress.md)",
+  "doc.header.findings": "{projectName} — Biblioteca de Hallazgos (findings.md)",
+  "doc.autogenerated": "AUTOGENERADO desde `project_control.json`. No editar manualmente.",
+
+  "doc.section.operativeState": "Estado Operativo",
+  "doc.section.externalDecisions": "Decisiones externas pendientes",
+  "doc.section.readyTasks": "Proximas tareas listas",
+  "doc.section.currentState": "Estado Actual",
+  "doc.section.executionSummary": "Resumen de Ejecucion",
+  "doc.section.activeTasks": "Tareas activas",
+  "doc.section.reviewTasks": "Tareas en revision",
+  "doc.section.activeBlockers": "Bloqueadores activos",
+  "doc.section.recentActivity": "Actividad reciente",
+  "doc.section.milestones": "Hitos Registrados",
+  "doc.section.openFindings": "Hallazgos Abiertos",
+  "doc.section.resolvedFindings": "Hallazgos Resueltos",
+  "doc.section.phase": "Fase {phaseId} — {phaseLabel}",
+
+  "doc.label.activePhase": "Fase activa",
+  "doc.label.currentFocus": "Foco actual",
+  "doc.label.deliveryTarget": "Objetivo de entrega",
+  "doc.label.blockers": "Bloqueadores",
+  "doc.label.nextStep": "Proximo paso recomendado",
+  "doc.label.phase": "Fase",
+  "doc.label.lastTest": "Ultimo test",
+  "doc.label.nextStepShort": "Proximo paso",
+  "doc.label.lastUpdate": "Ultima actualizacion operativa",
+  "doc.label.progress": "Progreso: {completed}/{total} tareas requeridas completadas",
+  "doc.label.phaseActive": "Activa",
+  "doc.label.phaseClosed": "Cerrada",
+  "doc.label.phasePending": "Pendiente",
+  "doc.label.totalTasks": "Total de tareas",
+  "doc.label.completedTasks": "Completadas",
+  "doc.label.inProgressTasks": "En progreso",
+  "doc.label.inReviewTasks": "En revision",
+  "doc.label.pendingTasks": "Pendientes",
+  "doc.label.blockedTasks": "Bloqueadas",
+  "doc.label.findingOpen": "abierto",
+  "doc.label.findingResolved": "resuelto",
+  "doc.label.findingStatus": "Estado",
+  "doc.label.findingDetail": "Detalle",
+  "doc.label.findingImpact": "Impacto",
+
+  "doc.label.noBlockers": "Ninguno",
+  "doc.label.noOpenTasks": "Sin tareas abiertas",
+  "doc.label.noReadyTasks": "No hay tareas listas; revisar bloqueadores.",
+  "doc.label.noTasks": "Sin tareas registradas",
+  "doc.label.noFindings": "No hay hallazgos abiertos.",
+  "doc.label.noResolvedFindings": "No hay hallazgos resueltos registrados.",
+  "doc.label.noDecisions": "Ninguna",
+  "doc.label.noActiveTasks": "No hay tareas en progreso en este momento.",
+  "doc.label.noReviewTasks": "No hay tareas en revision.",
+  "doc.label.noActiveBlockers": "Sin bloqueadores activos.",
+  "doc.label.noHistory": "Sin movimientos registrados.",
+
+  "cli.runtimeUpdated": "Runtime actualizado en {path}",
+  "cli.docsSynced": "Documentacion operativa sincronizada.",
+  "cli.taskUpdated": "Tarea '{taskId}' actualizada con accion '{action}'.",
+  "cli.taskNotFound": "No existe la tarea '{taskId}'.",
+  "cli.actionNotSupported": "Accion no soportada: {action}",
+  "cli.mustProvideActionAndId": "Debes indicar accion e id de tarea.",
+  "cli.noReadyTasks": "No hay tareas listas. Revisa bloqueadores y dependencias.",
+  "cli.hooksInstalled": "Git hooks instalados en .githooks",
+  "cli.hooksError": "No se pudo configurar core.hooksPath.",
+  "cli.noProjectFound": "No se encontro project_control.json en este directorio ni superiores.",
+  "cli.emptyNote": "Nota sin contenido.",
+  "cli.undocumentedBlocker": "Bloqueador no documentado.",
+
+  "cli.status.title": "{projectName} — Control Operativo",
+  "cli.status.focus": "Foco: {focus}",
+  "cli.status.activePhase": "Fase activa: {phaseId} — {phaseLabel}",
+  "cli.status.tasks": "Tareas: {completed} completadas, {inProgress} en progreso, {inReview} en revision, {pending} pendientes, {blocked} bloqueadas",
+  "cli.status.readyTasks": "Proximas tareas listas:",
+  "cli.status.noReadyTasks": "No hay tareas listas; revisar bloqueadores o dependencias.",
+  "cli.status.blockers": "Bloqueadores:",
+  "cli.status.noBlockers": "Sin bloqueadores.",
+  "cli.status.decisions": "Decisiones externas:",
+  "cli.status.noDecisions": "Ninguna.",
+  "cli.status.repo": "Repositorio:",
+  "cli.status.branch": "Rama: {branch} | Arbol: {treeStatus}",
+  "cli.status.treeClean": "limpio",
+  "cli.status.treeDirty": "sucio ({staged} staged, {unstaged} unstaged, {untracked} untracked)",
+  "cli.status.lastCommit": "Ultimo commit: {hash} {subject}",
+  "cli.status.divergence": "Divergencia: ahead {ahead}, behind {behind}",
+  "cli.status.runtime": "Runtime: {path}",
+  "cli.status.docsSynced": "Documentacion sincronizada: {status}",
+  "cli.status.docsSyncedYes": "si",
+  "cli.status.docsSyncedNo": "no ({files})",
+
+  "cli.next.phase": "fase",
+  "cli.next.priority": "prioridad",
+  "cli.next.stream": "stream",
+  "cli.next.summary": "resumen",
+
+  "cli.help.title": "Control operativo del proyecto",
+  "cli.help.usage": "Uso:",
+
+  "server.ready": "Ops dashboard listo en http://{host}:{port}",
+  "server.defaultProject": "Proyecto por defecto: {name} ({id})",
+  "server.titleRequired": "El titulo es obligatorio.",
+  "server.taskCreatedNote": "Tarea creada desde el dashboard.",
+  "server.taskEditedNote": "Tarea editada desde el dashboard.",
+  "server.payloadTooLarge": "Payload demasiado grande (>{limit}).",
+  "server.invalidJson": "JSON invalido.",
+  "server.sessionNotFound": "Sesion no encontrada.",
+  "server.noActiveSession": "No hay sesion activa para iniciar stream.",
+  "server.commandRequired": "Se requiere un comando.",
+  "server.projectNotResolved": "No se pudo resolver el proyecto.",
+
+  "init.welcome": "Proyecto inicializado con trackops.",
+  "init.opsExists": "Ops ya esta instalado en este proyecto.",
+  "init.created": "Creado {file}",
+  "init.updated": "Actualizado {file}",
+  "init.registered": "Proyecto registrado en el portfolio global.",
+  "init.defaultFocus": "Bootstrap operativo del proyecto",
+  "init.defaultTarget": "Proyecto gestionado con trackops",
+  "init.defaultTaskTitle": "Configurar proyecto con trackops",
+  "init.defaultTaskSummary": "Verificar estructura inicial, ajustar fases y confirmar integracion operativa.",
+
+  "opera.installed": "Metodologia OPERA instalada (v{version}).",
+  "opera.alreadyInstalled": "OPERA ya esta instalado en este proyecto (v{version}).",
+  "opera.notInstalled": "OPERA no esta instalado en este proyecto.",
+  "opera.upgraded": "OPERA actualizado a v{version}.",
+  "opera.primitiveDetected": "Detectada instalacion OPERA existente (sin gestion por Ops).",
+
+  "skill.installed": "Skill '{name}' instalada.",
+  "skill.removed": "Skill '{name}' desinstalada.",
+  "skill.notFound": "Skill '{name}' no encontrada en el catalogo.",
+  "skill.alreadyInstalled": "Skill '{name}' ya esta instalada.",
+  "skill.notInstalled": "Skill '{name}' no esta instalada.",
+  "skill.catalogTitle": "Skills disponibles:",
+  "skill.listTitle": "Skills instaladas:"
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "trackops",
+  "version": "1.0.0",
+  "description": "Operational project control with task management, doc generation, multi-project dashboard, and optional ETAPA methodology",
+  "main": "lib/control.js",
+  "bin": {
+    "trackops": "bin/trackops.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "locales/",
+    "ui/",
+    "templates/"
+  ],
+  "keywords": [
+    "project-management",
+    "task-management",
+    "dashboard",
+    "ops",
+    "etapa",
+    "methodology",
+    "cli",
+    "devops",
+    "tracking",
+    "agile"
+  ],
+  "author": {
+    "name": "Xavier Crespo Gríman",
+    "email": "crespoxac@gmail.com",
+    "url": "https://baxahaun.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Baxahaun/trackops.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Baxahaun/trackops/issues"
+  },
+  "homepage": "https://github.com/Baxahaun/trackops#readme",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/templates/etapa/agent.md

@@ -0,0 +1,26 @@
+# Agente del Proyecto: {{PROJECT_NAME}}
+
+## Identidad
+Eres el agente principal del proyecto **{{PROJECT_NAME}}**. Operas bajo el protocolo E.T.A.P.A. v2.0.
+
+## Fuente de Verdad
+Tu fuente de verdad es `genesis.md`. Antes de tomar cualquier decisión, consulta este archivo.
+Para el seguimiento operativo y el estado del backlog, usa `project_control.json`.
+
+## Comportamiento
+- Sigue las reglas de comportamiento definidas en `genesis.md`.
+- Respeta la Matriz de Autonomía (Semáforo) para determinar qué acciones puedes tomar.
+- Gestiona tareas y estados desde `project_control.json`.
+- No edites manualmente `task_plan.md`, `progress.md` ni `findings.md`; se regeneran con `trackops sync`.
+
+## Skills Disponibles
+Consulta `.agent/skills/_registry.md` para ver las skills instaladas.
+También puedes buscar nuevas skills con `trackops skill catalog`.
+
+## Ciclo de Trabajo
+1. Ejecuta `trackops status` al inicio de cada bloque de trabajo.
+2. Consulta `genesis.md` para entender los datos y reglas.
+3. Usa `trackops next` para ver la siguiente cola priorizada.
+4. Antes de implementar, marca la tarea con `trackops task start <task-id>`.
+5. Usa el router (`.agent/hub/router.md`) para saber qué skill aplicar.
+6. Al terminar, pasa la tarea a `review`, `complete` o `block` y ejecuta `trackops sync`.

package/templates/etapa/genesis.md

@@ -0,0 +1,94 @@
+# {{PROJECT_NAME}} — Genesis
+
+> **La Constitución del proyecto.** Este documento es la fuente de verdad. Antes de tomar cualquier decisión arquitectónica o de implementación, consulta este archivo. Si un script contradice lo definido aquí, el script está mal.
+
+---
+
+## 1. Directriz Principal
+
+_¿Cuál es el resultado singular deseado de este proyecto?_
+
+> TODO: Definir el objetivo principal del proyecto.
+
+---
+
+## 2. Integraciones Externas
+
+_¿Qué servicios externos necesitamos? ¿Están listas las claves?_
+
+| Servicio | Estado | Clave / Config |
+|----------|--------|----------------|
+| —        | —      | —              |
+
+---
+
+## 3. Fuente de la Verdad
+
+_¿Dónde viven los datos primarios?_
+
+> TODO: Describir la fuente de datos principal.
+
+---
+
+## 4. Carga Útil (Payload)
+
+_¿Cómo y dónde debe entregarse el resultado final?_
+
+> TODO: Describir destino y formato de entrega.
+
+---
+
+## 5. Reglas de Comportamiento
+
+_Restricciones, tono y reglas específicas del dominio._
+
+> TODO: Definir restricciones de negocio.
+
+---
+
+## Esquema de Datos
+
+> **Regla "Datos-Primero"**: Este schema debe estar definido antes de escribir cualquier código.
+
+```json
+{
+  "input": {
+    "source": "",
+    "schema": {}
+  },
+  "output": {
+    "destination": "",
+    "schema": {}
+  }
+}
+```
+
+---
+
+## Invariantes Arquitectónicas
+
+_Decisiones técnicas inamovibles. Cambiarlas requiere aprobación explícita (Nivel Rojo)._
+
+- TODO: Listar invariantes.
+
+---
+
+## Pipeline
+
+_Documenta el grafo de dependencias entre herramientas._
+
+<!-- Ejemplo:
+### tool_fetch.py → tool_transform.py
+- Output: `.tmp/raw_data.json`
+- Formato: JSON array según schema X
+-->
+
+---
+
+## Templates
+
+_Referencias a las plantillas de output definidas en `templates/`._
+
+<!-- Ejemplo:
+- `templates/report.md` — Plantilla para reportes
+-->

package/templates/etapa/references/autonomy-and-recovery.md

@@ -0,0 +1,117 @@
+# Gobernanza, Autonomía y Recuperación
+
+Este documento define los niveles de permiso, el protocolo de auto-reparación y el sistema de rollback para el proyecto.
+
+---
+
+## 🚦 Matriz de Autonomía (Semáforo)
+
+### 🔴 NIVEL ROJO — Detente y Pide Permiso
+
+Estas acciones requieren aprobación explícita del usuario antes de ejecutarse:
+
+- Modificar la estructura de datos o reglas en `genesis.md`.
+- Eliminar datos persistentes o archivos fuera de `.tmp/`.
+- Despliegue final a producción (Fase de Automatización).
+- Envío de comunicaciones reales a terceros (emails, webhooks con side-effects).
+- Creación de repositorios o recursos en servicios externos (GitHub, cloud).
+- Modificar configuraciones de acceso o seguridad.
+
+### 🟡 NIVEL AMARILLO — Avanza con Precaución
+
+Estas acciones se pueden ejecutar pero requieren documentación inmediata:
+
+- Instalación de dependencias nuevas.
+- Modificaciones a la estructura de directorios.
+- Cambios en el pipeline documentado en `genesis.md`.
+
+### 🟢 NIVEL VERDE — Avanza con Confianza
+
+Estas acciones no requieren permiso:
+
+- Creación, edición y corrección de scripts en `tools/`.
+- Lectura de archivos y documentación.
+- Ejecución de pruebas (Tests).
+- Actualización de `progress.md`, `findings.md` y `task_plan.md`.
+- Instalación de skills del ecosistema.
+- Escritura y limpieza de archivos en `.tmp/`.
+- Auto-Reparación (con límite de reintentos).
+
+---
+
+## 🛠️ Principio de Auto-Templado (Self-Annealing)
+
+Cuando una herramienta falla o ocurre un error en Nivel Verde, sigue este protocolo:
+
+### Procedimiento
+
+1. **Analizar**: Lee el stack trace completo. No adivines la causa.
+2. **Parchear**: Arregla el script en `tools/`.
+3. **Probar**: Verifica que el arreglo funciona ejecutando el script.
+4. **Actualizar Memoria**: Documenta el aprendizaje en `findings.md` o en el SOP correspondiente en `architecture/` para que el error nunca se repita.
+
+### Límite de Reintentos
+
+**Máximo 3 intentos de auto-reparación por error.** Si al tercer intento el error persiste:
+
+1. **Escalar a Nivel Rojo** — Pide intervención humana.
+2. **Documentar el bloqueo** en `findings.md` con:
+
+```markdown
+## Bloqueo: [nombre del error]
+### Fecha: [YYYY-MM-DD]
+### Script: [tools/nombre.py]
+
+### Stack Trace
+[pegar stack trace completo]
+
+### Intentos de Reparación
+1. **Intento 1**: [qué se intentó] → [resultado]
+2. **Intento 2**: [qué se intentó] → [resultado]
+3. **Intento 3**: [qué se intentó] → [resultado]
+
+### Hipótesis del Problema Raíz
+[análisis de por qué crees que falla]
+
+### Acción Requerida
+[qué necesitas del usuario para desbloquear]
+```
+
+### Lo que NO es Auto-Templado
+
+- No es reintentar ciegamente el mismo comando esperando un resultado diferente.
+- No es ignorar el error y continuar.
+- No es cambiar el schema en `genesis.md` para que el error "desaparezca".
+
+---
+
+## 🔄 Protocolo de Rollback
+
+Si una fase posterior invalida una decisión de una fase anterior, NO modifiques `genesis.md` directamente.
+
+### Procedimiento
+
+1. **Documentar** en `CHANGELOG.md` qué cambio se necesita y por qué.
+2. **Solicitar aprobación** (Nivel Rojo).
+3. **Una vez aprobado**, actualizar `genesis.md` con nueva versión:
+
+```markdown
+## Versión 1.1 — [fecha]
+
+### Cambio
+- [descripción precisa del cambio]
+
+### Motivo
+- [por qué la versión anterior era incorrecta o insuficiente]
+
+### Impacto
+- [qué scripts/SOPs necesitan actualizarse como consecuencia]
+```
+
+4. **Propagar el cambio**: Actualizar todos los scripts y SOPs afectados.
+5. **Re-ejecutar tests**: Verificar que los cambios no rompen nada.
+6. **Actualizar `progress.md`** con el rollback documentado.
+
+### Regla de Oro
+
+El historial de decisiones nunca se borra. Cada versión de `genesis.md` queda registrada en `CHANGELOG.md`. Esto permite entender por qué se tomó una decisión y por qué se cambió, evitando ciclos de decisiones contradictorias.