Academia

Aprende a recorrer una página de arquitectura viva: contenedores, flujos que se reproducen sobre el diagrama, estados y datos, sin perderte en las flechas.

Monitor ultrawide partido: Windows a la izquierda, Mac a la derecha

Arquitectura de agentes (cuándo agente vs workflow, jerarquías), construcción con Claude (Agent SDK, loops a mano, hooks), patrones y frameworks (tool-use loops, subagentes, memoria, Strands/LangGraph/PydanticAI).

Mirar las dos líneas de la barra de estado y saber, en un vistazo, cuatro cosas: cuánto contexto te queda antes de que la sesión se degrade, si la caché sigue caliente, si tu trabajo está a salvo (commit, push, HANDOFF)…

Documenta tu proyecto con ArqViva: investiga, copia la plantilla, rellena N, E y FLOWS, escribe el manifiesto y pasa el importador sin hallazgos de privacidad.

El dominio más pesado. Cubre: requerimientos → arquitectura, ciclo de vida, mecánica de la Messages API, fundamentos de ingeniería (REST/JSON/async/git), diseño de aplicaciones Claude y gestión de configuración.

Antes de elegir modelo hay que preguntarse si hace falta uno. Trabajo determinista y repetible va a código que corre sin modelo (Python/SQL/shell).

Homebrew, Claude Code, gh, PATH que sirve también por SSH

Componentes (Rules, Skills, Commands, Agents, Agent Memory), gestión de sesión, slash commands, modos headless/streaming/auto, jerarquía de CLAUDE.md y settings.json. Pesa poco en CCDV-F (20 % en CCAR-F).

Fuentes: home/.claude/rules/context-hygiene.md, home/.claude/rules/thresholds.json, home/.claude/settings.json, home/.claude/statusline.sh, home/.claude/MANUAL.md cap. 2, home/.claude/CLAUDE.md §Status line.

Identificar errores y estrategias de recuperación; análisis de trazas; aislar si el problema está en la capa de integración o en la salida del modelo.

Secciones fijas, con estos encabezados exactos:

Fundamentos de LLM, fundamentos técnicos (SDK/REST/WebSocket), elección de modelo y gestión de costo/tokens. Junto con D2 es la mitad del examen. Objetivos: D5.T1 … D5.T4.

Cinco scripts en home/.claude/hooks/, conectados en home/.claude/settings.json. Todo hook sale siempre con código 0 — un hook nunca debe ser la razón de que fallen la sesión, una compactación o la herramienta que…

Copia de fotos con sha256 en disco externo

