MyDocs

Una raccolta di principi, regole e processi sullo sviluppo software. Non descrive un progetto specifico né le convenzioni di un team particolare — descrive un punto di vista su come si scrive software manutenibile, testabile e comprensibile nel tempo.

È un punto di vista parziale e opinabile, come qualsiasi approccio allo sviluppo. Ma è coerente: ogni regola deriva da principi espliciti, ogni processo ha una motivazione dichiarata.

La documentazione vive nel repository perché non esiste documentazione utile che sia separata dal codice. Quando il codice cambia, la documentazione cambia con lui — nello stesso commit, con la stessa storia. L'IA legge entrambi e li tiene sincronizzati.

Come è organizzata

Regole — principi e vincoli permanenti. Cambiano raramente e hanno impatto trasversale: dominio, architettura, testing, git, logging, autenticazione, configurazione. Sono il perché dietro le scelte tecniche.

Processi — come si lavora. Dall'analisi tecnica allo sviluppo, dalla pipeline CI/CD al rilascio. Descrivono il flusso di lavoro e possono evolversi nel tempo.

Glossario — i termini tecnici e di dominio usati nella documentazione e nel codice.

Uso con IA — come integrare questa guida in un progetto come knowledge base per gli agenti IA.

Da dove iniziare

Per capire la filosofia di fondo: Principi.

Per iniziare uno sviluppo: Analisi Tecnica → Sviluppo.

Per integrare MyDocs in un progetto reale: Uso con IA.