Skip to main content

Gerar um Guia de Onboarding do Devin Específico para a Equipe

Devin lê sua própria documentação e gera um guia de primeiros passos personalizado para a stack, integrações e fluxos de trabalho da sua equipe — pronto para compartilhar no Notion ou no Slack.
AuthorCognition
CategoryOtimização do Devin
FeaturesMCP
1

Peça ao Devin que gere seu guia

Devin tem acesso integrado à sua própria documentação por meio do Devin Docs MCP — sem necessidade de setup ou configuração. Ele pode pesquisar e ler todo o site de documentação, referência de API, changelog e boas práticas sob demanda.Em vez de enviar a novos engenheiros uma lista de links de documentação, peça para Devin sintetizar exatamente o que sua equipe precisa em um único guia de onboarding com prompts, fluxos de trabalho e exemplos adaptados ao seu stack.
2

Revise o guia gerado

Devin pesquisa em sua documentação para cada tópico, lê as páginas relevantes e gera um guia de onboarding completo, adaptado ao seu stack e fluxo de trabalho. Veja como fica o resultado:
# Getting Started with Devin — Acme Engineering Team

## 1. Starting a Session
| Method | When to use | Example |
|--------|-------------|--------|
| **Slack** — message @Devin | Quick, scoped tasks | "Fix the failing CI in api-service" |
| **Web app** — app.devin.ai | Longer tasks needing file attachments or playbooks | Attach a migration playbook + spec file |

## 2. Writing Effective Prompts
Devin works best with specific, scoped requests. Always include
the file path, what's broken, and when it started.

❌ "Fix the login bug"
✅ "The login form at src/pages/Login.tsx returns a 401 for valid
   credentials since the JWT key rotation on Friday. Check the
   auth middleware at src/middleware/auth.ts."

## 3. Linear Integration
Go to Settings > Integrations > Linear and authorize. Once
connected, Devin can:
- Pick up tickets assigned to it automatically
- Update ticket status as it works
- Link PRs to the originating Linear ticket

See the full setup guide: docs.devin.ai/integrations/linear

## 4. Playbooks for Recurring Tasks
Create reusable prompts at Settings > Playbooks > Create New.
For our Express-to-Fastify migration, the playbook should include:
- The target module path (e.g., src/services/payments/)
- Test commands: npm run test:api && npm run test:integration
- Rollback steps if the migration breaks downstream consumers

## 5. Knowledge — Teaching Devin Our Conventions
Add team conventions at Settings > Knowledge > Add Knowledge.

Example entry:
  Trigger: "working on API routes"
  Content: "We use Fastify, not Express. All routes live in
  src/routes/. Run npm run test:api before committing.
  Error responses must use the ApiError class from src/lib/errors.ts."
3

Complete o guia com etapas de acompanhamento

Mantenha a mesma sessão aberta — Devin mantém o contexto e pode estender o guia com seções adicionais.
4

Compartilhe este guia e mantenha-o sempre atualizado

Quando o guia estiver pronto, compartilhe-o e salve-o como Knowledge para que o próprio Devin possa consultar as convenções da sua equipe:
  1. Compartilhe o guia — cole a página do Notion no canal #engineering ou fixe-a no wiki da sua equipe
  2. Salve-o como Knowledge — acesse Settings > Knowledge > Add Knowledge, defina o gatilho como "onboarding new team members to Devin", cole o conteúdo do guia e fixe-o em all repositories
Agora, quando qualquer membro da equipe perguntar ao Devin “how should I write prompts?” ou “how do I connect Linear?”, ele usará o seu guia personalizado — não a documentação genérica.À medida que o Devin lançar novos recursos, peça para que ele atualize o guia no mesmo formato de sessão: “Read the latest changelog and update our onboarding guide with any new features that affect our workflows.”