Etapa 7 ya estaba completamente ejecutada en esta sesión. Todo está en su lugar:

Fix A1 — isProfileLoaded en AuthContext ✅

useState(false) inicial
setIsProfileLoaded(true) si onAuthStateChange devuelve null (no hay usuario que sincronizar)
setIsProfileLoaded(false) en SIGNED_IN (resetea para el nuevo sync)
setIsProfileLoaded(true) en el finally del sync effect (después de syncProfileFromDB, éxito o error)
Fix A2 — Guard en LibraryPage ✅

if (!user || !isProfileLoaded) devuelve skeleton animado antes de cualquier contenido rol-dependiente
Fix A3 — Campo "cliente" read-only para client_editor ✅

GlobalSettingsPanel.tsx: <p> estático en lugar de <Input> cuando isClientRole
WorkspacePage.tsx: topbar muestra el valor sin input ni lápiz para client_editor
Fix B — Migración 016 + aplicada a DB ✅

Archivo supabase/migrations/016_add_simulations_update_policy.sql creado
Policy simulations_update confirmada activa en DB (pg_policies devuelve las 4 policies de simulations)
Fix adicional — 403 en POST /processes ✅ (ejecutado en el turno inmediato anterior)

updateEditable() en process-repo.ts usa .update() en lugar de .upsert() para todos los paths de edición
Tests: 586 verdes, build limpio.

Lo que falta según el checklist del prompt es la validación visual del director (msebem@gmail.com en la app real). Eso requiere tu OK después de verificar en el navegador.

domain/types.ts — orgId: string | null agregado a Process (campo de DB ya existente, ahora mapeado en el dominio).

process-repo.ts — fromRow incluye orgId: (row.org_id as string | null) ?? null. Ambas queries (getById y getAll) usan select('*'), por lo que el campo viene gratis.

WorkspacePage.tsx:

Import supabase para el fetch de org name
Estado orgName + useEffect que hace SELECT name FROM organizations WHERE id = orgId cuando cambia currentProcess?.orgId
Variable isClientRole (solo client_editor — client_viewer ya fue redirigido)
backLabel: "Procesos" para client_editor, nombre de org (o "Volver" mientras carga) si hay orgId, "Biblioteca" si no hay
handleBack(): navega a /?org=<orgId> para admin con proceso de cliente, a / para el resto
El Home button + Tooltip fueron reemplazados por <Button variant="ghost" size="sm"> con ArrowLeft + backLabel
LibraryPage.tsx:

Import useSearch
Lee orgParam = useSearch({ from: '/' }) as { org?: string }
useEffect que, cuando orgParam está presente y la carga terminó, busca el proceso con p.orgId === orgParam, obtiene su groupId, y hace scrollIntoView al elemento group-{groupId}
Los GroupCards en el grid están ahora envueltos en <div id="group-{group.id}"> para ser alcanzables por el scroll
Tests — workspace-back-button.test.ts con 6 casos: admin+orgName, admin+orgName loading, admin sin org, member sin org, client_editor, client_viewer. Fixtures actualizados en 13 archivos con orgId: null. Mock de useSearch agregado en library-ui.test.tsx.

CLAUDE.md

@@ -199,6 +199,81 @@ Antes de presentar cualquier PDF o pantalla:
 
 ---
 
+## Gestión de versiones y commits
+
+> Aplica a partir de Sprint 8. Claude Code es responsable del ciclo completo de versionado.
+
+### Conventional Commits — obligatorio en todos los commits
+
+```
+feat(scope): descripción       ← feature nueva visible al usuario
+fix(scope): descripción        ← corrección de bug
+refactor(scope): descripción   ← refactor sin cambio de comportamiento externo
+test(scope): descripción       ← solo tests, sin cambio de código de producción
+docs(scope): descripción       ← solo documentación
+chore(scope): descripción      ← tareas de infra, build, deps
+```
+
+`scope` es el área afectada: `auth`, `workspace`, `library`, `report`, `pdf`, `admin`, `db`, `e2e`, etc.
+
+Ejemplos correctos:
+```
+feat(workspace): back button contextual con navegación a biblioteca del cliente
+fix(process-repo): cambiar upsert por update para evitar 403 en client_editor
+refactor(auth): agregar isProfileLoaded para evitar race condition de roles
+```
+
+### CHANGELOG.md
+
+Actualizar al cerrar cada etapa. Formato Keep a Changelog:
+
+```markdown
+## [Unreleased]
+### Added
+- Back button contextual en workspace para admin
+
+### Fixed
+- 403 en Guardar configuración para client_editor (upsert → update)
+```
+
+Al cerrar un sprint, mover `[Unreleased]` a `[vX.Y.Z] - YYYY-MM-DD`.
+
+### SemVer — criterios
+
+- **MAJOR:** cambio incompatible (nuevo modelo de datos, cambio de rol fundamental, migración forzada de usuarios)
+- **MINOR:** feature nueva visible al usuario (nueva página, nueva funcionalidad en workspace)
+- **PATCH:** corrección de bug o mejora de UX sin feature nueva
+
+Sprint 7 = `v0.7.x` (MVP multi-tenant). Sprint 8 arranca en `v0.8.0`.
+
+### Secuencia de cierre de etapa
+
+Al completar una etapa con cambios en producción:
+
+```bash
+git add -A
+git commit -m "feat(scope): descripción concisa"
+# Actualizar CHANGELOG.md
+git add CHANGELOG.md
+git commit -m "docs(changelog): etapa N sprint X"
+git push origin main
+```
+
+Al cerrar un sprint completo, agregar además:
+
+```bash
+git tag -a vX.Y.Z -m "Release vX.Y.Z: descripción del sprint"
+git push --tags
+```
+
+### Versión visible en la app
+
+La versión se lee de `package.json` (`version` field) y se muestra en el footer de todas las páginas (o al menos en `/library` y `/report`). Formato: `InQ ROI v1.2.3`.
+
+Si no existe un componente de footer global, crearlo al implementar esta feature por primera vez.
+
+---
+
 ## Política de iniciativa proactiva
 
 Antes de aplicar un cambio fuera del scope del prompt actual, evaluar en orden: