chores on README.md

README.md

@@ -0,0 +1,50 @@
+LogWhispererAI 🌌
+aka Sacchi's Server Sentinel
+UVP: Il DevOps tascabile che traduce i crash del tuo server e ti dice l'esatto comando per risolverli in sicurezza, senza farti perdere ore su StackOverflow.
+🎯 Visione del Progetto
+LogWhisperer AI trasforma i log di sistema e database spesso incomprensibili in alert azionabili descritti in "plain language". È pensato per piccole web agency e freelance che gestiscono infrastrutture (AWS, DigitalOcean, VPS) senza avere un sistemista senior dedicato.
+🚀 Funzionalità MVP (Lancio in 4 giorni)
+Log Ingestion: Script Bash leggero per il monitoraggio (tail -f) di log critici (syslog, nginx, postgres).
+AI Processing Pipeline: Workflow su n8n che analizza i log tramite LLM (OpenAI/Anthropic) applicando il Metodo Sacchi (Safety first, little often, double check).
+Alerting Umano: Notifiche su Telegram/Slack con sintesi del problema, severità e comando esatto per la mitigazione.
+🛠️ Stack Tecnologico
+Core Logic: Python 3.12+ (in venv)
+Automation: n8n (self-hosted)
+Database: Supabase / PostgreSQL
+AI: GPT-4o-mini / Claude 3.5 Sonnet
+Agentic Dev: OpenCode.ai
+🛠️ Setup per lo Sviluppo
+Il progetto segue una metodologia Spec-Driven e TDD (Test-Driven Development).
+# Clone e setup
+git clone [https://github.com/LucaSacchiNet/LogWhispererAI.git](https://github.com/LucaSacchiNet/LogWhispererAI.git)
+cd LogWhispererAI
+
+# Ambiente virtuale
+python3 -m venv venv
+source venv/bin/activate
+
+# Installazione dipendenze (TBD)
+pip install -r requirements.txt
+
+
+Regole degli Agenti (OpenCode.ai)
+Il file AGENTS.md definisce il comportamento degli assistenti AI. Per avviare una sessione di sviluppo:
+opencode
+
+
+📜 Metodologia e Standard
+Git: Conventional Commits (feat, fix, docs, test).
+Changelog: Common Changelog standard.
+Testing: Pytest per la logica Python e test di integrazione per gli script bash.
+⚖️ Licenza e Note Legali
+Questo software è proprietà riservata di Luca Sacchi Ricciardi.
+Tutti i diritti sono riservati. Per ogni controversia derivante dall'uso o dallo sviluppo di questo software, il foro competente in via esclusiva è il Foro di Milano, Italia.
+Per i dettagli completi, consultare il file LICENSE.md.
+👨‍💻 Autore
+Luca Sacchi Ricciardi
+🌐 [Sito Web / Blog](https://lucasacchi.net)
+📺 [Canale YouTube](https://www.youtube.com/@lucasacchinet)
+🔗 [LinkedIn](https://www.linkedin.com/in/lucasacchi)
+✉️ luca@lucasacchi.net
+LogWhispererAI - "Safety first, little often, double check"
+