La conoscenza tribale è il killer silenzioso della scalabilità. Quando un processo critico esiste solo nella testa di Marco, e Marco è in ferie o (peggio) si dimette, l'azienda si ferma.
Ho visto startup da 50 persone dove l'unico modo per fare un deploy era chiamare Andrea su Slack. Ho visto aziende enterprise con reparti IT paralizzati perché "chi lo sapeva è andato via l'anno scorso".
Il problema non è la mancanza di documentazione. Il problema è che la documentazione tradizionale (wiki aziendali, documenti Google, manuali di processo) è troppo lenta per stare al passo con la realtà.
La Regola del 5 Minuti
Ho sviluppato un approccio che chiamo "la regola del 5 minuti": se un'informazione operativa ti ha richiesto più di 5 minuti per essere scoperta o capita, merita di essere documentata.
Non un manuale di 50 pagine. Non una procedura formale. Una nota. Un paragrafo. Una checklist. Lo standard è: abbastanza buono perché qualcun altro possa eseguire senza chiamarti.
Esempi:
- "Come si fa un deploy su staging" → 3 righe in una nota Obsidian condivisa
- "Chi approva le spese sopra €500" → una riga in un file README
- "A chi chiedere per accessi AWS" → un bullet point in un documento Google
Il Framework DOC
Per ogni processo operativo, applico il framework DOC:
- Definizione: qual è l'input, qual è l'output, chi è il responsabile
- Operazione: i passaggi per eseguire (massimo 10 bullet point)
- Contesto: perché si fa così, cosa può andare storto, chi contattare
Un processo DOC occupa mezza pagina. Si legge in 2 minuti. Si aggiorna in 5. E se qualcuno se ne va, chiunque può prenderlo in carico.
Come Iniziare
Il modo peggiore per affrontare la documentazione è "questo venerdì scriviamo tutto". Non funziona mai. Invece:
- Identifica i processi che fanno male. Quando qualcuno chiede "come si fa X?" su Slack per la terza volta, quel processo è candidato.
- Scrivi mentre risolvi. La prossima volta che spieghi un processo a qualcuno, scrivilo subito invece di spiegarlo a voce. Tempo investito: 5 minuti. Tempo risparmiato: 30 minuti ogni volta che qualcuno lo chiede.
- Usa un posto solo. Tutta la documentazione operativa in un unico posto (Obsidian, Notion, Google Drive). Se è sparsa in 5 tool, è come se non esistesse.
- Coltiva l'abitudine, non la perfezione. La documentazione perfetta non esiste. Quella buona è molto meglio di niente.
Il Vero Costo della Non-Documentazione
Ogni volta che un membro del team chiede "come si fa X?" e qualcuno glielo spiega, l'azienda ha pagato due stipendi per trasferire conoscenza che poteva essere già scritta.
Ogni volta che un nuovo assunto passa 3 settimane invece di 1 per diventare produttivo, la differenza sono processi non documentati.
Ogni volta che un dipendente chiave dà le dimissioni e lascia un vuoto di 3 mesi, il costo non è solo il recruitment — è la conoscenza che se ne va con lui.
Documentare non è burocrazia. È un investimento con ritorno misurable.