Saltar a contenido

Ventanas de Validacion UI/UX de la Triada

Objetivo

Establecer una validacion completa, repetible y visible para Kabehz, L0KY y AJCG131281 sobre las apps y rutas principales de atlantyqa-universe, con ventana de tiempo, dispositivos y checklist minimo por persona.

Contrato obligatorio

  • ninguna entrega de onboarding, issue relevante, PR o cambio de flujo humano puede considerarse lista sin validacion UI/UX registrada
  • la validacion debe cubrir desktop o laptop, smartphone y CLI; tablet se valida cuando el colaborador la use como dispositivo real
  • toda validacion debe acabar con evidencia en issue, PR o bitacora
  • si una app del stack no estuvo disponible, la validacion queda bloqueada, no aprobada

App stack minimo a revisar

  1. docs/index.md
  2. docs/portal/triad-control-plane.md
  3. docs/portal/github-collaboration-hub.md
  4. docs/portal/quickstart.md
  5. docs/portal/onboarding-quiz-wizard.md cuando el flujo de onboarding cambie
  6. bash scripts/atq
  7. bash scripts/atq collab doctor --collaborator-id <id>
  8. Project v2, issues y PR del repo
  9. docs/portal/triad-branch-host-env-sync-fsm.md

FSM junior para operar con CLI

Esta checklist debe leerse como una máquina de estados estilo ATLANTYQA FSM, alineada con la semántica MCP Jupynet/FSM del stack, para que un colaborador junior no tenga que adivinar el siguiente paso.

graph TD
    S0[S0_ENTRY<br/>abrir control plane] --> S1[S1_CONTEXT<br/>entender objetivo]
    S1 --> S2[S2_DOCTOR<br/>validar nodo CLI]
    S2 --> S3[S3_UI_ROUTE<br/>revisar portal y rutas]
    S3 --> S4[S4_PR_READ<br/>leer issue/PR]
    S4 --> S5[S5_EVIDENCE<br/>registrar validacion]
    S5 --> S6[S6_DECISION<br/>aprobado o cambios]
    S6 --> S7[S7_MAIN_READY<br/>mergeable]
    S2 --> F1[F1_BLOCKED<br/>doctor o entorno fallan]
    S3 --> F2[F2_UX_GAP<br/>rota la experiencia]
    S4 --> F3[F3_PR_UNCLEAR<br/>PR no entendible]
    S5 --> F4[F4_EVIDENCE_GAP<br/>falta evidencia]
    F1 --> S1
    F2 --> S3
    F3 --> S4
    F4 --> S5

    style S0 fill:#182232,stroke:#182232,stroke-width:2px,color:#ffffff
    style S1 fill:#eef9f5,stroke:#37a880,stroke-width:2px,color:#182232
    style S2 fill:#fdf8ef,stroke:#e7ae4c,stroke-width:2px,color:#182232
    style S3 fill:#eef9f5,stroke:#37a880,stroke-width:2px,color:#182232
    style S4 fill:#f8f9fa,stroke:#182232,stroke-width:2px,color:#182232
    style S5 fill:#eef9f5,stroke:#37a880,stroke-width:2px,color:#182232
    style S6 fill:#fdf8ef,stroke:#e7ae4c,stroke-width:2px,color:#182232
    style S7 fill:#37a880,stroke:#2d7f63,stroke-width:2px,color:#ffffff
    style F1 fill:#ffffff,stroke:#c94b4b,stroke-width:2px,color:#182232
    style F2 fill:#ffffff,stroke:#c94b4b,stroke-width:2px,color:#182232
    style F3 fill:#ffffff,stroke:#c94b4b,stroke-width:2px,color:#182232
    style F4 fill:#ffffff,stroke:#c94b4b,stroke-width:2px,color:#182232

Tabla de estados

Estado Qué hace el colaborador Comando o ruta Salida esperada
S0_ENTRY abre la vista guía portal/triad-control-plane/ entiende quién está activo
S1_CONTEXT formula objetivo en una frase issue/PR + control plane sabe qué intenta validar
S2_DOCTOR valida su nodo o shell bash scripts/atq collab doctor --collaborator-id <id> PASS o bloqueo explícito
S3_UI_ROUTE comprueba portal y CTA index, quickstart, hub navegación comprensible
S4_PR_READ lee la PR con criterio PR + diff + checks entiende cambio, riesgo y evidencia
S5_EVIDENCE registra hallazgos issue, PR o bitácora evidencia visible
S6_DECISION clasifica el estado aprobado, cambios requeridos, bloqueado decisión humana clara
S7_MAIN_READY deja la rama lista PR mergeable promoción posible a main

Estados de bloqueo

