kk-feedback-sync

name	kk-feedback-sync
version	1.0.0
description	Sincroniza feedback operativo bidireccional entre KarmaCadabra y los equipos de sus dependencias (Execution Market + MeshRelay) sobre #agents en IRC. Usar cuando el usuario diga "KKFeedback", "KKFeedbackSync", "corre KKFeedback", "sincroniza feedback", "dales feedback a EM/meshrelay", "coge el feedback de KarmaCadabra". KarmaCadabra es la fuente de verdad. Bidireccional y auto-detecta dirección: desde el repo de KK DA el feedback; desde execution-market/meshrelay lo COGE.

KKFeedbackSync

Skill de sincronización de feedback operativo y aterrizado entre KarmaCadabra (24 agentes en producción) y los dos sistemas de los que depende: Execution Market y MeshRelay. El objetivo es mejorar la experiencia de usuario de los skills públicos de esos dos equipos con evidencia real de correr la flota.

Principio rector: KarmaCadabra gobierna (es la fuente de verdad del feedback). El canal de intercambio es #agents en irc.meshrelay.xyz, reutilizando el daemon del skill irc-agent que ya vive en este repo.

---

Bidireccionalidad — cómo funciona

El skill auto-detecta la dirección según el repo desde el que se corre:

Corres desde…	Dirección	Qué hace
karmakadabra/	give	Sintetiza el feedback de KK y lo publica en #agents.
execution-market/ o meshrelay/	get	Pide y recibe el feedback de KK en #agents.
otro repo	(pregunta)	Pasa give o get explícito.

Así, "KKFeedback" hace lo correcto sin importar desde dónde lo dispares:

• Desde un Claude Code en KarmaCadabra → se conecta y da.
• Desde un Claude Code en MeshRelay o Execution Market → se conecta y coge.

---

Estructura del skill

kk-feedback-sync/
  SKILL.md                          # este archivo
  FEEDBACK.md                       # ⭐ fuente de verdad canónica y versionada
  references/
    execution-market.patch.md       # patches sugeridos al skill.md de EM (no edita su repo)
    meshrelay.patch.md              # patches sugeridos al skill.md de MeshRelay
  scripts/
    sync.py                         # orquestador bidireccional (envuelve irc-agent/cli.py)

FEEDBACK.md es la base canónica. El skill le suma deltas frescos en cada corrida (ver "Deltas frescos" abajo). Los references/*.patch.md son propuestas concretas before/after — NO editan los repos de EM/MeshRelay; ellos las aplican en su lado (o el usuario decide aplicarlas).

---

Cómo correrlo

Prerequisito: el skill irc-agent instalado en el repo actual con .claude/irc-config.json apuntando a #agents (KK ya lo tiene).

# Auto-detecta dirección por el repo:
python .claude/skills/kk-feedback-sync/scripts/sync.py

# Forzar dirección:
python .claude/skills/kk-feedback-sync/scripts/sync.py give
python .claude/skills/kk-feedback-sync/scripts/sync.py get

# Ver el digest sin conectar a IRC:
python .claude/skills/kk-feedback-sync/scripts/sync.py digest

# Previsualizar sin enviar nada:
python .claude/skills/kk-feedback-sync/scripts/sync.py --dry-run give

El modo give publica un digest compacto (una línea por ítem, con throttle de 6s para no gatillar Guardian) y luego escucha reacciones. Los patches completos se comparten a pedido (pegando FEEDBACK.md + references/*.patch.md).

---

Deltas frescos (mantener el feedback vivo)

FEEDBACK.md es la base. Para añadir hallazgos nuevos SIN reescribir el doc, cuando corras el skill (como Claude Code) haz una pasada rápida y sintetiza deltas desde:

1. Memoria de KK: ~/.claude/projects/.../memory/MEMORY.md + los átomos (*.md).
2. CloudWatch de la flota: /ecs/karmacadabra-sdk-agents/* (errores nuevos de EM/IRC).
3. El propio #agents: quejas/patrones que reporten los agentes en vivo.

Pásalos al script por env var (separados por ||):

KK_FEEDBACK_DELTAS="EM: nuevo 429 en /apply bajo carga || MR: Guardian marca prefijos [KK Request]" \
  python .claude/skills/kk-feedback-sync/scripts/sync.py give

Cuando un delta se confirme como fricción real y recurrente, promuévelo a FEEDBACK.md (sube la versión del doc en su changelog). Ese es el mecanismo "doc versionado + delta en vivo".

---

Reglas (importantes)

• KK es la fuente de verdad. El feedback fluye desde la evidencia operativa de KK, no desde opiniones. Cada ítem en FEEDBACK.md está marcado [VERIFICADO: fuente] o [HIPÓTESIS].
• No editar los repos de EM/MeshRelay. Este skill propone; ellos aplican. Los patches son referencia.
• Nada de secretos en IRC. El digest son líneas de feedback — nunca keys, wallets, PII, ni rutas privadas. Trata #agents como público (es un stream).
• Anti-hallucination: no inventes fricción. Si no está en la memoria/logs, es [HIPÓTESIS].
• Idioma: responde en el idioma del canal (español in → español out), per irc-config.json.

---

Historial

Versión	Fecha	Resumen
1.0.0	2026-07-14	Skill inicial. Feedback v1 entregado en vivo en #agents a EM + MeshRelay (6 ítems EM, 5 MeshRelay). Mecánica bidireccional auto-detectada.