Context engineering (ventana, memoria, deriva, compactación, aislamiento), prompt engineering (claridad, few-shot, system vs user, restricciones, saneamiento) y output handling (estructura, validación, parsing…

Fuentes: home/.claude/rules/thresholds.json (archivo completo), docs/statusline-internals.md §Thresholds, home/.claude/statusline.sh, home/.claude/hooks/session-drift-warn.sh, tests/statuslinetest.sh.

macOS 15.3.1 a 27.0.1 y qué cambió

Seguridad de aplicaciones con IA (inyección, jailbreak, PII, fuga), guardrails y despliegue seguro, hooks como control, identidad/secretos/llaves. Pocas preguntas, muy predecibles.

Un modelo que revisa su propia salida muestra sesgo de auto-preferencia medible; uno distinto y al menos igual de fuerte, no.

Repos por git bundle, port, tests, config en capas

Implementación de tools (schema, descripciones, errores, toolchoice, paralelo, client vs server, aprobación), desarrollo de servidores MCP (tools/resources/prompts, stdio vs HTTP) y personalización agéntica (built-in vs…

Fuente: home/.claude/MANUAL.md (índice); home/.claude/skills/manual/SKILL.md.

enjambre run: Windows manda, vuelve una rama + ledger

Proyecto: Chasqui (bot diario Barchart + SUNAT → Excel + PPT → Gmail). Objetivos: D2.T3.a/c/d/e · D5.T1.a/b/c · D5.T2.b Tiempo: 3–4 h.

Una noche de trabajo sin supervisión, con reglas e informe

Proyecto: farmacias (Radar de Precios; matcher de 3 capas). Objetivos: D2.T3.b · D8.T1.a/b/c · D6.T3.a/b · D6.T2.a/b · D5.T1.d Tiempo: 4–5 h.

Proyecto: Chasqui (histórico de 90 días) o sttwhisper (post-edición nocturna de transcripciones). Objetivos: D5.T4.a/b · D2.T3.f/h · D5.T3.a/b · D2.T1 Tiempo: 3–4 h (+ espera del batch).

claude, gh y git por SSH con un tmux que nace en tu sesión; primer trabajo real

Proyecto: signal-agent (ledger de predicciones; 163 tests, mypy strict, GitHub Actions). Objetivos: D2.T4.a/b/c · D2.T6 · D2.T2 · D5.T2.a · D5.T3.c · D4.T1 Tiempo: 4–5 h.

Blender en Metal: STL → PNG con una línea desde Windows; Onshape → render; algoritmos en las dos máquinas

Proyecto: archivador de videos propios (transcribir con sttwhisper, clasificar, archivar) — o orquestador. Objetivos: D1.T1 · D1.T2 · D1.T3.a · D6.T1 · D8.T1.d Tiempo: 5–6 h.

enjambre watch sabe qué nodos están listos; los trabajos a un nodo caído esperan en cola

Proyecto: nuevo Portfolio/mcp-estadistica/ con datos sintéticos (nunca datos reales) + claude-kit. Objetivos: D8.T2 · D8.T3 · D3.T1 · D2.T5.a · D2.T6.a Tiempo: 5–6 h.

Cinco modelos MLX con sha256, servidos de a uno por un gestor que Windows usa por túnel

Proyectos: pdf-redactor · el MCP del Lab 06 · configuración global de Claude Code · Portfolio (pre-commit) · Chasqui (logs). Objetivos: D7 completo · D6.T2.c · D8.T1.d Tiempo: 4–5 h.

Audio → texto con "Hablante N" renombrable; ~24 h de audio por hora, medido con verdad conocida

Mismas tareas en las dos máquinas; nube vs local en claude -p; modelo local de código vs Claude

Una página con nodos, sesiones abiertas, consumo, cola y comparativa por tipo de tarea; resumen en la statusline

Catálogo, banco de pruebas y elección automática de modelo por tarea, medidos en la Mac

Toda sesión de Claude Code, en las dos máquinas, sabe que la Mac existe; ssh mac a pelo se bloquea con un hook; /mac deja AGENTS.md + DELEGAR.md

Visor con dos costos (equivalente API y cuota) e historial propio que no se borra; copia web redactada con lista de permitidos; bandeja para dejar tareas desde el celular que la PC recoge, valida y encola

enjambre script (comando declarado en AGENTS.md, $0) y run --detach (agente con tope en USD): vuelven al instante, laten, se reanudan si mueren y dejan una línea en el ledger; kind: tests con exactamente Bash(<tests-cmd>)

Un Claude Code persistente en la Mac al que Windows le habla (enjambre chat/send/sessions), con Playwright, ledger por turno y gui sí/no en status; modelo de amenazas de la clave

Cada fallo con su causa y agrupado; pruebas aparte; proyectos ordenables por gasto desde el celular; línea de tiempo con zoom; consumo con lentes y mapa de calor; modelos locales con logo, estado y nota editables

Lo que corre ahora, arriba y en verde, cada 10 s (enjambre live --serve); por nodo: CPU, GPU, RAM con presión y swap, térmico, red, gráficas de 4 h y procesos etiquetados con su trabajo o sesión

Lo urgente pasa delante sin matar lo que espera: reglas en un archivo, admisión, prioridad del sistema operativo y preempción en el tick de live --serve

Cada número del visor dice de cuándo es y de dónde sale; la causa de un fallo sin el nombre de usuario

Un trabajo que no puede correr falla en el acto y dice por qué; clone, --ref, dead-at-launch, logs, cerrar

Dejé a Claude Code trabajando solo varias horas sobre dos computadoras y 59 repos. Estas son las reglas que escribí antes de dormir, lo que logró con evidencia y los errores que él mismo declaró.

Entrar a la Mac por SSH sin contraseña: llave propia, alias, el hardening con un drop-in y el error de pegar varios comandos a la vez.

Dos veces la Mac cambió de IP y ssh dejó de responder: una por conectarse al hotspot del iPhone y otra después de actualizar macOS.

Un enrutador de 200 líneas para un Windows y una Mac: capacidades, estado vivo, historia medida y una línea que explica cada decisión. Y por qué hoy la historia no decide nada.

Una página por proyecto que muestra cómo fluye la información: qué piezas existen, en qué máquina corre cada una y por dónde pasa una petición o un archivo. Tiene dos ideas detrás.

zsh lee archivos distintos según cómo se abra:

En electrónica, el backplane es la placa trasera de un chasis a la que se enchufan todas las tarjetas: ninguna habla directamente con otra, todas hablan a través de la placa.

Un lugar donde los trabajos esperan hasta que haya alguien libre para hacerlos. El que pide (enjambre run) y el que despacha (enjambre watch) no necesitan estar activos al mismo tiempo: la cola los desacopla.

En Windows, cada programa de línea de comandos (ssh.exe, ping.exe, python.exe) necesita una consola: la ventana negra donde escribe. Al arrancar no la crea de cero: hereda la de su padre.

DHCP es el servicio del módem que presta direcciones IP. La IP es un préstamo (lease) con vencimiento: el equipo puede recibir otra la próxima vez. Una reserva le dice al módem "a esta MAC dale siempre esta IP".

Decidir en qué máquina corre un trabajo. Aquí lo decide una tabla más el estado vivo, no un modelo de IA: routing.toml dice qué necesita cada tipo de trabajo y qué máquina se prefiere;

Un bus es el canal por donde viajan los resultados entre piezas de un sistema. Aquí el canal es git: cada trabajo termina en una rama y el resultado se mueve con push y fetch.

Cada servidor SSH tiene una llave de host. Su huella (fingerprint) es un resumen corto de esa llave, del tipo SHA256:<huella>.

Deskflow cifra el tráfico de teclado y mouse entre servidor y cliente con TLS. Los certificados son autofirmados: no hay una autoridad que los avale.

Una operación es idempotente si ejecutarla dos veces deja el sistema igual que ejecutarla una. No significa "no hace nada la segunda vez" por casualidad: significa que compara el estado actual con el deseado y solo…

Un trabajo largo que nadie mira tiene que poder responder dos preguntas sin que alguien entre a la máquina: ¿sigue vivo? y si murió, ¿puede seguir donde quedó?

Dar a un agente solo lo que necesita para la tarea, y que lo que no está permitido se niegue en vez de preguntarse. Con nadie mirando, una pregunta de permiso es un bloqueo; un permiso de más es un riesgo.

Qué es: la capacidad de saber qué está pasando dentro de un sistema mirando lo que ya emite: registros (logs), métricas y trazas. No hay que entrar a cada máquina a preguntar.

Dos formas de filtrar lo que sale de un sistema. Una lista de permitidos (allowlist) dice qué se deja pasar y descarta todo lo demás. Una lista de prohibidos (denylist) dice qué se bloquea y deja pasar el resto.

Separar qué se quiere (la política) de cómo se hace cumplir (el mecanismo). La política se escribe donde un humano la lee y la cambia; el mecanismo es código pequeño que la aplica sin opinar.

Un tope de gasto que pertenece a un trabajo, no a la cuenta: "este agente puede gastar como mucho US$2". Cuando lo alcanza, se detiene solo, deja lo que hizo y avisa por qué paró.

Cada trabajo del enjambre tiene una clase: alta > normal > baja > nocturna. Si no se dice nada, es normal. La clase se puede dar con --priority, con una línea del TASK o con enjambre prioridad <id> <clase>.

Dos formas de mover un mensaje entre dos máquinas. En push, el emisor llama al receptor cuando hay algo (un webhook). En pull, el receptor pregunta cada cierto tiempo si hay algo nuevo (sondeo).

Tres copias de los datos, en dos tipos de medio distintos, y una fuera de sitio. Una copia que nunca se verificó es una esperanza: por eso se compara con una suma de control (sha256) contra el original.

Hay dos formas de saber si una máquina está viva: - Sondeo (polling): el que quiere saber pregunta cada cierto tiempo, y quien responde está vivo.

Hay dos formas de usar un agente.

Un worktree es una segunda (o tercera) carpeta de trabajo del mismo repositorio, con su propia rama activa. Todas comparten un único .git: no se copia el historial.