Crea una guida di onboarding a Devin specifica per il team

Non vuoi configurarlo manualmente? Incolla un collegamento a questa pagina in una sessione di Devin e chiedigli di impostare tutto per te.

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.

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:

# Iniziare con Devin — Team Engineering di Acme

## 1. Avviare una Sessione
| Metodo | Quando usarlo | Esempio |
|--------|-------------|--------|
| **Slack** — scrivi a @Devin | Attività rapide e circoscritte | "Fix the failing CI in api-service" |
| **Web app** — app.devin.ai | Attività più lunghe che richiedono allegati o playbook | Allega un playbook di migrazione + file spec |

## 2. Scrivere Prompt Efficaci
Devin funziona meglio con richieste specifiche e circoscritte. Includi sempre
il percorso del file, cosa non funziona e quando è iniziato il problema.

❌ "Correggi il bug del login"
✅ "Il form di login in src/pages/Login.tsx restituisce un 401 per credenziali
   valide dalla rotazione della chiave JWT di venerdì. Controlla il
   middleware di autenticazione in src/middleware/auth.ts."

## 3. Integrazione con Linear
Vai su Impostazioni > Connessioni > Linear e autorizza. Una volta
connesso, Devin può:
- Prendere in carico automaticamente i ticket assegnati
- Aggiornare lo stato del ticket mentre lavora
- Collegare le PR al ticket Linear di origine

Consulta la guida completa: docs.devin.ai/integrations/linear

## 4. Playbook per Attività Ricorrenti
Crea prompt riutilizzabili in Impostazioni > Playbook > Crea Nuovo.
Per la nostra migrazione da Express a Fastify, il playbook dovrebbe includere:
- Il percorso del modulo di destinazione (es. src/services/payments/)
- Comandi di test: npm run test:api && npm run test:integration
- Passaggi di rollback se la migrazione interrompe i consumer a valle

## 5. Knowledge — Insegnare a Devin le Nostre Convenzioni
Aggiungi le convenzioni del team in Impostazioni > Knowledge > Aggiungi Knowledge.

Esempio di voce:
  Trigger: "working on API routes"
  Contenuto: "Usiamo Fastify, non Express. Tutte le route si trovano in
  src/routes/. Esegui npm run test:api prima di fare il commit.
  Le risposte di errore devono usare la classe ApiError da src/lib/errors.ts."

Amplia la guida con i follow-up

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

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:

Condividi la guida — incolla la pagina Notion nel tuo canale #engineering oppure mettila in evidenza nella wiki del tuo team
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.”