Estado Significado Acción correcta
F1_BLOCKED el colaborador no puede operar CLI o entorno volver a S1_CONTEXT y pedir ayuda sobre un único bloqueo
F2_UX_GAP la UI o navegación genera fricción real registrar hallazgo y corregir antes de promover
F3_PR_UNCLEAR la PR no se entiende rápido resumir objetivo, riesgo y siguiente paso
F4_EVIDENCE_GAP falta evidencia para decidir no mergear; completar prueba mínima

Ventanas de tiempo obligatorias

Ventana Tiempo Cuándo aplica Resultado esperado
daily-smoke 15 min inicio de jornada con cambios recientes detectar roturas evidentes en portal, CLI y navegación principal
pre-merge-full 45 min antes de merge o cierre de issue operativa validar flujo completo por actor con evidencia mínima
weekly-cross-device 60 min una vez por semana por colaborador activo recorrer móvil + desktop/laptop + CLI y registrar regresiones
release-readiness 90 min antes de demos, onboarding de terceros o cambios amplios de portal validar triada completa y backlog/rutas institucionales si quedan afectadas

Matriz por colaborador

Colaborador Dispositivo mínimo Foco principal Apps obligatorias
Kabehz laptop/desktop + smartphone + CLI contrato, rutas de coordinación, continuidad entre agentes index, triad-control-plane, github-collaboration-hub, atq, issues/PR
L0KY laptop/desktop + smartphone + CLI gobernanza, merge, gates y prioridad operativa triad-control-plane, github-collaboration-hub, quickstart, atq, Project v2, PR
AJCG131281 laptop/desktop + smartphone + CLI onboarding guiado, entendimiento de la tarea y ejecución sin fricción index, triad-control-plane, quickstart, onboarding quiz, atq collab doctor, issues

Checklist comun por dispositivo

Desktop o laptop

  • la portada explica en menos de 5 segundos cuál es la siguiente acción
  • triad-control-plane muestra claramente quién está activo y quién queda en backlog
  • github-collaboration-hub abre las rutas de trabajo correctas
  • quickstart conserva CTA visibles y comprensibles
  • no hay enlaces rotos ni referencias a actores fuera de la tríada activa como si fueran actores corrientes

Smartphone

  • el CTA principal de cada vista es visible sin zoom excesivo
  • los bloques de texto más críticos se entienden con scroll corto
  • los enlaces a GitHub App, issues o PR abren el destino esperado
  • la lectura del contrato de tríada y backlog es clara en vertical

CLI

  • bash scripts/atq responde con narrativa comprensible
  • bash scripts/atq collab doctor --collaborator-id <id> es ejecutable o deja bloqueo claro
  • los comandos sugeridos en portal coinciden con los wrappers reales del repo
  • no hay dependencia oculta del Python global si la validación afecta tooling Python
  • la respuesta AI distingue entre evidencia, hipótesis y siguiente paso
  • la interacción no añade presión innecesaria ni sobrecarga cognitiva

Tablet

  • las tablas clave no rompen la lectura
  • las CTA siguen siendo táctiles y legibles
  • si no se usa tablet real en esa sesión, registrar no-aplica

Checklist por persona

Kabehz

  • validar que la identidad base sigue siendo Kabehz y no aparece sustituida
  • validar que la política de no sustitución sigue enlazada y entendible
  • validar que la sincronización de los tres entornos queda visible como precondición

L0KY

  • validar que las rutas de revisión y merge son visibles desde móvil y desktop
  • validar que el backlog del resto de colaboradores no genera confusión operativa
  • validar que el flujo Project v2 -> issue -> PR mantiene trazabilidad

AJCG131281

  • validar que el primer paso es obvio sin ayuda externa
  • validar que el quickstart y el control plane no exigen contexto oculto
  • validar que hay un comando canónico claro para entrar y otro para diagnosticar el nodo
  • validar que la interacción AI guía con preguntas útiles y no genera ansiedad técnica evitable
  • poder recorrer al menos S0 -> S5 sin tutoría continua

Plantilla de evidencia

```md

UI/UX Validation Evidence

  • ventana: daily-smoke|pre-merge-full|weekly-cross-device|release-readiness
  • fecha:
  • actor:
  • dispositivos: desktop|smartphone|cli|tablet
  • alcance apps:
  • resultado: aprobado|cambios requeridos|bloqueado
  • checklist completada:
  • portada
  • triad-control-plane
  • github-collaboration-hub
  • quickstart
  • atq
  • project/issues/pr
  • hallazgos:
  • siguiente acción: ```

Cierre minimo

  1. adjuntar evidencia en issue, PR o bitácora
  2. registrar hallazgo con ruta exacta si algo falla
  3. si afecta a identidad, gobernanza o onboarding, no promover sin corrección