agents_and_robots/dev/issues/completed/0033-bot-commands-no-prefix.md

0033 — Comandos de robots sin prefijo !

Objetivo

Permitir que los robots respondan a comandos sin necesitar el prefijo !. Actualmente los bots requieren !help, !ping, etc. El objetivo es que un robot pueda configurar sus comandos para que funcionen tambien sin prefijo: help, ping, status.

Esto es especialmente util para robots interactivos donde el prefijo ! es friccion innecesaria — los robots solo responden comandos, asi que todo mensaje es potencialmente un comando.

Contexto

• Los robots (agent.type: robot) solo responden a comandos, no tienen LLM
• El sistema de comandos actual en agents/handler.go parsea el prefijo ! en shell/matrix/listener.go
• El campo matrix.filters.command_prefix ya existe en el config pero esta hardcoded a !
• Los agentes con LLM necesitan el prefijo para distinguir comandos de mensajes normales
• Los robots NO necesitan esta distincion — todo mensaje a un robot es un comando o se ignora

Arquitectura

shell/matrix/listener.go           MOD — parsear comandos con o sin prefijo segun config
pkg/decision/types.go              MOD — asegurar que Command se popula sin prefijo
agents/handler.go                  MOD — routing de comandos: si robot y sin prefijo, intentar match
agents/robot.go                    MOD — handleEvent acepta comandos sin prefijo
internal/config/schema.go          MOD — documentar command_prefix: "" como "sin prefijo"
agents/_template_robot/config.yaml MOD — ejemplo con command_prefix: ""

Patron pure core / impure shell

• pkg/decision/types.go — puro: solo tipos, MessageContext ya tiene campo Command
• shell/matrix/listener.go — impuro: parseo del evento Matrix, detectar comando con/sin prefijo
• agents/robot.go + agents/handler.go — composicion: routing de comandos

Comportamiento esperado

Config	Mensaje	Resultado
command_prefix: "!"	!help	Ejecuta help
command_prefix: "!"	help	Ignora (sin prefijo)
command_prefix: ""	help	Ejecuta help
command_prefix: ""	!help	Ejecuta help (retrocompatible)
command_prefix: ""	hola mundo	"Comando desconocido: hola"

Cuando command_prefix es vacio:

• El primer token del mensaje se trata como nombre de comando
• Si el primer token empieza con !, se le quita el prefijo y se busca igual
• Si no hay match, responder "Comando desconocido" (comportamiento actual)

Tareas

Fase 1: Parser de comandos flexible

• 1.1 Modificar shell/matrix/listener.go — al parsear el evento, si command_prefix es vacio, tratar el primer token como comando (sin requerir !). Si tiene prefijo !, quitarlo igualmente para retrocompatibilidad.
• 1.2 Asegurar que MessageContext.Command se popula correctamente en ambos modos.
• 1.3 NO cambiar el comportamiento para agentes con LLM (type: agent) — solo afecta cuando command_prefix: "".

Fase 2: Routing en robot

• 2.1 Verificar que agents/robot.go ya maneja correctamente el campo Command de MessageContext — no deberia necesitar cambios si el parser hace bien su trabajo.
• 2.2 Si es necesario, ajustar handleEvent en robot para aceptar comandos sin prefijo.

Fase 3: Config y template

• 3.1 Documentar en internal/config/schema.go que command_prefix: "" significa "sin prefijo".
• 3.2 Actualizar agents/_template_robot/config.yaml para mostrar command_prefix: "" como opcion comentada.

Fase 4: Tests

• 4.1 Tests unitarios para el parser de comandos: con prefijo !, sin prefijo, prefijo vacio en config.
• 4.2 Tests para robot handleEvent con comandos sin prefijo.
• 4.3 Tests de regresion: verificar que agentes con LLM siguen funcionando igual con command_prefix: "!".
• 4.4 go build -tags goolm ./... y go test -tags goolm ./...

Fase 5: Cleanup

• 5.1 Actualizar .claude/rules/create_command.md mencionando la opcion sin prefijo para robots.

Ejemplo de uso

# config.yaml del robot
agent:
  type: robot
matrix:
  filters:
    command_prefix: ""    # sin prefijo — todo mensaje es potencial comando

Usuario: help
Bot: Comandos disponibles: help, ping, status, info, version

Usuario: ping
Bot: pong (latencia: 23ms)

Usuario: !help          # retrocompatible
Bot: Comandos disponibles: help, ping, status, info, version

Usuario: hola mundo
Bot: Comando desconocido: hola. Usa 'help' para ver los comandos disponibles.

Decisiones de diseno

• Solo para robots: los agentes con LLM siguen necesitando ! para distinguir comandos de mensajes naturales. Cambiar esto para agentes romperia el flujo de reglas → LLM.
• Retrocompatibilidad con !: aunque el prefijo este vacio, seguir aceptando ! para no confundir a usuarios acostumbrados.
• Comando desconocido explicito: cuando todo es un potencial comando, responder "desconocido" con sugerencia de help es mejor UX que silencio.
• Cambio en listener, no en robot: el parseo debe ocurrir en la capa impura (listener), no en la logica de routing.

Prerequisitos

• Issue 0030 completado (Robot vs Agent separacion) ✓

Riesgos

• Falsos positivos: mensajes que no son comandos se interpretaran como comandos desconocidos. Mitigacion: esto es intencional para robots (solo reciben comandos).
• Retrocompatibilidad: agentes existentes con command_prefix: "!" no deben cambiar. Mitigacion: el cambio solo aplica cuando prefix es vacio.