TASK: Standardizzazione Documentazione Progetto Esistente OBIETTIVO: Creare/aggiornare la documentazione del progetto seguendo gli standard definiti, mantenendo solo 2 file markdown: PROJECT_STATUS.md e README.md. --- STEP 1: ANALISI PROGETTO 1. Esplora la struttura completa del progetto 2. Identifica tutti i file .md esistenti 3. Analizza il codice per comprendere: - Architettura e moduli principali - Dipendenze (requirements.txt o imports) - Funzionalità implementate - Configurazione utilizzata --- STEP 2: CREAZIONE PROJECT_STATUS.md Crea il file PROJECT_STATUS.md nella root del progetto con questa struttura: # [NOME PROGETTO] - Project Status **Last Updated**: [data e ora corrente] **Current Phase**: Complete **Project Location**: [path assoluto del progetto] --- ## Project Overview [Descrizione in 2-3 righe di cosa fa il progetto] --- ## Project Structure (Current) [tree della directory attuale] --- ## Implemented Features ### [Feature Name 1] - **Status**: ✅ Complete - **Implementation**: [Descrizione di cosa fa e come] - **Files**: [file coinvolti] ### [Feature Name 2] - **Status**: ✅ Complete - **Implementation**: [Descrizione] - **Files**: [file coinvolti] [Ripeti per ogni feature/modulo principale] --- ## Architecture **Type**: [CLI Tool / Web Application / Background Service / etc.] **Target OS**: [Linux / Windows / Both - dedurre dal codice] **Python Version**: [versione rilevata] **Key Modules**: - **[modulo1]**: [responsabilità] - **[modulo2]**: [responsabilità] --- ## Dependencies [Lista da requirements.txt o analisi imports] --- ## Configuration - **Format**: [YAML / JSON / .env / INI - quello usato] - **Location**: [path dei file di config] - **Key settings**: [parametri configurabili principali] --- ## Technical Decisions Log | Aspect | Decision | Implementation | |--------|----------|----------------| | [es: Logging] | [cosa è stato scelto] | [come è implementato] | | [es: Data Storage] | [cosa è stato scelto] | [come è implementato] | --- ## Notes [Eventuali note tecniche rilevanti, pattern utilizzati, peculiarità del progetto] --- STEP 3: AGGIORNAMENTO README.md Riscrivi completamente README.md nella root del progetto con questa struttura: # [NOME PROGETTO] [Descrizione concisa in 1-2 frasi di cosa fa il progetto e perché è utile] ## Features - [Feature principale 1] - [Feature principale 2] - [Feature principale 3] ## Requirements - Python [versione] - [Altre dipendenze di sistema se necessarie] ## Installation ```bash # Clone repository (se applicabile, altrimenti ometti) git clone [url] # Create virtual environment python -m venv venv # Activate virtual environment # Linux/Mac: source venv/bin/activate # Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt ``` ## Configuration [Descrizione di come configurare il progetto: file di config, variabili d'ambiente, etc.] Esempio: ```yaml # config/settings.yaml [esempio configurazione] ``` ## Usage [Esempi concreti di utilizzo] **Esempio 1**: [Caso d'uso principale] ```bash python [comando] ``` **Esempio 2**: [Altro caso d'uso] ```bash python [comando con opzioni] ``` ## Project Structure project-root/ ├── src/ │ ├── [moduli principali] ├── config/ ├── [altre directory rilevanti] ├── requirements.txt ├── PROJECT_STATUS.md └── README.md ## Development [Informazioni per sviluppatori se rilevanti: come estendere, test, etc.] ## License [Se applicabile] --- STEP 4: PULIZIA FILE MARKDOWN 1. Cerca tutti i file .md nel progetto (esclusi PROJECT_STATUS.md e README.md) 2. Elenca i file trovati e chiedi conferma prima di eliminarli 3. Dopo conferma, eliminali --- OUTPUT ATTESO: - PROJECT_STATUS.md creato con analisi completa dello stato attuale - README.md riscritto con documentazione utente chiara - Solo questi 2 file .md presenti nel progetto - Report di cosa è stato fatto INIZIA con l'analisi del progetto e procedi passo per passo.