do fastted/AgentDock

trellis-channel

trellis channel es el runtime de colaboración multiagente local. Úsalo cuando los agentes necesiten comunicarse a través de un registro de eventos durable, cuando se deba generar un worker como proceso peer, cuando un worker en vuelo necesite interrupción/depuración, o cuando se deba registrar retroalimentación en un canal duradero de --type forum.

Señales típicas del usuario: "discutir con codex/claude", "lluvia de ideas con otro agente", "generar un worker implement/check", "dejar que el agente revise", "abrir un tablero de issues / foro de cambios", "mirar este hilo", "el canal está atascado / sin salida", "el progreso fue truncado", "cómo escribo ese comando de canal".

Esta habilidad es un índice. Carga solo el archivo de referencia para el trabajo actual — no precargues todos.

Primeros Comandos

trellis --version
trellis channel --help
trellis channel list --all
trellis channel list --scope global --all

Si el usuario nombra un canal o hilo, inspecciónalo antes de preguntar contexto:

trellis channel forum <board> --scope global
trellis channel thread <board> <thread> --scope global
trellis channel context list <board> --scope global --thread <thread>

Enrutar por Intención del Usuario

Intención del usuario	Leer
"discutir con codex/claude", "lluvia de ideas con otro agente"	references/workflows.md
"enviar un agente implement/check", "dejar que el agente revise", "generar un worker"	references/workflows.md, luego references/workers.md
"abrir zona de issues / grupo de temas / changelog / board", "hacer un foro"	references/forum.md
"ver este hilo / contexto vinculado", "inspeccionar un hilo"	references/forum.md
"el canal está atascado / sin salida / progreso truncado", "worker detenido"	references/progress-debugging.md
"cómo se escribe ese comando específico", "qué flags toma X"	references/command-reference.md

Reglas Principales

• Los nuevos canales de foro usan --type forum. Un thread es un elemento dentro de un canal de foro.
• Usa --context-file / --context-raw y trellis channel context add/delete/list. --linked-context-* es terminología obsoleta.
• Usa --stdin o --text-file para mensajes largos. No pongas texto largo mezclado chino/inglés en el argumento posicional del shell.
• La salida messages pretty es un panel de operador y puede truncar el progreso. Usa --raw para auditoría.
• --as es el identificador del hablante o worker, dependiendo del comando. Usa nombres explícitos y estables cuando estén involucrados múltiples agentes o sesiones.
• --scope project (por defecto) opera en el bucket del proyecto actual; --scope global opera en el bucket __global__ compartido. Elige el ámbito deliberadamente — un tablero global es invisible desde los listados de proyecto a menos que se pase --scope global.
• Para lluvia de ideas, haz múltiples rondas de presión. Una respuesta más una confirmación es revisión, no lluvia de ideas.
• Patrón de espera del despachador: usa --kind done / --kind turn_finished (eventos del sistema emitidos por trellis), NO una --tag de usuario como señal de finalización. La ayuda de CLI lista phase_done / question como ejemplos de --tag pero solo interrupt es una etiqueta reservada con comportamiento hardcodeado de trellis; las otras son etiquetas de usuario opacas. Confiar en que un worker ejecute send --tag <my_signal> no es confiable — los workers LLM comúnmente escriben la cadena de la etiqueta en prosa en lugar de ejecutar el comando CLI real. Ver references/command-reference.md "tag vs kind".
• Los canales de foro tienen fuente de eventos. No analices events.jsonl primero; usa forum, thread, messages --thread y context list.
• @mindfoldhq/trellis-core es dueño del estado reutilizable de canal/hilo, adjuntar eventos, asignación de secuencia, proyección de contexto/título, reductores y ayudantes de tarea. La CLI es dueña de los flags, renderizado de terminal, prompts, ciclo de vida de workers y salidas de proceso.

Archivos de Referencia

• references/workflows.md — patrones de colaboración canónicos A–F (lluvia de ideas peer, revisión generada, despachar y esperar, captura de issues en foro, interrumpir y redirigir, ejecución única).
• references/forum.md — canales de foro, contexto, título, renombrar, foros de changelog, filtrado de hilos.
• references/workers.md — generar, tarjetas de agente, inyección de contexto (--file / --jsonl), interrupciones, semántica de eliminación.
• references/progress-debugging.md — inspección de progreso/raw, diagnóstico de worker detenido, protección OOM, códigos de salida.
• references/command-reference.md — referencia actual de comandos CLI (cada subcomando, cada flag, convenciones de salida, modelo de ámbito/tipo).

No Para

• Una revisión estática única donde un archivo markdown y un prompt son suficientes.
• Reemplazar llamadas normales a herramientas con autoregistro.
• Recuperación de memoria a largo plazo. Usa canales de foro duraderos para issues accionables, y trellis mem (la habilidad trellis-session-insight) para búsqueda de sesión/historial.