--- title: "Capstone: costruire e pubblicare il tuo prodotto agentico dall'inizio alla fine" description: "Pianificare, costruire, testare, mettere in sicurezza e pubblicare un prodotto agentico completo, con tutto dei cinque corsi" type: "lesson" locale: "it" course: "Qualità, sicurezza e il business agent-first" number: "5.7" canonical: "https://agenticschool.dev/it/corsi/quality-security-agent-first/capstone-build-and-ship-your-own-agentic-product-end-to-end" datePublished: "2026-06-12" dateModified: "2026-06-12" --- # Capstone: costruire e pubblicare il tuo prodotto agentico dall'inizio alla fine - Course: Qualità, sicurezza e il business agent-first - Lesson: 5.7 - Duration: 32 min - Level: technik - Status: published - Canonical URL: https://agenticschool.dev/it/corsi/quality-security-agent-first/capstone-build-and-ship-your-own-agentic-product-end-to-end - Locale: it > Pianificare, costruire, testare, mettere in sicurezza e pubblicare un prodotto agentico completo, con tutto dei cinque corsi ## Summary Il capstone collega tutto il programma. Scegli un piccolo problema reale, lo specifichi, lo costruisci con Claude Code con tutto dei Corsi da 1 a 4, fai girare i quality gate, lo metti in sicurezza, lo rendi scopribile con llms.txt e una superficie di API, lo deployi e lo condividi nella comunita - contro una checklist chiara di criteri di accettazione. ## What you learn - Inquadrare un piccolo problema reale che finisci davvero, e scrivere uno spec per esso - Costruirlo, testarlo, metterlo in sicurezza e deployarlo con tutto dei Corsi da 1 a 4 - Pubblicarlo scopribile e agent-first, con una checklist chiara di criteri di accettazione ## Panoramica Qui, tutto diventa un solo workflow. Non cinque insiemi di abilita separati, ma un solo loop dall'idea al prodotto live: inquadrare un problema reale, scrivere lo spec, costruirlo con il tuo agente, far girare il quality gate, indurire la sicurezza, renderlo scopribile e agent-first, deployare e metterlo davanti alle persone. Il risultato e una cosa pubblicata, per quanto piccola, piu la prova - a te stesso - che puoi far ripassare qualsiasi idea per questo loop. Questa lezione e una costruzione guidata con una checklist di accettazione concreta, non una lettura. ## Cosa imparerai Fai girare il loop completo dall'inizio alla fine una volta, deliberatamente: inquadra spietatamente su qualcosa di fattibile, specificalo come il Corso 1 ha insegnato, costruiscilo con Claude Code su un vero stack, proteggilo con i test e la sicurezza di questo corso, rendilo scopribile con la SEO e un llms.txt, dagli una superficie di API agent-first, deployalo e condividilo. L'output e un prodotto live e un processo ripetibile. ## Prerequisiti I cinque corsi. Il capstone tira su ogni abilita: scelta di modello e prompting (Corso 1), padronanza dell'agente (Corso 2), lo stack moderno di auth, dati e pagamenti (Corso 3), automazione e sistemi agentici (Corso 4) e le lezioni di qualita, sicurezza, diritto, SEO e agent-first di questo corso. Se una di esse sembra traballante, fai un passaggio rapido prima di partire - il capstone le suppone. ## Il problema Il modo di gran lunga piu frequente in cui un capstone muore e lo scope. Le persone scelgono qualcosa di enorme e ispirante, ne costruiscono il quaranta percento, colpiscono il mezzo disordinato e rinunciano in silenzio. Un progetto ambizioso incompiuto insegna molto meno di uno minuscolo finito, perche pubblicare e dove incontri ogni problema che i tutorial hanno saltato. Tutta la disciplina di questa lezione e scegliere qualcosa di abbastanza piccolo da finirlo, e abbastanza reale da contare, poi portarlo tutto il cammino fino al live. ## Passo uno: inquadrare su qualcosa che finisci Scegli un piccolo problema reale - idealmente uno che hai effettivamente, o uno che si aggancia a un'opportunita della lezione precedente. Taglialo finche sei un po' imbarazzato dalla sua piccolezza, poi taglia ancora. Uno strumento che fa una cosa utile bene ed e live batte una piattaforma che fa dieci cose e non pubblica mai. Scrivi lo scope in una sola frase che potresti spiegare a uno sconosciuto. - Un problema, un utente, un risultato chiaro. Se non puoi dirlo in una frase, e troppo grosso. - Preferisci un vero prurito tuo - saprai quando e buono, e lo userai effettivamente. - Rinvia spietatamente tutto cio che non e il loop centrale. Una seconda feature e un secondo progetto. - Definisci finito prima di partire, per pubblicare invece di rifinire per sempre. ## Passo due: specificalo e costruiscilo con il tuo agente Trasforma lo scope in un vero spec-sheet - obiettivo, contesto, vincoli, criteri di accettazione - come il Corso 1 ha insegnato, con i tuoi assiomi integrati. Scegli il giusto livello di modello per ogni compito, scegli uno stack che puoi deployare, e fai girare Claude Code con regole di progetto nel tuo CLAUDE.md, perche segua le tue convenzioni automaticamente. Costruisci prima il loop centrale e fallo girare localmente prima di aggiungere qualsiasi cosa attorno. Chiedi all'agente di argomentare contro il tuo piano prima di partire - alcune delle migliori decisioni di una costruzione vengono dal fatto che l'agente coglie un errore presto. ```markdown ## Goal A tool that takes a business address and returns its opening hours as clean JSON. ## Context - Stack: this TanStack Start app, Convex for data, deploy on Vercel. - Follow the API patterns from the agent-first lesson. ## Constraints - TypeScript only. Every endpoint rate-limited. Secrets in env vars. - Publish an OpenAPI spec and an llms.txt. Self-serve API keys. - Add a Vitest test for the parser and a Playwright test for the happy path. ## Acceptance criteria - [ ] GET /v1/hours?address=... returns structured JSON or a clear error. - [ ] Rate limit returns 429 when exceeded. Errors are structured. - [ ] OpenAPI spec and llms.txt are live and accurate. - [ ] Quality gate (tsc, lint, vitest, playwright) is green in CI. - [ ] Deployed to a public URL over HTTPS. ``` Uno spec-sheet di capstone che integra i criteri di qualita, di sicurezza e agent-first ## Passo tre: gate, metti in sicurezza e diventa conforme Prima che questo si avvicini da vicino a un vero utente, fai girare tutto di questo corso. Metti il quality gate a quattro strati in atto e rendi la CI richiesta. Applica gli essenziali di sicurezza - rate-limita ogni endpoint pubblico, poni una CSP, cifra ogni segreto memorizzato e fai girare l'audit di cronologia pre-pubblico se il repo diventa pubblico. Se raccoglie qualsiasi dato personale, fai il passaggio privacy: base legale, un flusso di consenso funzionante, una privacy policy. E la parte che i principianti saltano e che i pro non saltano mai. E anche cio che separa una demo da un prodotto. - Qualita: tsc, lint, Vitest e Playwright tutti verdi, imposti da un pre-push hook e una CI richiesta. - Sicurezza: rate limit, header CSP, segreti cifrati e una scansione gitleaks pulita prima di ogni repo pubblico. - Diritto: se tocca dati personali, una base legale, un flusso di consenso conforme e una privacy policy. - Agent-first: spec OpenAPI pubblicato, errori strutturati prevedibili, chiavi in self-service. ## Passo quattro: pubblicalo e rendilo scopribile Deploy su Vercel, connetti un dominio se ne hai uno, e conferma che carica via HTTPS, con i segreti posti come variabili d'ambiente, non nel repo. Poi rendilo scopribile da entrambi i canali della lezione SEO: veri titoli e descrizioni, un sitemap, la Search Console, un favicon netto, dati strutturati e un llms.txt piu doc pulite, perche gli assistenti IA possano scoprirlo e raccomandarlo. Un prodotto pubblicato che nessuno puo trovare e solo a meta finito - dagli un modo di essere scoperto dagli umani e dagli agenti. ## Passo cinque: condividilo nella comunita L'ultimo passo non e un accessorio opzionale, e il modo in cui chiudi il loop. Posta il tuo prodotto pubblicato nella comunita: cosa fa, cosa hai imparato, dove era piu duro dell'atteso, e il link live. Condividere ti costringe a finire effettivamente, invita il feedback che rende la versione due migliore, e ti connette ad altri builder che percorrono lo stesso loop. Il fondatore di questa School ha pubblicato cose imperfette pubblicamente ben prima che fossero pronte, e questa abitudine - pubblicare, condividere, imparare, ripetere - si capitalizza piu in fretta di qualsiasi quantita di rifinitura privata. ## Errori frequenti I killer di capstone: uno scope cosi grande che non pubblica mai; saltare il quality gate, cosicche si rompe appena lo cambi; saltare la sicurezza, cosicche il primo bot lo abusa; trattare l'API e la scopribilita come ripensamenti, cosicche ne umani ne agenti possono trovarlo; e non condividerlo mai, cosicche perdi il feedback e la responsabilita che esige il finire. Piccolo, gated, sicuro, scopribile, condiviso - in quest'ordine. ## ROI business Un solo prodotto pubblicato insegna piu di un anno di tutorial, perche pubblicare fa risalire ogni problema reale in una volta e forza una decisione su ciascuno. E anche la tua prova di competenza - a te stesso, ai clienti e a chiunque tu voglia lavorare con. E il loop che hai appena percorso e l'asset, non solo il prodotto: una volta che puoi portare un'idea dallo scope a una cosa live, testata, sicura, scopribile e agent-first, puoi rifarlo ancora e ancora, piu in fretta ogni volta. Questo loop ripetibile e tutto il rendimento di questo programma. ## Checklist Il tuo capstone e finito - davvero, non quasi - quando ognuno di questi punti e vero. E il criterio di accettazione per tutto il programma. - Il prodotto risolve un vero problema ed e live sotto un URL pubblico via HTTPS. - Il quality gate a quattro strati e verde e richiesto in CI. - Ogni endpoint pubblico e rate-limitato, i segreti sono cifrati, e un repo pubblico ha passato una scansione di cronologia. - Se raccoglie dati personali, ha una base legale, un consenso funzionante e una privacy policy. - Ha uno spec OpenAPI, errori prevedibili, chiavi in self-service e un llms.txt. - Ha veri titoli, un sitemap, un favicon ed e verificato nella Search Console. - L'hai postato nella comunita con il link live e cio che hai imparato. ## Risorse Ogni lezione precedente e una risorsa per questa costruzione - tieni aperti il template di spec-sheet, il workflow di quality gate, la checklist di sicurezza, la checklist di privacy e la checklist agent-first mentre lavori. La sezione builds mostra progetti finiti dall'inizio alla fine, se vuoi un riferimento per lo scope e la forma. La comunita e dove condividi il risultato e da dove viene la prossima tornata di feedback. ## La tua missione Costruiscilo e pubblicalo. Scegli il piccolo problema, scrivi lo spec, costruiscilo con il tuo agente, passa il quality gate, metti in sicurezza e diventa conforme, deployalo, rendilo scopribile e agent-first, poi postalo nella comunita con il link live. Spunta ogni casella della checklist qui sopra. Quando l'ultima casella e spuntata, non hai solo finito un corso - hai provato che puoi pubblicare un prodotto agentico dall'inizio alla fine, da solo, ancora e ancora. ## Cosa viene dopo Hai finito il programma, ma l'ambito non resta immobile e nemmeno tu dovresti. Continua a pubblicare piccole cose, integra nuovi strumenti appena appaiono, e usa il changelog come il tuo hub quotidiano di novita sugli strumenti per restare aggiornato. Porta i tuoi build, i tuoi successi e i tuoi momenti di blocco nella comunita - e li che l'apprendimento si capitalizza dopo la fine dei corsi. Il loop che ora possiedi e tutto il punto: idea, costruire, gate, mettere in sicurezza, pubblicare, condividere, ripetere. Vai a rifarlo. ## Transcript Il capstone collega tutto il programma. Scegli un piccolo problema reale, lo specifichi, lo costruisci con Claude Code con tutto dei Corsi da 1 a 4, fai girare i quality gate, lo metti in sicurezza, lo rendi scopribile con llms.txt e una superficie di API, lo deployi e lo condividi nella comunita - contro una checklist chiara di criteri di accettazione.