Migrato su formray.io/blog.
Software Engineering 3.0 è diventato l'imprint editoriale del blog di Formray. Tutti i contenuti — dispense, articoli e guide — vivono ora su formray.io/blog con gli stessi slug (
/blog/dispense/…,/blog/articles/…,/blog/guides/…).Questo repository è archiviato: GitHub Pages continua a servire una shell di redirect permanenti verso i nuovi URL (
npm run build→scripts/build-redirect-shell.mjs). La build Astro originale resta disponibile comenpm run build:astro.
Dispense, articoli e guide sul mondo dello sviluppo software nell'era dell'AI. In italiano.
npm install # Installa dipendenze
npm run dev # Avvia server locale (localhost:4321)
npm run build # Genera sito statico in dist/ (build + indice Pagefind)
npm run preview # Preview build di produzionesrc/
├── content/
│ ├── dispense/ # Serie Dispense AI Engineering (numerata, in ordine di lettura)
│ ├── articles/ # Fondamenta e Analisi puntuali (campo `section`)
│ └── guides/ # Guide tecniche
├── pages/ # Route Astro (/, /dispense/, /articles/, /guides/)
├── layouts/ # BaseLayout (chrome del sito) e ArticleLayout (lettura)
├── components/ # Componenti Astro (InfoBox, ProsCons, Card, TOC, …)
└── styles/ # Design system (global.css, light-only)
setup/ # File automazione Claude Code
legacy-html/ # Versioni HTML originali (retrocompatibilità)
La homepage è organizzata in quattro sezioni editoriali:
- Dispense — la serie AI Engineering, numerata 00→04, con le prossime uscite «in coda»
- Fondamenta — il paradigma e i principi
- Guide tecniche — setup e strumenti
- Analisi puntuali — fotografie datate, verificate a scadenza e non aggiornate
| # | Dispensa | Argomento |
|---|---|---|
| 00 | La Mappa | L'atlante L0–L5 della disciplina |
| 01 | Harness & Loop Engineering | Il sistema attorno al modello |
| 02 | Metodo operativo | Sei pratiche in quattro settimane |
| 03 | Sotto Ollama | Il runtime di inferenza (L0) |
| 04 | Database vettoriali | Embedding, HNSW, Qdrant |
In coda: Sicurezza degli agenti, Evals.
| Articolo | Sezione |
|---|---|
| ai-developer-paradigm | Fondamenta |
| ai-developer-paradigm-python | Fondamenta |
| mindset-shift-ai-developer | Fondamenta |
| engineering-guidelines | Fondamenta |
| hyper-human-manifesto | Fondamenta |
| ai-jobs-overview-2026 | Analisi puntuali |
| memory-war-enterprise | Analisi puntuali |
| welcome-to-the-machine-analysis | Analisi puntuali |
| scaling-postgresql | Analisi puntuali |
| Guida | Tema |
|---|---|
| claude-code-vs-cursor-2026 | Confronto strumenti, ed. agosto 2026 |
| claude-code-setup-macos | Installazione Claude Code su macOS |
| claude-code-setup-windows | Installazione Claude Code su Windows |
| macos-dev-setup | macOS Dev Environment Setup |
| windows-dev-setup | Windows Dev Environment Setup |
| windows-terminal-setup | Windows Terminal Setup |
| github-cli-guide | GitHub CLI |
| uv-cheatsheet | uv |
| python-fundamentals-to-generative | Percorso Python |
File di contesto per automatizzare il setup dell'ambiente di sviluppo con Claude Code.
| File | Descrizione |
|---|---|
| macos.md | Setup completo macOS (Homebrew, Node, Python, Docker, etc.) |
| windows.md | Setup completo Windows (winget, Scoop, WSL2, Node, Python, etc.) |
Come usare: apri la repo con Claude Code e chiedi di leggere il file di setup appropriato ed eseguire i comandi.
- Astro 7 — framework per siti statici (Content Layer API)
- MDX — Markdown con componenti Astro
- Content Collections — tre collection con schema Zod (dispense, articles, guides)
- Pagefind — ricerca full-text statica
- GitHub Pages — hosting statico
Design: light-only in stile editoriale (Source Serif 4, Archivo, JetBrains Mono; carta avorio, angoli vivi, accento corallo).
- Nuova sezione Dispense: serie AI Engineering 00–04 (La Mappa, Harness & Loop, Metodo operativo, Sotto Ollama, Database vettoriali) con ordine di lettura, navigazione precedente/successiva e voci «in coda»
- Homepage riorganizzata in quattro sezioni: Dispense · Fondamenta · Guide tecniche · Analisi puntuali
- Redesign completo light-only in stile editoriale claude.com: nuovi token, Source Serif 4 + Archivo + JetBrains Mono, angoli vivi, reveal allo scroll, View Transitions
- Upgrade Astro 5→7 e MDX 4→8 (Content Layer API)
- Paradigma pubblicato in edizione v2 integrale; l'articolo precedente preservato come «I 5 Shift Mentali dell'AI Developer»
- Claude Code vs Cursor — Edizione Agosto 2026 (sostituisce l'edizione 2025, con redirect)
- Contenuti Python riallineati alle versioni canoniche; Python Fundamentals → Generative spostata tra le Guide
- Rimosse Roadmap 2026 v3 e il confronto Cursor 2025 (redirect attivi)
- Ritirato il toggle dark/light: light-only su tre livelli (i WebView mobili in dark rompevano la resa)
- Indice laterale sticky negli articoli, componenti MDX ristilizzati senza emoji, contrasto AA
- Aggiunto articolo "The Hyper-Human Manifesto 2.0"
- Quick Wins UI: toggle tema, tempo di lettura, TOC, copia codice, back-to-top
- Integrato Pagefind per ricerca full-text
- Aggiunto articolo "Claude Code vs Cursor - Confronto 2025"
- Aggiunto colore purple al componente ComparisonTable
- Aggiornata guida GitHub CLI con workflow PR completo
- Convertiti tutti i contenuti da Markdown a MDX
- Aggiunti 11 componenti Astro per styling avanzato (InfoBox, ProsCons, Quote, etc.)
- Styling visuale migliorato con box colorati, griglie, timeline
- Migrazione completa ad Astro framework
- Contenuti convertiti da HTML a Markdown con Content Collections
- File HTML originali preservati in
legacy-html/per retrocompatibilità - Aggiunto
CLAUDE.mdper guidance Claude Code
- Aggiunta cartella
setup/con file di contesto per Claude Code - File markdown ottimizzati per automazione (macos.md, windows.md)
- Aggiunta documentazione open source (CONTRIBUTING, CODE_OF_CONDUCT, LICENSE)
- Aggiunti template GitHub per issues e PR
- Aggiunte guide complete Dev Environment Setup per macOS e Windows
- Boilerplate per setup automatizzato con Claude Code
- Aggiunta homepage con design dark minimal
- Cards interattive con filtri per categoria (Articoli/Guide)
- Documenti resi agnostici (rimossi riferimenti personali)
- Riorganizzazione file in cartelle
articles/eguides/ - Rinominati tutti i file in kebab-case
- Aggiunta guida Claude Code per macOS
- Aggiunto articolo "Da Python Fundamentals a Generative Programming"
- Setup iniziale repository
- Primi articoli e guide