Paula Silva Software Global Black Belt
LinkedIn
24 enablement · Community

DevRelDevRelDevRel

Tutorials, demos, community.Tutoriais, demos, comunidade.Tutoriales, demos, comunidad.

2026-04-24 14 sections Download the GitHub Copilot kitBaixar o kit do GitHub CopilotDescargar el kit de GitHub Copilot

The DevRel is the persona accountable for the developer experience outside the core team: tutorials, demo repositories, community conversations, and feedback loops back into the product. In an AI-native SDLC, DevRel operates a content and community pipeline, not an event calendar.

Executive summary

DevRel turns product capability into community proficiency. In an AI-native SDLC, DevRel works inside the Community phase with a fixed set of primitives: one demo-builder agent, four slash prompts, scoped instructions, schema-validated hooks, and a curated list of validated MCPs. The primary outputs are reproducible demo repositories on GitHub, tutorials published through Microsoft Learn-style content, video briefs for recorded sessions, and a regular community digest that feeds both external readers and the product team.

Role and responsibilities

Think of the DevRel like a concert promoter and a session musician rolled into one. The promoter books the venue and warms up the crowd; the session musician can sit in with the band and make the music sound better. In an AI-native SDLC DevRel both amplifies the product and plays alongside developers who adopt it.

Primary responsibilities:

  • Produce demo repositories on GitHub that build with GitHub Actions and deploy to Azure (typically Azure Static Web Apps or Azure Container Apps for live instances)
  • Write tutorials grounded in current Microsoft Learn content, validated by the Microsoft Learn Docs MCP
  • Run the community cadence on GitHub Discussions, surfacing themes to the product team weekly
  • Script and structure recorded sessions, live streams, and conference talks with reusable video briefs
  • Feed community insight into Azure Boards as prioritized product feedback
  • Partner with the Tech Writer to keep tutorials, demos, and reference docs cross-linked
  • Operate the Demo Builder agent and the /demo-script, /tutorial-outline, /video-brief, /community-digest prompts

Jobs to be done

  1. As a DevRel, I want a demo repository scaffolded in minutes from a chosen scenario, so that I record a session the same afternoon.
  2. As a DevRel, I want tutorials that cite current Microsoft Learn pages, so that readers never follow outdated steps.
  3. As a DevRel, I want a weekly digest of GitHub Discussions themes, so that the product team hears what the community is actually asking.
  4. As a DevRel, I want video briefs with time-boxed sections and reproducible code snippets, so that recordings stay tight and editable.
  5. As a DevRel, I want every demo repository covered by GitHub Actions CI, so that viewers can fork and run without hitting stale dependencies.
  6. As a DevRel, I want community contributions acknowledged systematically, so that the best contributors stay engaged.

Pain points before AI-native

  1. Demos that break six weeks later. A demo recorded in January fails in March because a dependency moved. Viewers lose trust.
  2. Tutorials grounded in yesterday’s docs. The tutorial cites a flag that was renamed two releases ago. Readers fork the repo and hit errors.
  3. Community themes invisible to product. The product team hears the three loudest issues and nothing else; the quiet ninety percent of feedback is lost.
  4. Video sessions that drift. Without a structured brief, a twenty-minute demo becomes a fifty-minute monologue.
  5. Contributor recognition ad hoc. Top contributors churn because their work goes unacknowledged.

AI-native daily workflow

The DevRel operates a daily loop. The loop uses GitHub Copilot primitives inside Visual Studio Code, Claude Code at the terminal for long-form scripting, and the Microsoft Learn Docs MCP for grounded tutorials on Azure and Microsoft 365 topics.

Morning setup

  1. Open Visual Studio Code on the devrel repository. GitHub Copilot Chat loads the scoped .github/instructions/devrel.instructions.md.
  2. Invoke /community-digest. The Demo Builder agent reads GitHub Discussions across the org, clusters themes, and drafts a digest in devrel/digests/YYYY-WW.md.
  3. Skim overnight GitHub Actions results on all demo repositories: any red demo is triaged immediately so forkers do not hit broken code.

