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

DevRel

Tutoriais, demos, comunidade.

Atualizado: 2026-04-24 14 seções Baixar .zip

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