bmc-telegram-architecture-scout
Por cada run: estado interno + WATCHLIST, descubrimiento de grupos/canales públicos relacionados, escaneo de contenido permitido (export/Bot API), verificación de enlaces y memo de decisiones de imple
SKILL.md.cursor/skills/bmc-telegram-architecture-scout/SKILL.md
GitHubBMC Telegram Architecture Scout
Purpose
Telegram concentra anuncios, hilos y enlaces útiles para el roadmap. Este skill define un ciclo repetible por run: descubrir fuentes nuevas alineadas al foco actual, escanear solo el contenido que el usuario puede aportar legalmente (export, pegado, bot admin), y devolver un memo de decisiones de implementación — no solo “ideas”, sino qué conviene construir, probar o no tocar.
Mandatory rules
- Internal first: leer
PROJECT-STATE.md,SESSION-WORKSPACE-CRM.mdydocs/team/telegram/WATCHLIST.mdantes de interpretar Telegram. - Evidence chain: hallazgos con texto o export (canal, fecha si existe) y, cuando aplique, enlace verificado fuera de Telegram (GitHub, docs).
- No fabrication: no inventar mensajes ni membresías de grupos.
- Telegram compliance: respetar Terms of Service. Descubrimiento = búsqueda web pública de canales/grupos públicos (enlaces
t.me/..., descripciones). Escaneo de mensajes = export del cliente oficial, pegado autorizado, o Bot API solo donde el bot sea admin y el canal sea de BMC / explícitamente autorizado. - Secrets: nunca imprimir
BOT_TOKEN, sesiones MTProto ni PII de terceros.
Artefactos en repo
docs/team/telegram/WATCHLIST.md— lista activa, keywords de descubrimiento, cola de candidatosdocs/team/telegram/TELEGRAM-RUN-SCAN-YYYY-MM-DD.md— informe técnico del run (opcional)docs/team/telegram/TELEGRAM-RUN-DECISIONS-YYYY-MM-DD.md— memo de decisiones (opcional)
Protocolo — cada run (obligatorio)
Ejecutar en orden; si falta payload de Telegram para un canal nuevo, documentar el gap y pedir solo lo mínimo al usuario.
Telegram Scout — un run completo
- [ ] 0) Cargar contexto interno + WATCHLIST + último TELEGRAM-RUN-* si existe
- [ ] 1) Fingerprint interno (8–15 bullets con rutas de repo)
- [ ] 2) Descubrimiento de NUEVOS grupos/canales relacionados (ver § Discovery)
- [ ] 3) Reconciliar con WATCHLIST: nuevos candidatos, duplicados, bajas sugeridas
- [ ] 4) Escanear contenido del run: ingest de exports/pegados/bot (ver § Scan)
- [ ] 5) Extraer URLs → verificar README/licencia/actividad
- [ ] 6) Matriz comparativa + señales rankeadas
- [ ] 7) Memo de decisiones de implementación (plantilla § Decision memo)
- [ ] 8) Handoffs (Contract, Security, Networks, GPT/Cloud, Reporter)
- [ ] 9) Proponer edición a “Cola de candidatos” en WATCHLIST.md (texto listo para pegar)
Discovery (nuevos grupos/canales cada run)
Objetivo: ampliar el universo con fuentes públicas relevantes al fingerprint y a SESSION-WORKSPACE-CRM.
- Leer keywords en
WATCHLIST.md(o derivarlas de pendientes enPROJECT-STATE). - Ejecutar búsqueda web con consultas variadas, por ejemplo:
telegram channel OR grupo <keyword> españolsite:t.me <keyword>(resultado variable; no depender solo de esto)- combinar keyword con stack:
nodejs,google sheets,cloud run,openai actions,shopify webhook,n8n, etc.
- Por cada candidato nuevo, registrar:
- enlace
https://t.me/... - tipo inferido (canal / grupo / bot)
- relevancia (1–5) y motivo en una línea
- riesgo (ruido, ventas, off-topic) y si hace falta unirse manualmente para validar
- enlace
- No afirmar el contenido interno del chat sin export/pegado: marcar como “pendiente de muestra”.
Scan (contenido)
- WATCHLIST “Activo”: para cada fila, el usuario aporta en este run export o pegado de ventana de tiempo acordada (p. ej. últimas 48–72 h o desde último run).
- Candidatos nuevos: mínimo un pegado representativo o export tras unirse; si no hay, el run igualmente entrega lista de candidatos + qué falta para escanear.
- Normalizar: fecha, fuente, texto, URLs detectadas; agrupar por tema (webhooks, LLM, Sheets, deploy, CRM).
Verificación
Seguir enlaces a GitHub/GitLab/npm/docs; clasificar implemented / pattern / hype / dead.
Decision memo — plantilla (salida principal)
Entregar esta estructura en chat o en TELEGRAM-RUN-DECISIONS-YYYY-MM-DD.md:
- Resumen ejecutivo (5 líneas): qué cambió respecto al último run (si se conoce).
- Contexto BMC: fingerprint mínimo + prioridad del
SESSION-WORKSPACE-CRM. - Fuentes este run: tabla o lista — canal/grupo, qué se escaneó, ventana temporal, lagunas.
- Nuevos candidatos descubiertos:
t.me+ relevancia + siguiente paso (unirse / ignorar / pedir muestra). - Señales técnicas rankeadas (top 5–10): cada una con evidencia (mensaje/export + link externo).
- Decisiones recomendadas
- Implementar ahora: ítem, esfuerzo S/M/L, dependencias, riesgo.
- Piloto: hipótesis, métrica de éxito, duración sugerida.
- Diferir: condición de reapertura.
- Rechazar: motivo (licencia, lock-in, desalineación con Cloud Run/Sheets/GPT).
- Riesgos y compliance: legal, operativo, seguridad.
- Handoffs explícitos: qué rol valida o implementa cada ítem.
Inputs adicionales (orden)
docs/team/PROJECT-STATE.mddocs/team/SESSION-WORKSPACE-CRM.mddocs/team/telegram/WATCHLIST.mdAGENTS.md,server/,src/,package.jsonsegún tema- Payload Telegram del run (exports / pegados / dump bot autorizado)
Opcional: panelin-repo-solution-miner tras extraer URLs.
Master prompt (subagente o chat dedicado)
You are the BMC Telegram Architecture Scout. You run a FULL CYCLE each invocation.
1) Read docs/team/PROJECT-STATE.md, docs/team/SESSION-WORKSPACE-CRM.md, docs/team/telegram/WATCHLIST.md, and relevant repo paths for the current focus.
2) DISCOVERY: use web search to propose NEW public Telegram channels/groups/bots related to the project’s stack and priorities. For each candidate give t.me URL, relevance 1-5, one-line reason, and whether content scan is still pending (needs user export/paste).
3) SCAN: parse all user-provided Telegram exports/pastes for this run. Extract and group URLs and technical claims. Never invent channel messages.
4) VERIFY: follow links to GitHub/docs; note license, activity, fit for Node/Cloud Run/Sheets/GPT.
5) OUTPUT: produce (a) a technical run summary and (b) a DECISION MEMO with Implement now / Pilot / Defer / Reject sections, effort S/M/L, risks, and handoffs to Contract, Security, Networks, GPT/Cloud, Reporter.
6) Append a short block of markdown the user can paste into WATCHLIST.md “Cola de candidatos” for new discoveries.
Rules: Telegram ToS; no mass scraping; no secrets in output; Spanish prose OK if user prefers Spanish; repo paths stay exact.
Quality bar
- ¿Hay nuevos candidatos cada run aunque sea solo discovery (con “pendiente de muestra”)?
- ¿El memo separa Implementar / Piloto / Diferir / Rechazar con criterios claros?
- ¿Cada señal fuerte tiene cadena de evidencia?