Midday execution

  1. Build or refresh a demo. Invoke /demo-script <scenario>. The agent scaffolds a repository with a README.md, a GitHub Actions workflow that builds and deploys to Azure Static Web Apps or Azure Container Apps, and a minimal test suite.
  2. Write or update a tutorial. Invoke /tutorial-outline <topic>. The agent produces a section plan grounded in Microsoft Learn content via the Microsoft Learn Docs MCP, with code blocks matching the demo repo.
  3. Pair with a developer from an ambassador program on their own contribution. Claude Code at the terminal drives through the repo and proposes improvements.

Afternoon review

  1. Record or prepare a session. Invoke /video-brief <session>. The agent produces a brief with time-boxed sections, reproducible code snippets, on-screen cues, and a checklist for the editor.
  2. Publish content. GitHub Actions builds the demo, deploys to Azure, and posts a Teams announcement via the M365 Agents SDK when a new tutorial lands.
  3. Close the day by pushing the digest. Product Managers subscribed to the Teams channel receive the digest; high-signal items get created as Azure Boards work items.

Agent

AgentFilePurpose
demo-builder.github/agents/demo-builder.agent.mdScaffold demos, draft tutorials grounded in Microsoft Learn, produce video briefs, synthesize the community digest

The Demo Builder agent uses claude-sonnet-4-6 by default, with tools read, edit, search, grep, glob, bash. It pulls context from GitHub, Microsoft Learn Docs, and Azure MCPs, and uses Playwright MCP to verify that deployed demos run.

Slash prompts

CommandFilePurpose
/demo-script.github/prompts/demo-script.prompt.mdScaffold a demo repository with CI, deploy target, and reproducible steps
/tutorial-outline.github/prompts/tutorial-outline.prompt.mdProduce a tutorial section plan grounded in Microsoft Learn
/video-brief.github/prompts/video-brief.prompt.mdDraft a time-boxed brief for a recorded session with on-screen cues
/community-digest.github/prompts/community-digest.prompt.mdCluster GitHub Discussions themes and draft a digest

Instructions scoped

Scoped applyTo keeps community-facing content distinct from internal docs.

