Praxis de Onboarding para Nuevos Colaboradores¶

Objetivo¶

Sincronizar a nuevos colaboradores con atlantyqa-universe mediante un flujo de adopción fácil de seguir, con rol claro, responsabilidades visibles, conocimientos a desarrollar y tareas accionables ya aterrizadas en issues.

Principio¶

onboarding por issue gobernada, no por mensajes sueltos
bootstrap local-first con comandos canónicos
evidencia y bitácora desde el primer día
rol y aprendizaje expresados de forma operativa y cognitivamente legible
local-first como contrato de preservación de acciones, prompts, evidencias y propiedad intelectual del colaborador
triada activa actual limitada a Kabehz, L0KY y AJCG131281; el resto queda en backlog hasta nueva activación explícita

Flujo recomendado para dos nuevos colaboradores¶

Dar de alta o duplicar sus filas en:
gitops/repo-governance/plans/collaborator-governance-actors.tsv
Ajustar como mínimo:
persona_key
persona_name
github_login
actor_type
role
org_unit
risk_level
governance_profile
required_approvers
default_labels
Generar sus issues de adopción:

bash bash scripts/atq collab enablement-issues --apply

Confirmar que cada issue ya incluye:
misión cognitiva del rol
responsabilidades nucleares
funciones operativas
conocimientos a desarrollar
praxis ATLANTYQA de 7 días
comandos canónicos de arranque y validación

Sincronizacion obligatoria de tres entornos locales¶

Para esta ola DevSecOps es obligatorio mantener sincronizados tres entornos locales:

entorno base de coordinacion de Jaime Silva (Kabehz)
entorno de L0KY
entorno de AJCG131281

Contrato minimo: - misma rama fuente de trabajo acordada - mismo entrypoint canónico scripts/atq - mismo contrato de .venv y validaciones locales - misma disciplina de bitácora, issue y PR gobernada - misma obligación de persistir artefactos y evidencia local antes de depender de servicios remotos - la base de coordinación Kabehz no puede ser sustituida por otro actor sin aprobación explícita de Kabehz, L0KY y AJCG131281 - validación UI/UX completa obligatoria con ventana explícita y evidencia por colaborador/dispositivo - no avanzar a tareas reales si uno de los tres entornos queda desalineado en bootstrap, branch o tooling base - no ejecutar flujos cloud-only o chat-only que dejen fuera del repo la autoría, la memoria operativa o la propiedad intelectual relevante

Comprobacion minima recomendada:

bash bash scripts/atq device sso describe --audience onboarding bash scripts/atq human onboarding --mode plan --domain ops --use-case bootstrap-artifacts bash scripts/atq collab doctor --collaborator-id <id>

Entry points canónicos para el colaborador¶

```bash

perfiles Codex canonizados al workspace del repo¶

bash scripts/dev/run_codex_workspace_profile.sh ajcg131281

narrativa guiada¶

bash scripts/atq device sso describe --audience onboarding

bootstrap reviewer edge por defecto¶

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

validación del nodo¶

bash scripts/atq collab doctor --collaborator-id

plan semántico de acompañamiento¶

bash scripts/atq human onboarding --mode plan --domain ops --use-case bootstrap-artifacts ```

Regla de facilitación¶

empezar por reviewer o edge salvo aprobación expresa de full-node
no usar variantes manuales si existe wrapper ATQ
toda fricción de entorno debe convertirse en evidencia y en issue, no en memoria privada
todo agente de colaborador debe dejar su rastro local reproducible antes de promover cambios o decisiones
al cerrar cada sesión, registrar bitácora en docs/internal/bitacora/
al cerrar cambios relevantes, registrar validación UI/UX siguiendo docs/portal/triad-ui-ux-validation-windows.md

Resultado esperado¶

Cada nuevo colaborador debe quedar con: - issue de enablement propia - rama gobernada - bootstrap canónico ejecutable - primera tarea pequeña definida - validaciones mínimas conocidas - handoff claro para continuar sin depender del chat