Quickstart 10 minutos: Context Steward para Tech People¶

Objetivo: dejar configurado en tu equipo local un steward que:

no pierda contexto entre sesiones/agentes,
guarde histórico literal (raw) + contexto compacto,
evite procesos largos con riesgo de memory leak (modo timer + one-shot).

1) Mapa mental rápido¶

mindmap
  root((Context Steward Tech))
    Setup inicial
      "Installer por actor"
      "Genera service+timer"
      "Activa systemd --user"
    Ciclo automático
      "Build raw literal"
      "Build compact pack"
      "Validate require-raw-transfer"
    Seguridad operativa
      "Lock exclusivo"
      "Timeout por ciclo"
      "Prune con retención"

2) Un comando por perfil tech¶

Ruta recomendada (bootstrap + steward en un paso)¶

bash python3 scripts/agent_context_bootstrap_local.py \ --profile codex \ --mode bootstrap \ --actor-login Kabehz \ --bootstrap-systemd-steward \ --steward-only-tech-people \ --steward-enable-now

Si quieres instalar por persona_key exacta, usa los comandos de abajo.

Angel (Junior Developer Track)¶

bash python3 scripts/install_context_steward_for_actor.py \ --persona-key angel \ --only-tech-people \ --apply \ --enable-now

Bosco (Infra IT Steward Track)¶

bash python3 scripts/install_context_steward_for_actor.py \ --persona-key bosco \ --only-tech-people \ --apply \ --enable-now

L0KY (Governance Lead)¶

bash python3 scripts/install_context_steward_for_actor.py \ --persona-key l0ky \ --only-tech-people \ --apply \ --enable-now

3) Qué hace el installer exactamente¶

Lee gitops/repo-governance/plans/collaborator-governance-actors.tsv.
Detecta preset por rol/unidad (engineering/operations/governance).
Genera en ~/.config/systemd/user/:
atq-context-steward-<persona>.service
atq-context-steward-<persona>.timer
Activa timer si usas --enable-now.

4) Verificación (copiar y pegar)¶

bash systemctl --user list-timers --all | rg atq-context-steward journalctl --user -u atq-context-steward-angel.service -n 100 --no-pager cat outputs/agent-context/context-pack-validation-latest.md cat outputs/agent-context/steward/context-steward-cycle-latest.json

Busca:

Result -> PASS en context-pack-validation-latest.md.
status = ok en context-steward-cycle-latest.json.

5) Si quieres solo previsualizar (sin instalar)¶

bash python3 scripts/install_context_steward_for_actor.py \ --persona-key angel \ --only-tech-people

6) Problemas comunes y solución rápida¶

Actor not found in governance TSV
revisa persona_key/github_login en el TSV.
si el actor aún no está de alta en el TSV, usa fallback local: bash python3 scripts/install_context_steward_for_actor.py --actor-login Kabehz --allow-unregistered-actor --only-tech-people --migrate-legacy-generic --apply --enable-now
Error recurrente por comando genérico legacy (atq-context-steward.timer/service)
no uses comandos genéricos para activar/verificar.
instala por actor con: bash python3 scripts/install_context_steward_for_actor.py --persona-key angel --only-tech-people --migrate-legacy-generic --apply --enable-now
verifica con unidad por persona: bash journalctl --user -u atq-context-steward-angel.service -n 100 --no-pager
systemctl --user no disponible
ejecuta en entorno Linux con user units habilitadas.
como fallback usa modo manual once: bash python3 scripts/agent_context_steward.py --mode once --profile codex --with-raw-transfer --require-raw-transfer
Validación falla por raw_transfer
vuelve a generar con --with-raw-transfer.
confirma que existe outputs/agent-context/raw/agent-context-raw-manifest-latest.json.