Scope (applyTo)FilePurpose
devrel/demos/**.github/instructions/demos.instructions.mdDemo repo conventions, CI must deploy, README discipline
devrel/tutorials/**.github/instructions/tutorials.instructions.mdTutorial voice, citation of Microsoft Learn sources, accessibility checks
devrel/videos/**.github/instructions/videos.instructions.mdVideo brief format, time-box discipline, on-screen cues

Hooks

Hooks are zero-token governance for community artifacts.

  • pre-commit: reject a tutorial without a citation to a Microsoft Learn or GitHub Docs page when the topic touches Microsoft or GitHub stacks
  • post-commit: trigger a Playwright MCP smoke test against the deployed demo whenever the demo repo changes
  • pre-push: verify that every demo repository has a passing GitHub Actions workflow within the last seven days

Validated MCPs

Every MCP below is registered in the MCP catalog. Do not reference any MCP that is not in the catalog.

MCPStatusUse in this persona
GitHub MCP ServerOfficialManage demo repositories, read Discussions, create issues for community themes
Microsoft Learn Docs MCPOfficialGround tutorials in current Microsoft Learn content for Azure and Microsoft 365 topics
Azure MCP ServerOfficial (Microsoft)Deploy and inspect demo environments on Azure Static Web Apps and Azure Container Apps
Playwright MCPOfficial (Microsoft)Smoke-test deployed demos end-to-end so forkers never land on broken instances
Azure DevOps MCP ServerOfficial (Microsoft)File community-driven feedback as Azure Boards work items when the product team uses Azure Boards
Microsoft 365 Agents SDK MCPOfficial (Microsoft)Announce new tutorials, demos, and digests into Microsoft Teams channels

Real examples

Example 1: demo for a new Azure AI Foundry feature

Input: A new capability ships in Azure AI Foundry; the product team wants a demo in seven days.

Invocation: /demo-script foundry-agent-chat.

Expected output:

  1. A new repository devrel-demos/foundry-agent-chat with a README.md, a working sample, a GitHub Actions workflow that deploys to Azure Container Apps, and a Playwright smoke test.
  2. The tutorial draft devrel/tutorials/foundry-agent-chat.mdx cross-linked to Microsoft Learn pages on Azure AI Foundry, via the Microsoft Learn Docs MCP.
  3. A video brief in devrel/videos/foundry-agent-chat.md with a ten-minute run time, three code-walkthrough sections, and on-screen cues.
  4. A Teams announcement via the M365 Agents SDK to the developer-community channel when the demo deploys successfully.

Example 2: weekly community digest

Input: Over the last seven days, GitHub Discussions saw 42 threads across three repositories.

Invocation: /community-digest.

Expected output:

  1. A digest in devrel/digests/2026-W17.md with three theme clusters: onboarding friction in the CLI, requests for a Terraform provider, confusion about pricing tiers.
  2. Each theme cites at least two representative Discussions links.
  3. For each theme, a proposed Azure Boards work item is drafted for the product team to consider; the DevRel triages before filing.
  4. A Teams post via the M365 Agents SDK summarizing the digest for the product managers who subscribe.

Anti-patterns

  1. Demos without CI. A demo that is not built by GitHub Actions breaks silently. Mitigation: the pre-push hook rejects demos with no green workflow in the last seven days.
  2. Tutorials grounded in memory. Writing from memory is a drift generator. Mitigation: tutorials.instructions.md requires Microsoft Learn citations via the Microsoft Learn Docs MCP.
  3. Community feedback as anecdotes. Sharing one or two loud quotes is not a signal. Mitigation: /community-digest clusters themes with representative links.
  4. Video sessions with no brief. An unbriefed session runs long and edits poorly. Mitigation: /video-brief enforces time-box and on-screen cue discipline.
  5. Contribution recognition ad hoc. Ad hoc thank-you posts miss most contributors. Mitigation: the digest section on contributors pulls merged PRs and accepted Discussions answers from the GitHub MCP.

KPIs and impact metrics

MetricBaseline (manual)Target (agentic)Measurement
Demo build success rate on fork60 percentOver 95 percentGitHub Actions history
Time from product release to demo14 daysUnder 3 daysRelease-to-demo lag
Tutorial citation coverage30 percentOver 90 percentCitation audit
Community themes fed to product per weekZero to oneThree to fiveDigest history
Community-driven Azure Boards items per monthUnder 5Over 20Work-item source label
Token efficiencyN/AUnder 300k tokens per weekCopilot usage report

Maturity in four levels

LevelNameMarkers
L1ManualDemos without CI, tutorials from memory, no community digest
L2AssistedGitHub Copilot Chat for drafting, some demos on GitHub Actions, inconsistent citations
L3AugmentedDemo Builder agent, four slash prompts, scoped instructions, Microsoft Learn Docs MCP grounding, Playwright smoke tests
L4AgenticFull primitives kit, hooks enforced, community themes feeding Azure Boards weekly, demos deployed to Azure with green CI at all times, maturity scorecard above 80 percent

Integration with other personas

  • With Product Owner: community themes influence roadmap negotiations
  • With Tech Writer: tutorials cross-link to reference docs
  • With Developer: demos exercise real APIs and surface friction
  • With Release Manager: release cadence aligns with demo and tutorial publication
  • With UX Designer: tutorial flow and onboarding friction feed UX research
  • With Engineering Manager: community load and ambassador program capacity
  • With InfoSec Officer: demos reviewed for credential hygiene before publication

Glossary

  • Demo repository: a forkable GitHub repository that builds and deploys on Azure, covered by CI and Playwright smoke tests.
  • Tutorial: a step-by-step guide grounded in current Microsoft Learn content and cross-linked to a demo.
  • Community digest: a weekly synthesis of GitHub Discussions themes, with representative links and proposed product-feedback items.
  • Video brief: a structured outline for a recorded session, with time-boxed sections, on-screen cues, and reproducible code snippets.
  • Ambassador program: a structured engagement with external community contributors who champion the product.
  • Citation discipline: the rule that tutorials on Microsoft or GitHub topics cite current Microsoft Learn or GitHub Docs pages.

References

O DevRel é a persona responsável pela experiência do desenvolvedor fora do time principal: tutoriais, repositórios de demo, conversas com a comunidade e loops de feedback de volta para o produto. Em um SDLC AI-nativo, DevRel opera um pipeline de conteúdo e comunidade, não um calendário de eventos.

Resumo executivo

DevRel transforma capacidade do produto em proficiência da comunidade. Em um SDLC AI-nativo, DevRel trabalha dentro da fase de Comunidade com um conjunto fixo de primitivas: um agente Demo Builder, quatro slash prompts, instruções com escopo, hooks validados por schema e uma lista curada de MCPs validados. As saídas primárias são repositórios de demo reproduzíveis no GitHub, tutoriais publicados no estilo do Microsoft Learn, briefs de vídeo para sessões gravadas e um resumo regular da comunidade que alimenta tanto leitores externos quanto o time de produto.

Papel e responsabilidades

Pense no DevRel como um promotor de shows e um músico de estúdio em uma pessoa só. O promotor reserva o local e esquenta a plateia; o músico de estúdio pode sentar com a banda e fazer a música soar melhor. Em um SDLC AI-nativo, DevRel tanto amplifica o produto quanto toca ao lado dos desenvolvedores que o adotam.

Responsabilidades primárias:

  • Produzir repositórios de demo no GitHub que fazem build com GitHub Actions e deployam no Azure (tipicamente Azure Static Web Apps ou Azure Container Apps para instâncias em produção)
  • Escrever tutoriais fundamentados em conteúdo atual do Microsoft Learn, validados pelo Microsoft Learn Docs MCP
  • Rodar a cadência da comunidade no GitHub Discussions, surfando temas para o time de produto semanalmente
  • Criar scripts e estruturar sessões gravadas, livestreams e palestras de conferência com briefs de vídeo reutilizáveis
  • Alimentar insights da comunidade no Azure Boards como feedback de produto priorizado
  • Parceria com o Tech Writer para manter tutoriais, demos e docs de referência interligados
  • Operar o agente Demo Builder e os prompts /demo-script, /tutorial-outline, /video-brief, /community-digest

Jobs to be done

  1. Como DevRel, eu quero um repositório de demo criado em minutos a partir de um cenário escolhido, para que eu grave uma sessão na mesma tarde.
  2. Como DevRel, eu quero tutoriais que citam páginas atuais do Microsoft Learn, para que leitores nunca sigam passos desatualizados.
  3. Como DevRel, eu quero um resumo semanal de temas do GitHub Discussions, para que o time de produto ouça o que a comunidade está realmente perguntando.
  4. Como DevRel, eu quero briefs de vídeo com seções com tempo limitado e trechos de código reproduzíveis, para que gravações fiquem concisas e editáveis.
  5. Como DevRel, eu quero cada repositório de demo coberto pelo CI do GitHub Actions, para que espectadores possam fazer fork e rodar sem encontrar dependências obsoletas.
  6. Como DevRel, eu quero contribuições da comunidade reconhecidas sistematicamente, para que os melhores contribuidores continuem engajados.

Dores antes do AI-nativo

  1. Demos que quebram seis semanas depois. Uma demo gravada em janeiro falha em março porque uma dependência mudou. Espectadores perdem confiança.
  2. Tutoriais fundamentados em docs de ontem. O tutorial cita uma flag que foi renomeada duas releases atrás. Leitores fazem fork do repo e encontram erros.
  3. Temas da comunidade invisíveis para o produto. O time de produto ouve os três problemas mais barulhentos e nada mais; os 90 por cento silenciosos de feedback são perdidos.
  4. Sessões de vídeo que se dispersam. Sem um brief estruturado, uma demo de vinte minutos se torna um monólogo de cinquenta minutos.
  5. Reconhecimento de contribuidores ad hoc. Contribuidores top desistem porque seu trabalho passa despercebido.

Fluxo diário AI-nativo

O DevRel opera um loop diário. O loop usa primitivas do GitHub Copilot dentro do Visual Studio Code, Claude Code no terminal para scripts de longa duração e o Microsoft Learn Docs MCP para tutoriais fundamentados em tópicos Azure e Microsoft 365.

Setup da manhã

  1. Abra o Visual Studio Code no repositório devrel. GitHub Copilot Chat carrega as instruções com escopo .github/instructions/devrel.instructions.md.
  2. Invoque /community-digest. O agente Demo Builder lê GitHub Discussions em toda a org, agrupa temas e redige um resumo em devrel/digests/YYYY-WW.md.
  3. Percorra os resultados noturnos do GitHub Actions em todos os repositórios de demo: qualquer demo vermelha é triada imediatamente para que forks não encontrem código quebrado.

Execução no meio do dia

  1. Construa ou atualize uma demo. Invoque /demo-script <cenário>. O agente cria o scaffold de um repositório com um README.md, um workflow do GitHub Actions que faz build e deploya no Azure Static Web Apps ou Azure Container Apps, e uma suíte mínima de testes.
  2. Escreva ou atualize um tutorial. Invoque /tutorial-outline <tópico>. O agente produz um plano de seções fundamentado em conteúdo do Microsoft Learn via o Microsoft Learn Docs MCP, com blocos de código correspondendo ao repo de demo.
  3. Pareie com um developer de um programa de embaixadores em sua própria contribuição. Claude Code no terminal navega pelo repo e propõe melhorias.

Revisão no fim da tarde

  1. Grave ou prepare uma sessão. Invoque /video-brief <sessão>. O agente produz um brief com seções com tempo limitado, trechos de código reproduzíveis, cues na tela e um checklist para o editor.
  2. Publique conteúdo. GitHub Actions faz build da demo, deploya no Azure e posta um anúncio no Teams via o M365 Agents SDK quando um novo tutorial aterrissa.
  3. Feche o dia dando push no resumo. Product Managers inscritos no canal do Teams recebem o resumo; itens de alto sinal são criados como work items do Azure Boards.

Primitivas recomendadas

Agente

AgenteArquivoPropósito
demo-builder.github/agents/demo-builder.agent.mdCriar scaffold de demos, redigir tutoriais fundamentados no Microsoft Learn, produzir briefs de vídeo, sintetizar o resumo da comunidade

O agente Demo Builder usa claude-sonnet-4-6 por padrão, com ferramentas read, edit, search, grep, glob, bash. Puxa contexto dos MCPs GitHub, Microsoft Learn Docs e Azure, e usa o Playwright MCP para verificar que demos deployadas rodam.

Slash prompts

ComandoArquivoPropósito
/demo-script.github/prompts/demo-script.prompt.mdCriar scaffold de um repositório de demo com CI, target de deploy e passos reproduzíveis
/tutorial-outline.github/prompts/tutorial-outline.prompt.mdProduzir um plano de seções de tutorial fundamentado no Microsoft Learn
/video-brief.github/prompts/video-brief.prompt.mdRedigir um brief com tempo limitado para sessão gravada com cues na tela
/community-digest.github/prompts/community-digest.prompt.mdAgrupar temas do GitHub Discussions e redigir um resumo

Instruções com escopo

applyTo com escopo mantém conteúdo voltado à comunidade distinto de docs internos.

Escopo (applyTo)ArquivoPropósito
devrel/demos/**.github/instructions/demos.instructions.mdConvenções de repo de demo, CI deve deployar, disciplina de README
devrel/tutorials/**.github/instructions/tutorials.instructions.mdVoz de tutorial, citação de fontes do Microsoft Learn, verificações de acessibilidade
devrel/videos/**.github/instructions/videos.instructions.mdFormato de brief de vídeo, disciplina de tempo limitado, cues na tela

Hooks

Hooks são governança de zero tokens para artefatos da comunidade.

  • pre-commit: rejeitar um tutorial sem citação a uma página do Microsoft Learn ou GitHub Docs quando o tópico toca stacks Microsoft ou GitHub
  • post-commit: disparar um smoke test do Playwright MCP contra a demo deployada sempre que o repo de demo mudar
  • pre-push: verificar que cada repositório de demo tem um workflow do GitHub Actions passando nos últimos sete dias

MCPs validados

Todo MCP abaixo está registrado no catálogo de MCPs. Não referencie nenhum MCP que não esteja no catálogo.

MCPStatusUso nesta persona
GitHub MCP ServerOficialGerenciar repositórios de demo, ler Discussions, criar issues para temas da comunidade
Microsoft Learn Docs MCPOficialFundamentar tutoriais em conteúdo atual do Microsoft Learn para tópicos Azure e Microsoft 365
Azure MCP ServerOficial (Microsoft)Deployar e inspecionar ambientes de demo no Azure Static Web Apps e Azure Container Apps
Playwright MCPOficial (Microsoft)Smoke-test de demos deployadas ponta a ponta para que forks nunca aterrissem em instâncias quebradas
Azure DevOps MCP ServerOficial (Microsoft)Registrar feedback direcionado pela comunidade como work items do Azure Boards quando o time de produto usa Azure Boards
Microsoft 365 Agents SDK MCPOficial (Microsoft)Anunciar novos tutoriais, demos e resumos em canais do Microsoft Teams

Exemplos reais

Exemplo 1: demo para uma nova feature do Azure AI Foundry

Entrada: Uma nova capacidade é entregue no Azure AI Foundry; o time de produto quer uma demo em sete dias.

Invocação: /demo-script foundry-agent-chat.

Saída esperada:

  1. Um novo repositório devrel-demos/foundry-agent-chat com um README.md, um sample funcional, um workflow do GitHub Actions que deploya no Azure Container Apps e um smoke test do Playwright.
  2. O rascunho do tutorial devrel/tutorials/foundry-agent-chat.mdx interligado a páginas do Microsoft Learn sobre Azure AI Foundry, via o Microsoft Learn Docs MCP.
  3. Um brief de vídeo em devrel/videos/foundry-agent-chat.md com tempo de execução de dez minutos, três seções de walkthrough de código e cues na tela.
  4. Um anúncio no Teams via o M365 Agents SDK para o canal da comunidade de desenvolvedores quando a demo deploya com sucesso.

Exemplo 2: resumo semanal da comunidade

Entrada: Nos últimos sete dias, GitHub Discussions teve 42 threads em três repositórios.

Invocação: /community-digest.

Saída esperada:

  1. Um resumo em devrel/digests/2026-W17.md com três clusters de temas: fricção de onboarding no CLI, solicitações de um provider Terraform, confusão sobre tiers de preço.
  2. Cada tema cita pelo menos dois links representativos de Discussions.
  3. Para cada tema, um work item proposto do Azure Boards é rascunhado para o time de produto considerar; o DevRel tria antes de registrar.
  4. Um post no Teams via o M365 Agents SDK resumindo o digest para os product managers inscritos.

Anti-padrões

  1. Demos sem CI. Uma demo que não é construída pelo GitHub Actions quebra silenciosamente. Mitigação: o hook pre-push rejeita demos sem workflow verde nos últimos sete dias.
  2. Tutoriais fundamentados em memória. Escrever de memória é um gerador de drift. Mitigação: tutorials.instructions.md exige citações do Microsoft Learn via o Microsoft Learn Docs MCP.
  3. Feedback da comunidade como anedotas. Compartilhar uma ou duas citações barulhentas não é um sinal. Mitigação: /community-digest agrupa temas com links representativos.
  4. Sessões de vídeo sem brief. Uma sessão sem brief fica longa e edita mal. Mitigação: /video-brief enforça disciplina de tempo limitado e cues na tela.
  5. Reconhecimento de contribuições ad hoc. Posts de agradecimento ad hoc perdem a maioria dos contribuidores. Mitigação: a seção de contribuidores do resumo puxa PRs merged e respostas aceitas de Discussions do GitHub MCP.

KPIs e métricas de impacto

MétricaLinha base (manual)Meta (agêntico)Medição
Taxa de sucesso de build de demo no fork60 por centoMais de 95 por centoHistórico do GitHub Actions
Tempo do release do produto à demo14 diasMenos de 3 diasDefasagem release-para-demo
Cobertura de citações em tutoriais30 por centoMais de 90 por centoAuditoria de citações
Temas da comunidade alimentados ao produto por semanaZero a umTrês a cincoHistórico de resumos
Itens do Azure Boards direcionados pela comunidade por mêsMenos de 5Mais de 20Rótulo de fonte do work item
Eficiência de tokensN/AMenos de 300k tokens por semanaRelatório de uso do Copilot

Maturidade em quatro níveis

NívelNomeMarcadores
L1ManualDemos sem CI, tutoriais de memória, sem resumo da comunidade
L2AssistidoGitHub Copilot Chat para redação, algumas demos no GitHub Actions, citações inconsistentes
L3AumentadoAgente Demo Builder, quatro slash prompts, instruções com escopo, fundamentação do Microsoft Learn Docs MCP, smoke tests do Playwright
L4AgênticoKit completo de primitivas, hooks enforçados, temas da comunidade alimentando Azure Boards semanalmente, demos deployadas no Azure com CI verde em todos os momentos, scorecard de maturidade acima de 80 por cento

Integração com outras personas

  • Com o Product Owner: temas da comunidade influenciam negociações de roadmap
  • Com o Tech Writer: tutoriais fazem cross-link para docs de referência
  • Com o Developer: demos exercitam APIs reais e surfam fricção
  • Com o Release Manager: cadência de release alinhada com publicação de demos e tutoriais
  • Com o UX Designer: fluxo de tutorial e fricção de onboarding alimentam pesquisa de UX
  • Com o Engineering Manager: carga da comunidade e capacidade do programa de embaixadores
  • Com o InfoSec Officer: demos revisadas para higiene de credenciais antes da publicação

Glossário

  • Repositório de demo: um repositório GitHub forkável que faz build e deploya no Azure, coberto por CI e smoke tests do Playwright.
  • Tutorial: um guia passo a passo fundamentado em conteúdo atual do Microsoft Learn e interligado a uma demo.
  • Resumo da comunidade: uma síntese semanal de temas do GitHub Discussions, com links representativos e itens propostos de feedback de produto.
  • Brief de vídeo: um outline estruturado para uma sessão gravada, com seções com tempo limitado, cues na tela e trechos de código reproduzíveis.
  • Programa de embaixadores: um engajamento estruturado com contribuidores externos da comunidade que promovem o produto.
  • Disciplina de citação: a regra de que tutoriais sobre tópicos Microsoft ou GitHub citem páginas atuais do Microsoft Learn ou GitHub Docs.

Referências

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

Paula Silva | Software Global Black Belt

Start with the platform, not the agents. Comece pela plataforma, não pelos agentes. Comience por la plataforma, no por los agentes.

Building the future of software development with AI and Agentic DevOps.

Knowledge Hub · v3.4.0 · 2026-06-17
Back to the hubVoltar ao hubVolver al hubKnowledge HubKnowledge HubKnowledge Hub
ConnectConectarConectarin/paulanunes
paulasilva · 2026-06-17 EN · PT-BR · ES