Skip to content

Sesion Live de la Triada hacia Main

Objetivo

Guiar una sesión live de 15 minutos para que Kabehz, L0KY y AJCG131281 puedan leer la PR, interactuar con ATLANTYQA y cerrar cada una de sus ramas con criterio de promoción hacia main.

Contrato canónico de promoción

Antes de cualquier decisión de merge, revisar: docs/portal/triad-staging-promotion-canonical-flow.md.

Resultado esperado al cerrar la sesion

  1. las tres personas entienden el estado real de la PR o PRs activas
  2. cada colaborador ejecuta o presencia al menos una interacción real con atq
  3. cada rama queda en uno de estos estados: lista para merge, lista con cambios menores, bloqueada con causa
  4. no se empuja a main nada sin decisión humana explícita

Agenda de 15 minutos

Minuto Bloque Responsable principal Salida
0-2 abrir control plane y contexto Kabehz todos entienden triada activa, backlog y objetivo
2-5 leer PR y diff de alto nivel L0KY riesgos, cambios y checks visibles
5-8 ejecutar interacción con ATLANTYQA AJCG131281 comando real ejecutado y explicado
8-11 revisar checklist UI/UX + evidencias los 3 estado aprobado/cambios/bloqueado por rama
11-13 decidir ruta de merge Kabehz + L0KY acuerdo sobre merge, fix o bloqueo
13-15 cerrar bitácora y siguiente acción los 3 responsables y siguiente paso exacto

FSM live para junior collaborators

graph LR
    A[S0_OPEN] --> B[S1_CONTEXT]
    B --> C[S2_READ_PR]
    C --> D[S3_RUN_ATQ]
    D --> E[S4_VALIDATE_UIUX]
    E --> F[S5_DECIDE_BRANCH]
    F --> G[S6_READY_FOR_MAIN]
    C --> H[F1_NEEDS_SUMMARY]
    D --> I[F2_CLI_BLOCKED]
    E --> J[F3_UX_BLOCKED]
    F --> K[F4_NOT_MERGEABLE]

    style A fill:#182232,stroke:#182232,stroke-width:2px,color:#ffffff
    style G fill:#37a880,stroke:#2d7f63,stroke-width:2px,color:#ffffff
    style H fill:#ffffff,stroke:#c94b4b,stroke-width:2px,color:#182232
    style I fill:#ffffff,stroke:#c94b4b,stroke-width:2px,color:#182232
    style J fill:#ffffff,stroke:#c94b4b,stroke-width:2px,color:#182232
    style K fill:#ffffff,stroke:#c94b4b,stroke-width:2px,color:#182232

Tabla rápida de estados live

Estado Responsable dominante Qué debe ocurrir
S0_OPEN Kabehz todos miran la misma superficie visual
S1_CONTEXT Kabehz objetivo y rama quedan claros
S2_READ_PR L0KY la PR se entiende en lenguaje humano
S3_RUN_ATQ AJCG131281 se ejecuta un comando real del sistema
S4_VALIDATE_UIUX los 3 la checklist FSM avanza sin bloqueo grave
S5_DECIDE_BRANCH Kabehz + L0KY cada rama se clasifica
S6_READY_FOR_MAIN los 3 solo quedan ramas mergeables

Si un junior cae en F1_NEEDS_SUMMARY, F2_CLI_BLOCKED, F3_UX_BLOCKED o F4_NOT_MERGEABLE, la sesión no fuerza el merge: vuelve al último estado entendible y deja siguiente acción corta.

Pantallas o rutas que deben abrirse

  1. portal/triad-control-plane/
  2. portal/triad-ui-ux-validation-windows/
  3. portal/github-collaboration-hub/
  4. PR activa en GitHub
  5. issue o issues asociadas
  6. portal/triad-branch-host-env-sync-fsm/

Secuencia guiada de lectura de PR

1. Kabehz

  • explicar en una frase el objetivo del bloque
  • confirmar que la PR pertenece a una de las ramas activas de la tríada
  • recordar si el cambio es para merge directo a main o si requiere una PR intermedia

2. L0KY

  • leer archivos tocados y resumir riesgo
  • comprobar checks y decisión humana pendiente
  • preguntar: ¿qué evidencia demuestra que esto está listo para merge?

3. AJCG131281

  • explicar con sus palabras qué hace la PR
  • ejecutar un comando ATQ o collab doctor
  • responder: ¿qué sería lo primero que mirarías si fallara?

Interacción mínima con ATLANTYQA durante la sesión

Coordinación

bash bash scripts/atq human ops --mode plan --domain governance --use-case triad-sync

Revisión/diagnóstico

bash bash scripts/atq ops reconcile --audience onboarding --dry-run

Nodo de Angel

bash bash scripts/atq collab doctor --collaborator-id ajcg131281

Sincronización canónica antes de la sesión

bash bash scripts/atq collab sync \ --role reviewer \ --collaborator-id ajcg131281 \ --oauth-bundle-file .secrets/governance/oauth/local-collaborators/ajcg131281/bundle.env \ --team devsecops

Checklist de cierre por rama

Rama de Kabehz

  • scope claro
  • evidencia adjunta
  • sin contradicción con la identidad base ni con la tríada activa
  • estado final: mergeable o bloqueada

Rama de L0KY

  • revisión de riesgo hecha
  • decisión humana en PR o comentario visible
  • checks revisados o bloqueo explícito
  • estado final: mergeable o bloqueada

Rama de AJCG131281

  • primer paso comprendido y explicado
  • comando real ejecutado o bloqueo claro
  • PR entendible por terceros
  • estado final: mergeable, needs-small-fix o bloqueada
  • recorrido FSM mínimo completado: S0_OPEN -> S4_VALIDATE_UIUX

Criterio para incorporar a main

  • solo mergear ramas con checks suficientes, evidencia visible y decisión humana explícita
  • si una rama necesita fix pequeño, se anota y no se fuerza el merge en caliente
  • si la PR mezcla demasiadas cosas, partirla antes de llevarla a main
  • si hay duda sobre riesgo, dejar la rama viva y programar siguiente bloque

Script de cierre verbal sugerido

  1. que sabemos
  2. que falta
  3. que rama puede ir a main ahora
  4. que rama necesita fix
  5. quien hace el siguiente paso y cuando

Plantilla rápida de acta

```md

Live Session Closeout

  • fecha:
  • asistentes: Kabehz, L0KY, AJCG131281
  • ramas revisadas:
  • PR revisadas:
  • comandos ejecutados:
  • estado por rama:
  • Kabehz:
  • L0KY:
  • AJCG131281:
  • decisión sobre main:
  • bloqueos:
  • siguiente paso: ```

Regla humana y cognitiva

  • usar preguntas cortas y una sola decisión principal por bloque
  • si aparece confusión, volver a objetivo -> evidencia -> siguiente paso
  • evitar presión improductiva: mejor bloqueada con causa que mergeada sin claridad