paulasilvatech ASP Personas del SDLC Agéntico v1.0.0
EN PT ES
24 enablement · Community

DevRel

Tutoriales, demos, comunidad.

Actualizado: 2026-04-24 14 secciones Descargar .zip

El DevRel es la persona responsable de la experiencia de developer fuera del equipo central: tutoriales, repositorios de demo, conversaciones con la comunidad y loops de feedback de regreso al producto. En un SDLC AI-nativo, DevRel opera una pipeline de contenido y comunidad, no un calendario de eventos.

Resumen ejecutivo

DevRel convierte la capacidad del producto en proficiencia de la comunidad. En un SDLC AI-nativo, DevRel trabaja dentro de la fase de Community con un conjunto fijo de primitivas: un agente demo-builder, cuatro slash prompts, instrucciones con alcance, hooks validados por schema y una lista curada de MCPs validados. Las salidas primarias son repositorios de demo reproducibles en GitHub, tutoriales publicados en estilo Microsoft Learn, briefs de video para sesiones grabadas y un digest regular de la comunidad que alimenta tanto a lectores externos como al equipo de producto.

Rol y responsabilidades

Piensa en el DevRel como un promotor de conciertos y un músico de sesión a la vez. El promotor reserva el lugar y calienta al público; el músico de sesión puede tocar con la banda y hacer que la música suene mejor. En un SDLC AI-nativo, DevRel amplifica el producto y al mismo tiempo toca al lado de los developers que lo adoptan.

Responsabilidades primarias:

  • Producir repositorios de demo en GitHub que se construyen con GitHub Actions y se despliegan en Azure (típicamente Azure Static Web Apps o Azure Container Apps para instancias en vivo)
  • Escribir tutoriales grounded en contenido vigente de Microsoft Learn, validados por el Microsoft Learn Docs MCP
  • Mantener la cadencia de la comunidad en GitHub Discussions, surgiendo temas al equipo de producto semanalmente
  • Guionizar y estructurar sesiones grabadas, livestreams y charlas de conferencia con briefs de video reutilizables
  • Alimentar Azure Boards con insight de la comunidad como feedback de producto priorizado
  • Colaborar con el Tech Writer para mantener tutoriales, demos y docs de referencia con cross-links
  • Operar el agente Demo Builder y los prompts /demo-script, /tutorial-outline, /video-brief, /community-digest

Jobs to be done

  1. Como DevRel, quiero un repositorio de demo scaffoldeado en minutos a partir de un escenario elegido, para grabar una sesión esa misma tarde.
  2. Como DevRel, quiero tutoriales que citen páginas vigentes de Microsoft Learn, para que los lectores nunca sigan pasos desactualizados.
  3. Como DevRel, quiero un digest semanal de los temas de GitHub Discussions, para que el equipo de producto escuche lo que la comunidad realmente está pidiendo.
  4. Como DevRel, quiero briefs de video con secciones cronometradas y snippets de código reproducibles, para que las grabaciones se mantengan ajustadas y editables.
  5. Como DevRel, quiero que cada repositorio de demo esté cubierto por CI de GitHub Actions, para que los espectadores puedan forkear y correr sin chocar con dependencias obsoletas.
  6. Como DevRel, quiero que las contribuciones de la comunidad se reconozcan sistemáticamente, para que los mejores contribuidores sigan engaged.

Dolores antes del AI-nativo

  1. Demos que se rompen seis semanas después. Una demo grabada en enero falla en marzo porque una dependencia se movió. Los espectadores pierden confianza.
  2. Tutoriales grounded en docs de ayer. El tutorial cita un flag que se renombró hace dos releases. Los lectores forkean el repo y chocan con errores.
  3. Temas de comunidad invisibles para producto. El equipo de producto escucha los tres issues más ruidosos y nada más; el 90 por ciento silencioso del feedback se pierde.
  4. Sesiones de video que derivan. Sin un brief estructurado, una demo de veinte minutos se convierte en un monólogo de cincuenta.
  5. Reconocimiento de contribuidores ad hoc. Los top contribuidores se van porque su trabajo pasa sin reconocimiento.

Flujo diario AI-nativo

El DevRel opera un loop diario. El loop usa primitivas de GitHub Copilot dentro de Visual Studio Code, Claude Code en la terminal para guionado de formato largo, y el Microsoft Learn Docs MCP para tutoriales grounded sobre temas de Azure y Microsoft 365.

Setup matinal

  1. Abre Visual Studio Code en el repositorio devrel. GitHub Copilot Chat carga .github/instructions/devrel.instructions.md con alcance.
  2. Invoca /community-digest. El agente Demo Builder lee GitHub Discussions a través de la org, agrupa temas y redacta un digest en devrel/digests/YYYY-WW.md.
  3. Hojea los resultados de la madrugada de GitHub Actions sobre todos los repositorios de demo: cualquier demo en rojo se triagea de inmediato para que los forkeadores no choquen con código roto.

