- Yempik fa girare la propria azienda sul suo company brain di file: circa 137 file markdown con decisioni, stato dei progetti, regole e domande aperte.
- Quei file non vivono dentro uno strumento: stanno sul nostro computer e nel controllo di versione, leggibili da noi e da Claude, aggiornati per abitudine.
- Sulla scala di maturità L0-L4 siamo a L4: gli agenti lavorano sul brain e lo tengono fresco. L’azienda opera da lì, non dalla testa di chi c’è quel giorno.
- La struttura è la stessa che diamo gratis con cowork-os: open source, copiabile, zero lock-in. Il metodo che vendiamo è quello che usiamo.
Non lo raccontiamo in teoria: lo usiamo tutti i giorni
È facile scrivere di company brain senza averne uno. Noi abbiamo fatto il contrario: prima l’abbiamo costruito per Yempik, poi ne abbiamo tirato fuori il metodo. Oggi la nostra azienda gira su circa 137 file markdown che tengono tutto quello che serve per lavorare: cosa abbiamo deciso e perché, a che punto è ogni progetto, quali regole seguiamo, cosa è ancora aperto. Quando iniziamo una sessione con Claude, non ripartiamo da zero: il contesto è già lì, scritto.
Non sono file sparsi in un drive. Sono un posto solo, strutturato, sul nostro computer e nel controllo di versione, dove ogni decisione ha una data e una motivazione, e ogni progetto ha uno stato che aggiorniamo per abitudine. La differenza rispetto a «lo teniamo a mente» è che il sapere non dipende più da chi c’è in ufficio quel giorno: è leggibile da chiunque, e da Claude.
Prima di venderlo agli altri, il company brain su file lo usiamo noi. Yempik gira su 137 file: non è una metafora, è dove viviamo il lavoro.
Decisioni, stato, regole, domande aperte
La struttura non l’abbiamo inventata per l’occasione: è la stessa che rilasciamo gratis con il kit open source cowork-os[1]. Cartelle per il contesto, le decisioni, il marketing, il sito, le review, con un esempio già compilato da cui partire. I 137 file di Yempik sono questa struttura riempita di verità: il nostro decision log, i nostri stati di progetto, le regole con cui lavoriamo, il glossario dei nostri termini.
Più le istruzioni, le automazioni delle routine e un esempio reale già compilato da cui copiare.
Il numero cresce ogni settimana, perché il brain non è un archivio da riempire una volta: è un contesto che si aggiorna a fine di ogni attività. Quando chiudiamo un task, annotiamo cosa è cambiato nel file giusto, così la settimana dopo Claude e il team sanno qualcosa in più. Non è disciplina eroica: è una routine, e i 137 file di oggi saranno di più il mese prossimo.
Sulla scala L0-L4 siamo in cima, e sappiamo cosa vuol dire
La scala di maturità del company brain va da L0, quando tutto vive nelle teste e nelle chat, a L4, quando gli agenti fanno girare il lavoro sul brain e lo tengono fresco. Yempik è a L4, e lo diciamo senza trionfalismo: significa che gli agenti leggono i file, ci lavorano sopra e li aggiornano, e che l’azienda opera da quel contesto. Non è un traguardo che ci rende speciali, è la conseguenza logica di aver messo il metodo prima del prodotto.
Ci teniamo a essere onesti su cosa questo vuol dire e cosa no: L4 non è magia, è una routine tenuta viva ogni giorno, e sotto c’è lo stesso lavoro noioso di scrivere decisioni e stati che chiediamo ai clienti. Se vuoi capire dove sei tu sulla stessa scala, fai l’auto-diagnosi in 2 minuti: dà un nome al tuo livello e indica il passo dopo.
Il nostro brain è su file nostri, e la struttura è di tutti
C’è una ragione per cui possiamo raccontare tutto questo senza reticenze: non c’è un segreto da proteggere. La struttura del nostro company brain è pubblica, è il repository open source cowork-os[1], e chiunque può copiarla e riempirla con la propria azienda. I nostri 137 file di contenuto restano nostri e privati, ma l’impianto è di tutti. Nessun vendor in mezzo, nessun formato proprietario, nessun lock-in: se domani cambiamo strumento, il brain viene con noi perché è solo testo che possediamo.
È la stessa cosa che promettiamo a chi lavora con noi, e la prova che non è marketing: il metodo che vendiamo è quello con cui facciamo girare la nostra azienda. Il come si costruisce, passo per passo, con interviste, trascrizione e validazione, l’abbiamo scritto qui: come costruire un company brain su file. Se invece vuoi che lo mettiamo in piedi noi, con il tuo processo e il codice che resta tuo, guarda gli agenti AI per aziende, con codice tuo.
Il caso Yempik, in pratica
Yempik usa davvero un company brain su file?
Sì. Facciamo girare la nostra azienda su circa 137 file markdown che tengono decisioni, stato dei progetti, regole operative e domande aperte, sul nostro computer e nel controllo di versione, non dentro un vendor. Il metodo che vendiamo ai clienti è lo stesso che usiamo per noi: prima l’abbiamo costruito per Yempik, poi ne abbiamo tirato fuori il prodotto.
Cosa vuol dire essere a L4 sulla scala di maturità?
Vuol dire che gli agenti leggono i file del company brain, ci lavorano sopra e li tengono aggiornati, e che l’azienda opera da quel contesto invece che dalla testa di chi c’è quel giorno. Non è magia: sotto c’è una routine tenuta viva ogni giorno, lo stesso lavoro di scrivere decisioni e stati che chiediamo ai clienti. È il livello più alto della scala L0-L4.
Perché proprio 137 file, e cosa contengono?
È il conteggio reale del nostro workspace al momento della pubblicazione, e cresce ogni settimana perché il brain si aggiorna a fine di ogni attività. I file contengono il decision log, gli stati dei progetti, le regole operative, il glossario e le domande aperte, nella struttura del kit open source cowork-os riempita con la nostra azienda. Non citiamo altri numeri: questo è l’unico dato, ed è vero.
C’è lock-in nel vostro company brain?
No. Il brain è solo testo su file che possediamo, e la struttura è pubblica nel repository open source cowork-os, copiabile da chiunque. Non c’è un vendor in mezzo né un formato proprietario: se cambiamo strumento, il contesto viene con noi. È esattamente la promessa che facciamo a chi lavora con noi, e la ragione per cui possiamo raccontare tutto senza reticenze.
Fonti
- [1]cowork-os, repository open source di Yempik. github.com
Questa pagina è scritta da Raffaele Zarrelli e Simone Bova, founder di Yempik, con editing fatto con Claude. Il company brain e il suo maturity model sono modelli editoriali di Yempik. Il numero di circa 137 file è il conteggio reale del nostro workspace al momento della pubblicazione e cresce nel tempo; non citiamo altri numeri. Il kit citato è il nostro open source cowork-os (licenza MIT).
Vuoi far girare la tua azienda su un brain come il nostro?
Partiamo dal tuo processo, non dallo strumento. Ti aiutiamo a mettere decisioni, stato e regole su file tuoi, governati, con la stessa struttura open source che usiamo per noi. Prezzo e tempi fissi, il codice è tuo.