Capstone: costruire e pubblicare il tuo prodotto agentico dall'inizio alla fine

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.

## 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.

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.