Ti faccio annoiare con una singola parola. Documentazione. Ce l’ho fatta? :D Tutti vorrebbero leggera, nessuno vuole scriverla. Nel pieno boom dell’agentic coding vedo tanto focus sulla produzione del codice e molto poco sulla manutenzione di requisiti, specifiche o documentazione in generale.
Nei progetti di business, quelli veri, non i simpatici e tool che si creano in una manciata di giorni di agentic-coding dove basta un README.md con una simpatica ASCII art sulla struttura della cartelle e poco più, ci sono scelte architetturali importanti, contesto, storia…
Quello che vedo nei #team di sviluppo è che gli strumenti di documentazione vengono spesso sperimentati, provati e poi… abbandonati. Non c’è mai tempo per sistemare (aka non ne abbiamo la cultura e la priorità non è percepita). Non c’è uno standard per scrivere user story / feature / progetti…
Allora, visto che passiamo tanto tempo a discutere con colleghi (umani e non) perché non rendere utili quelle conversazioni e renderle reperibili in strumenti che anche le AI sanno consultare?
Il primo che mi viene in mente sono le #wiki di Azure DevOps. Tramite il server MCP di AzDO possiamo interagire, sia in lettura che in scrittura, con le wiki e documentare: scelte progettuali, riassunti di conversazioni con le AI su questioni di design, processi di on-boarding…
Ho in mente un po’ di idee al riguardo e ci farò un video.
Azioni
Hai mai sperimentato con la documentazione potenziata da / con / per gli agenti? Cosa ne pensi?