Ejecución al mediodía

  1. Construye o refresca una demo. Invoca /demo-script <escenario>. El agente scaffoldea un repositorio con un README.md, un workflow de GitHub Actions que construye y despliega a Azure Static Web Apps o a Azure Container Apps, y una suite de pruebas mínima.
  2. Escribe o actualiza un tutorial. Invoca /tutorial-outline <tema>. El agente produce un plan de secciones grounded en contenido de Microsoft Learn vía el Microsoft Learn Docs MCP, con bloques de código que matchean el repo de demo.
  3. Empareja con un developer de un programa de embajadores en su propia contribución. Claude Code en la terminal recorre el repo y propone mejoras.

Revisión al final de la tarde

  1. Graba o prepara una sesión. Invoca /video-brief <sesión>. El agente produce un brief con secciones cronometradas, snippets de código reproducibles, cues en pantalla y un checklist para el editor.
  2. Publica contenido. GitHub Actions construye la demo, despliega a Azure y publica un anuncio en Teams vía el M365 Agents SDK cuando cae un nuevo tutorial.
  3. Cierra el día haciendo push del digest. Los Product Managers suscritos al canal de Teams reciben el digest; los items de alta señal se crean como work items en Azure Boards.

Primitivas recomendadas

Agente

AgenteArchivoPropósito
demo-builder.github/agents/demo-builder.agent.mdScaffoldear demos, redactar tutoriales grounded en Microsoft Learn, producir briefs de video, sintetizar el digest de la comunidad

El agente Demo Builder usa claude-sonnet-4-6 por defecto, con las herramientas read, edit, search, grep, glob, bash. Trae contexto desde GitHub, Microsoft Learn Docs y Azure MCPs, y usa el Playwright MCP para verificar que las demos desplegadas corren.

Slash prompts

ComandoArchivoPropósito
/demo-script.github/prompts/demo-script.prompt.mdScaffoldear un repositorio de demo con CI, target de despliegue y pasos reproducibles
/tutorial-outline.github/prompts/tutorial-outline.prompt.mdProducir un plan de secciones de tutorial grounded en Microsoft Learn
/video-brief.github/prompts/video-brief.prompt.mdRedactar un brief cronometrado para una sesión grabada con cues en pantalla
/community-digest.github/prompts/community-digest.prompt.mdAgrupar temas de GitHub Discussions y redactar un digest

Instrucciones con alcance

applyTo con alcance mantiene el contenido orientado a la comunidad distinto de los docs internos.

