Cómo funciona harnsy

Ya usas Claude Code, Codex u OpenCode. Cada uno funciona bien solo. El problema empieza cuando usas varios. Un agente termina algo que el siguiente necesita, y tú lo copias a mano. Te conviertes en la oficina de correos entre tus propios agentes. Tu tiempo se va en pasar cosas de un lado a otro, no en decidir.

harnsy une estas herramientas. Funciona en tu máquina. Entrega un mensaje directamente en una sesión que ya está en marcha, y el agente lo lee en el turno en que ya está.

En harnsy eres el jefe y quien revisa, no un miembro del equipo. Dices lo que quieres. Un agente líder lo reparte en trabajo para los demás. Ellos lo hacen y se revisan entre sí. Tú intervienes solo cuando algo te espera: una respuesta, un permiso o un resultado que aceptar o devolver.

Hablas con el líder, no con cada agente. Lo que importa es que el resultado sea lo que pediste.

harnsy no promete trabajo sin una persona. En tareas difíciles los agentes todavía se desvían. Lo que te da es un proceso en el que tu tiempo va al líder y a los momentos que te necesitan.

Un harness es la herramienta en la que corre un agente: Claude Code, Codex u OpenCode. harnsy conecta las herramientas que ya tienes. No las sustituye. Usa solo la vía que cada herramienta ofrece para recibir un mensaje. Los permisos siguen siendo los de la herramienta.

Cada tarjeta dice lo mismo que el módulo que usa la palabra. Vuelve aquí cuando una palabra no esté clara.

Una empresa es el cuadro completo. Guarda las plantillas de roles. Un proyecto es una carpeta en la que trabajas. Un equipo pertenece a una carpeta de proyecto. Un rol es un puesto del equipo, con un mandato, objetivos y un entregable.

Los roles permanecen. Los agentes ocupan roles. Cuando se sustituye a un agente, el rol sigue.

Así, las instrucciones, sus versiones y las notas de traspaso escritas sostienen el trabajo, no la memoria de una sola sesión. Esa es la idea de «la empresa se queda, los agentes cambian».

Cada equipo tiene un rol de líder arriba. El líder reparte el trabajo y vigila quién está parado o atascado. Solo te pregunta lo que no puede decidir.

Los agentes ocupan los roles de abajo. Un rol puede tener más de un titular durante un tiempo: el sucesor está junto al titular anterior hasta que termina el traspaso.

Al líder se le avisa cuando:

• un agente está parado con trabajo abierto;
• una tarea lleva demasiado tiempo sin novedades;
• el contexto de un titular está muy lleno;
• un titular se ha ido con trabajo abierto.

El líder no revisa con un temporizador.

El trabajo se sigue con tareas. Una tarea pertenece a un rol, no a una sesión. Un sucesor la encuentra donde la dejó el titular anterior.

Una tarea pasa por Nueva → Tomada → En curso → En revisión → Hecha. También puede estar Bloqueada mientras espera (a ti, o a algo externo hasta una fecha), o Descartada. Nada se mueve solo: alguien lo mueve.

Cuando un agente entrega una tarea, escribe un resumen y las pruebas. Quien la pidió juzga el resultado: la acepta o la devuelve con una nota.

No miras el panel todo el día. Te llama: una notificación en la bandeja, la campana, una espera o un fallo. Actúas y vuelves a tu trabajo.

Funciona en tu máquina en 127.0.0.1:7788 y responde solo en tu máquina.

Un color significa lo mismo en todas partes. Ámbar: espera a una persona. Verde: trabaja. Rojo: ha fallado o no tiene titular. Azul: una acción. Además, cada color lleva una palabra o una forma.

Un mensaje es una palabra rápida a un agente, entregada en su sesión en marcha. Una tarea es trabajo con un responsable, un estado y un resultado. Un traspaso es una nota escrita. Permite que un agente nuevo asuma un rol cuando el contexto del anterior está lleno.

Un mensaje dice algo. Una tarea consigue que algo se haga. Un traspaso mantiene el trabajo en marcha de una sesión a la siguiente.

Un agente envía un mensaje a otro por su nombre. harnsy lo entrega al harness en el que corre el destinatario, a la manera de ese harness. El destinatario responde con una respuesta ligada al primer mensaje, así que una conversación sigue siendo una sola conversación.

Todo lo que pasa por el bus queda registrado. Puedes ver quién habló con quién en la pestaña Mensajes y en el gráfico de Conexiones.

Une cada canal con la línea que lo describe.

Si necesitas un resultado que alguien deba juzgar, crea una tarea. Si es una pregunta o un dato, envía un mensaje. Si el agente que tiene el conocimiento está a punto de irse, escribe un traspaso.

Cada paso de un agente vuelve a enviar todo su contexto, y un contexto tiene un final. Cada rol tiene un umbral de traspaso. Cuando el titular lo alcanza, se avisa al líder.

El trabajo continúa porque el siguiente agente sigue una nota. No es memoria infinita. harnsy no tiene hoy una función de memoria.

Seis pasos, desde instalar harnsy hasta tu primera palabra al líder. Un agente iniciador prepara el equipo contigo; no guarda nada sin tu sí.

harnsy sin clave: 1 proyecto, 10 agentes en marcha, sin otras máquinas. Una restauración que superara los 10 no abre nada.

Un documento de rol es lo que un agente lee al empezar. Contiene el mandato, los objetivos, el entregable, qué leer primero, quién es el líder, el umbral de traspaso y lo que hizo antes ese puesto.

Una plantilla de la empresa da la base. Un proyecto añade su propio texto encima. Un cambio se guarda como versión nueva, y se avisa al titular de que sus obligaciones cambiaron.

harnsy no anula los permisos de un harness. Cuando un agente pide ejecutar algo, o te hace una pregunta, la campana lo muestra con botones. Respondes ahí, sin abrir el terminal del agente. Ámbar significa que te espera.

Cuando una tarea llega a En revisión, la juzga quien la pidió. En tus propias peticiones, eres tú, en la tarjeta de la tarea.

Una pregunta. Comprueba que sabes leer el panel.