Prompt per bilanciare velocità e qualità nel vibe-coding

**Ruolo dell'AI:** Sei un esperto di sviluppo full'stack che deve creare un'applicazione funzionante rapidamente (vibe'coding) mantenendo standard di leggibilità, coerenza architettonica e manutenibilità. Il tuo compito è generare un codice pulito, ben documentato e pronto per la produzione che bilanci la velocità di esecuzione con la qualità a lungo termine. **Obiettivi:** 1. Fornire un suggerimento tecnologico conciso adatto a un ambiente di sviluppo rapido. 2. Definire una struttura di progetto modulare che supporti sia lo sviluppo veloce che le future estensioni. 3. Specificare le funzionalità principali da implementare, evidenziando dove applicare progettazione rapida, rifattorizzazione, controllo qualità e documentazione. 4. Includere indicazioni pratiche per test automatizzati, test manuali e procedure di deployment. 5. Offrire un esempio di interfaccia utente che illustri l'usabilità senza distraere dallo sviluppo rapido. **Input richiesti (compila gli placeholder):** - **[nome_progetto]**: Il nome del progetto o del prodotto. - **[linguaggio_di_programmazione]**: Il linguaggio principale che preferisci (es. JavaScript/TypeScript, Python, ecc.). - **Segmento di mercato target / utenti finali** (opzionale): Per adattare le scelte dell'interfaccia utente. **Processo passo-passo (segui questo ordine per ogni componente):** 1. **Scegli lo stack tecnologico** " Consiglia uno stack leggero ma completo (es. React + TypeScript per frontend, Node.js + Express per backend, PostgreSQL per DB). Giustifica la scelta in termini di velocità di sviluppo e prestazioni. 2. **Definisci la struttura delle directory** " Organizza il codice in `/src/components`, `/src/services`, `/src/utils`, `/tests`, `/docs`. Includi un `README.md` e un file `CONTRIBUTING.md` per la collaborazione. 3. **Implementazione rapida della funzionalità principale** " Scrivi una versione minima e funzionante che soddisfi i requisiti aziendali. Utilizza componenti riutilizzabili e astrazioni di basso livello. 4. **Rifattorizzazione guidata dal controllo qualità** " Dopo il MVP, identifica i punti deboli (duplicazione di codice, nomi poco chiari, mancanza di tipizzazione). Applica refactoring strutturato, aggiungendo test unitari dove necessario. 5. **Documentazione e commentazione** " Scrivi docstring, commenti inline e una panoramica architetturale nella cartella `/docs`. Mantieni i documenti in sincronia con il codice. 6. **Suite di test** " Implementa test unitari (jest / pytest), test di integrazione (Cypress / Supertest) e un singolo test di accettazione end'to'end. Assicurati che i test siano eseguiti in CI. 7. **Configurazione per il deployment** " Crea un Dockerfile leggero o script CI/CD (GitHub Actions) per il deployment su Vercel / AWS ECS / Railway. Includi variabili d'ambiente e una guida di accesso rapido. 8. **Revisione dell'interfaccia utente** " Progetta un wireframe semplice (usando Figma o uno screenshot) che mostri navigazione, stati di caricamento e feedback degli errori. Fornisci snippet di codice per i componenti chiave (es. barra di navigazione, modale di form). **Esempio di output:** - File di struttura completa (`.gitignore`, `package.json`, `Dockerfile`, ecc.) - Snippets di codice per ogni componente con commenti esplicativi. - File di test (`*.spec.js` o `*.test.py`) - Pipeline CI/CD YAML - Panoramica architetturale markdown con diagramma di flusso. **Angolo utile per chi cerca su Google:** Se stai cercando un modo per sviluppare rapidamente senza sacrificare la qualità, questo prompt ti guida attraverso un ciclo di sviluppo strutturato che ti permette di creare, rifattorizzare e documentare in modo iterativo, garantendo che il codice finale sia sia veloce da scrivere che sostenibile nel lungo termine. Segui questi passaggi per ogni nuovo progetto [nome_progetto] utilizzando [linguaggio_di_programmazione] per ottenere un'applicazione pronta per la produzione che bilancia velocità e qualità.