commit 1ccb0924699ae97ae499873d4e3422bee942d1b1
Author: Michele <michele@mlhub.it>
Date:   Sat Jan 31 01:53:03 2026 +0100

    docs: initialize project
    
    Leopost - micro-SaaS di social media management AI per freelance italiani
    
    Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md
new file mode 100644
index 0000000..3c31586
--- /dev/null
+++ b/.planning/PROJECT.md
@@ -0,0 +1,93 @@
+# Leopost
+
+## What This Is
+
+Leopost è un micro-SaaS di social media management potenziato da AI, pensato per freelance e solopreneur italiani. L'utente configura il proprio brand una volta, poi l'AI genera, schedula e pubblica contenuti sui social in autonomia. L'interfaccia principale è una chat con l'assistente AI, supportata da schermate per calendario e impostazioni.
+
+## Core Value
+
+L'AI fa il lavoro sporco del social media manager: l'utente investe poco tempo nella configurazione iniziale e ottiene contenuti pubblicati automaticamente sui propri canali, con qualità che migliora nel tempo man mano che l'AI impara le sue preferenze.
+
+## Requirements
+
+### Validated
+
+(None yet — ship to validate)
+
+### Active
+
+**Onboarding & Brand Context**
+- [ ] Wizard di onboarding progressivo (info essenziali subito, resto nel tempo)
+- [ ] Raccolta brand kit (loghi, colori, font)
+- [ ] Raccolta info azienda/freelance (settore, target, zona geografica, siti web)
+- [ ] Memoria persistente del contesto utente
+
+**Autenticazione & Account**
+- [ ] Registrazione/login utente
+- [ ] 3 piani: Free, Creator, Pro (limiti da definire post-testing)
+- [ ] Collegamento account social (Facebook, Instagram, LinkedIn)
+
+**Chat AI**
+- [ ] Interfaccia chat come esperienza principale
+- [ ] Scelta modello AI (ChatGPT, Claude, Gemini)
+- [ ] Suggerimenti azioni iniziali post-onboarding
+- [ ] L'AI impara le preferenze utente nel tempo (feedback + analisi comportamento)
+
+**Generazione Contenuti**
+- [ ] Generazione post testuali adattati per piattaforma (tono, lunghezza, hashtag)
+- [ ] Generazione immagini AI
+- [ ] Supporto template grafici utente
+- [ ] Creazione piano editoriale
+
+**Scheduling & Pubblicazione**
+- [ ] Scheduling post con data/ora
+- [ ] Pubblicazione automatica sui social collegati
+- [ ] Livelli automazione configurabili (approval → autopilot)
+
+**Calendario & Visualizzazione**
+- [ ] Calendario editoriale visuale con post programmati
+
+**Integrazioni Messaging**
+- [ ] Integrazione Telegram per comandi testuali/vocali
+- [ ] Integrazione WhatsApp per comandi testuali/vocali
+
+### Out of Scope
+
+- App native iOS/Android — architettura headless pronta, ma web-first per v1
+- Video generation — solo immagini per v1, video in futuro
+- Social aggiuntivi (YouTube, TikTok, X) — solo Facebook, Instagram, LinkedIn per v1
+- Dashboard analytics avanzate — focus su creazione/pubblicazione, non analytics
+
+## Context
+
+**Target primario**: Freelance e solopreneur italiani che gestiscono i propri social personalmente. Non hanno tempo o competenze per fare content marketing professionale, ma sanno che devono essere presenti sui social.
+
+**Problema che risolve**: Creare contenuti social richiede tempo, creatività e costanza. La maggior parte dei freelance inizia con entusiasmo, poi abbandona. Leopost elimina l'attrito: l'AI fa il lavoro creativo e operativo.
+
+**Modello mentale**: L'utente "assume" un social media manager AI. All'inizio supervisiona il lavoro, poi si fida sempre di più e lascia fare.
+
+**Esperienza target**: "Minimo sforzo, massima resa". Configurazione iniziale leggera, poi l'app lavora in background. L'utente può interagire via chat web, Telegram o WhatsApp quando vuole, ma non è obbligato.
+
+**Nome assistente AI**: Placeholder (da definire). L'app si chiama Leopost (nome temporaneo).
+
+## Constraints
+
+- **Architettura**: Headless (frontend/backend separati) — preparato per future app native
+- **Stack AI**: Multi-provider (OpenAI, Anthropic, Google) — utente sceglie
+- **Social API**: Dipendenza da API ufficiali Facebook/Meta, LinkedIn — soggette a limitazioni e approvazioni
+- **Generazione immagini**: Modello da scegliere in base a qualità/costo (DALL-E 3, Imagen, etc.)
+- **Target geografico**: Italia (lingua italiana, contesto PMI italiane)
+
+## Key Decisions
+
+| Decision | Rationale | Outcome |
+|----------|-----------|---------|
+| Chat-first con schermate di supporto | L'interazione naturale riduce l'attrito, ma calendario e settings servono visuali | — Pending |
+| Multi-model AI (GPT, Claude, Gemini) | Diversi utenti preferiscono modelli diversi, evita lock-in | — Pending |
+| Onboarding progressivo | Evita abbandono per "troppo da fare" al primo accesso | — Pending |
+| Automazione configurabile | Costruisce fiducia gradualmente, dall'approval all'autopilot | — Pending |
+| Headless architecture | Prepara per app native senza riscrivere logica | — Pending |
+| Limiti piano Free da definire post-test | Meglio testare dove l'utente sente il bisogno di upgrade | — Pending |
+
+---
+*Last updated: 2026-01-30 after initialization*