Alcance (applyTo)ArchivoPropósito
devrel/demos/**.github/instructions/demos.instructions.mdConvenciones de repo de demo, CI debe desplegar, disciplina de README
devrel/tutorials/**.github/instructions/tutorials.instructions.mdVoz del tutorial, cita de fuentes de Microsoft Learn, chequeos de accesibilidad
devrel/videos/**.github/instructions/videos.instructions.mdFormato de brief de video, disciplina de cronometrado, cues en pantalla

Hooks

Los hooks son gobernanza de cero tokens para artefactos de comunidad.

  • pre-commit: rechazar un tutorial sin cita a una página de Microsoft Learn o de GitHub Docs cuando el tema toca stacks de Microsoft o GitHub
  • post-commit: disparar un smoke test del Playwright MCP contra la demo desplegada cada vez que el repo de demo cambia
  • pre-push: verificar que cada repositorio de demo tenga un workflow de GitHub Actions verde dentro de los últimos siete días

MCPs validados

Cada MCP a continuación está registrado en el catálogo de MCPs. No referencies ningún MCP que no esté en el catálogo.

MCPEstadoUso en esta persona
GitHub MCP ServerOficialGestionar repositorios de demo, leer Discussions, crear issues para temas de comunidad
Microsoft Learn Docs MCPOficialGrounding de tutoriales en contenido vigente de Microsoft Learn para temas de Azure y Microsoft 365
Azure MCP ServerOficial (Microsoft)Desplegar e inspeccionar entornos de demo en Azure Static Web Apps y Azure Container Apps
Playwright MCPOficial (Microsoft)Smoke-test end-to-end de demos desplegadas para que los forkeadores nunca aterricen en instancias rotas
Azure DevOps MCP ServerOficial (Microsoft)Registrar feedback impulsado por la comunidad como work items en Azure Boards cuando el equipo de producto usa Azure Boards
Microsoft 365 Agents SDK MCPOficial (Microsoft)Anunciar nuevos tutoriales, demos y digests en canales de Microsoft Teams

Ejemplos reales

Ejemplo 1: demo para una nueva feature de Azure AI Foundry

Entrada: Una nueva capacidad sale en Azure AI Foundry; el equipo de producto quiere una demo en siete días.

Invocación: /demo-script foundry-agent-chat.

Salida esperada:

  1. Un nuevo repositorio devrel-demos/foundry-agent-chat con un README.md, un sample funcionando, un workflow de GitHub Actions que despliega a Azure Container Apps y un smoke test de Playwright.
  2. El draft de tutorial devrel/tutorials/foundry-agent-chat.mdx con cross-links a páginas de Microsoft Learn sobre Azure AI Foundry, vía el Microsoft Learn Docs MCP.
  3. Un brief de video en devrel/videos/foundry-agent-chat.md con tiempo de ejecución de diez minutos, tres secciones de walkthrough de código y cues en pantalla.
  4. Un anuncio de Teams vía el M365 Agents SDK al canal de comunidad de developers cuando la demo despliega exitosamente.

Ejemplo 2: digest semanal de la comunidad

Entrada: En los últimos siete días, GitHub Discussions vio 42 hilos en tres repositorios.

Invocación: /community-digest.

Salida esperada:

  1. Un digest en devrel/digests/2026-W17.md con tres clusters de tema: fricción de onboarding en la CLI, pedidos de un provider de Terraform, confusión sobre niveles de pricing.
  2. Cada tema cita al menos dos enlaces representativos de Discussions.
  3. Para cada tema, se redacta un work item de Azure Boards propuesto para que el equipo de producto considere; el DevRel triagea antes de archivar.
  4. Una publicación en Teams vía el M365 Agents SDK que resume el digest para los product managers que se suscriben.

Anti-patrones

  1. Demos sin CI. Una demo que no es construida por GitHub Actions se rompe en silencio. Mitigación: el hook pre-push rechaza demos sin un workflow verde en los últimos siete días.
  2. Tutoriales grounded en la memoria. Escribir desde la memoria es un generador de drift. Mitigación: tutorials.instructions.md requiere citas a Microsoft Learn vía el Microsoft Learn Docs MCP.
  3. Feedback de comunidad como anécdotas. Compartir una o dos quotes ruidosas no es señal. Mitigación: /community-digest agrupa temas con enlaces representativos.
  4. Sesiones de video sin brief. Una sesión sin brief corre largo y edita mal. Mitigación: /video-brief enforza disciplina de cronometrado y cues en pantalla.
  5. Reconocimiento de contribución ad hoc. Los thank-you ad hoc se pierden la mayoría de los contribuidores. Mitigación: la sección de contribuidores del digest trae PRs mergeados y respuestas aceptadas en Discussions desde el GitHub MCP.

KPIs y métricas de impacto

MétricaBaseline (manual)Objetivo (agéntico)Medición
Tasa de éxito de build de demo en fork60 por cientoMás del 95 por cientoHistorial de GitHub Actions
Tiempo desde release de producto hasta demo14 díasMenos de 3 díasLag release-a-demo
Cobertura de citas en tutoriales30 por cientoMás del 90 por cientoAuditoría de citas
Temas de comunidad alimentados a producto por semanaCero a unoTres a cincoHistorial del digest
Items de Azure Boards impulsados por comunidad por mesMenos de 5Más de 20Etiqueta de fuente de work-item
Eficiencia de tokensN/AMenos de 300k tokens por semanaReporte de uso de Copilot

Madurez en cuatro niveles

NivelNombreMarcadores
L1ManualDemos sin CI, tutoriales desde la memoria, sin digest de comunidad
L2AsistidoGitHub Copilot Chat para redacción, algunas demos en GitHub Actions, citas inconsistentes
L3AumentadoAgente Demo Builder, cuatro slash prompts, instrucciones con alcance, grounding del Microsoft Learn Docs MCP, smoke tests de Playwright
L4AgénticoKit completo de primitivas, hooks enforzados, temas de comunidad alimentando Azure Boards semanalmente, demos desplegadas en Azure con CI verde en todo momento, scorecard de madurez por encima del 80 por ciento

Integración con otras personas

  • Con el Product Owner: los temas de comunidad influyen en negociaciones de roadmap
  • Con el Tech Writer: los tutoriales hacen cross-link con docs de referencia
  • Con el Developer: las demos ejercitan APIs reales y surgen fricciones
  • Con el Release Manager: la cadencia de release se alinea con publicación de demos y tutoriales
  • Con el UX Designer: el flujo de tutorial y la fricción de onboarding alimentan investigación de UX
  • Con el Engineering Manager: carga de comunidad y capacidad del programa de embajadores
  • Con el InfoSec Officer: las demos se revisan por higiene de credenciales antes de la publicación

Glosario

  • Repositorio de demo: un repositorio de GitHub forkeable que construye y despliega en Azure, cubierto por CI y smoke tests de Playwright.
  • Tutorial: una guía paso a paso grounded en contenido vigente de Microsoft Learn y con cross-link a una demo.
  • Digest de comunidad: una síntesis semanal de los temas de GitHub Discussions, con enlaces representativos e items de feedback de producto propuestos.
  • Brief de video: un esquema estructurado para una sesión grabada, con secciones cronometradas, cues en pantalla y snippets de código reproducibles.
  • Programa de embajadores: un engagement estructurado con contribuidores externos de la comunidad que defienden el producto.
  • Disciplina de citas: la regla de que los tutoriales sobre temas de Microsoft o GitHub citan páginas vigentes de Microsoft Learn o de GitHub Docs.

Referencias