Skip to main content

Genera una guida di onboarding a Devin specifica per il team

Devin legge la propria documentazione e genera una guida introduttiva personalizzata per lo stack, le integrazioni e i flussi di lavoro del tuo team — pronta da condividere in Notion o Slack.
AuthorCognition
CategoryOttimizzazione di Devin
FeaturesMCP
1

Chiedi a Devin di generare la guida

Devin ha accesso integrato alla propria documentazione tramite il Devin Docs MCP — non è necessario alcun setup o configurazione. Può cercare e leggere su richiesta l’intero sito di documentazione, la reference delle API, il changelog e le best practice.Invece di inviare ai nuovi ingegneri un elenco di link alla documentazione, chiedi a Devin di sintetizzare esattamente ciò di cui il tuo team ha bisogno in un’unica guida di onboarding con prompt, flussi di lavoro ed esempi personalizzati per il tuo stack.
2

Esamina la guida generata

Devin effettua ricerche nella propria documentazione per ogni argomento, legge le pagine rilevanti e sintetizza una guida di onboarding completa, personalizzata per il tuo stack e il tuo flusso di lavoro. Ecco come si presenta l’output:
# 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

Amplia la guida con i follow-up

Mantieni aperta la stessa sessione — Devin conserva il contesto e può estendere la guida con sezioni aggiuntive.
4

Condividi la guida e tienila aggiornata

Una volta che la guida ti sembra valida, condividila e salvala come Knowledge così che Devin possa fare riferimento alle convenzioni del tuo team:
  1. Condividi la guida — incolla la pagina Notion nel tuo canale #engineering oppure mettila in evidenza nella wiki del tuo team
  2. Salvala come Knowledge — vai su Settings > Knowledge > Add Knowledge, imposta il trigger su "onboarding new team members to Devin", incolla il contenuto della guida e fissala in tutti i repository
Ora, quando un membro del team chiede a Devin “come dovrei scrivere i prompt?” oppure “come collego Linear?”, Devin attinge dalla tua guida personalizzata — non da documentazione generica.Man mano che Devin rilascia nuove funzionalità, chiedigli di aggiornare la guida nello stesso formato di sessione: “Leggi l’ultimo changelog e aggiorna la nostra guida di onboarding con tutte le nuove funzionalità che influiscono sui nostri workflow.”