Capstone : bâtir et livrer votre propre produit agentique de bout en bout

Vue d'ensemble

Ici, tout devient un seul workflow. Pas cinq ensembles de compétences séparés, mais une seule boucle de l'idée au produit live : cadrer un problème réel, écrire le spec, le bâtir avec votre agent, faire tourner le quality gate, durcir la sécurité, le rendre découvrable et agent-first, déployer et le mettre devant des gens. Le résultat est une chose livrée, aussi petite soit-elle, plus la preuve - pour vous-même - que vous pouvez faire repasser n'importe quelle idée par cette boucle. Cette leçon est une construction guidée avec une checklist d'acceptation concrète, pas une lecture.

Ce que vous allez apprendre

Vous faites tourner la boucle complète de bout en bout une fois, délibérément : cadrer impitoyablement sur quelque chose de faisable, le spécifier comme le Cours 1 l'a enseigné, le bâtir avec Claude Code sur un vrai stack, le protéger avec les tests et la sécurité de ce cours, le rendre découvrable avec le SEO et un llms.txt, lui donner une surface d'API agent-first, le déployer et le partager. L'output est un produit live et un processus répétable.

Prérequis

Les cinq cours. Le capstone tire sur chaque compétence : choix de modèle et prompting (Cours 1), maîtrise de l'agent (Cours 2), le stack moderne d'auth, données et paiements (Cours 3), automatisation et systèmes agentiques (Cours 4) et les leçons de qualité, sécurité, droit, SEO et agent-first de ce cours. Si l'une d'elles semble bancale, faites un passage rapide avant de démarrer - le capstone les suppose.

Le problème

La façon de loin la plus fréquente dont un capstone meurt est le scope. Les gens choisissent quelque chose d'énorme et d'inspirant, en bâtissent quarante pour cent, heurtent le milieu désordonné et abandonnent en silence. Un projet ambitieux inachevé enseigne bien moins qu'un minuscule fini, car livrer est là où vous rencontrez chaque problème que les tutoriels ont sauté. Toute la discipline de cette leçon est de choisir quelque chose d'assez petit pour le finir, et d'assez réel pour compter, puis de le porter tout le chemin jusqu'au live.

Étape un : cadrer sur quelque chose que vous finissez

Choisissez un petit problème réel - idéalement un que vous avez effectivement, ou un qui se rattache à une opportunité de la leçon précédente. Taillez-le jusqu'à ce que vous soyez un peu gêné de sa petitesse, puis taillez encore. Un outil qui fait une chose utile bien et est live bat une plateforme qui fait dix choses et ne livre jamais. Écrivez le scope en une seule phrase que vous pourriez expliquer à un inconnu.

• Un problème, un utilisateur, un résultat clair. Si vous ne pouvez le dire en une phrase, c'est trop gros.
• Préférez une vraie démangeaison à vous - vous saurez quand c'est bon, et vous l'utiliserez effectivement.
• Différez impitoyablement tout ce qui n'est pas la boucle centrale. Une deuxième fonctionnalité est un deuxième projet.
• Définissez fini avant de démarrer, pour livrer au lieu de polir pour toujours.

Étape deux : spécifiez-le et bâtissez-le avec votre agent

Transformez le scope en un vrai spec-sheet - objectif, contexte, contraintes, critères d'acceptation - comme le Cours 1 l'a enseigné, avec vos axiomes intégrés. Choisissez le bon palier de modèle pour chaque tâche, choisissez un stack que vous pouvez déployer, et faites tourner Claude Code avec des règles de projet dans votre CLAUDE.md, pour qu'il suive vos conventions automatiquement. Bâtissez d'abord la boucle centrale et faites-la tourner localement avant d'ajouter quoi que ce soit autour. Demandez à l'agent d'argumenter contre votre plan avant de démarrer - certaines des meilleures décisions d'une construction viennent de ce que l'agent attrape une erreur tôt.

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

Étape trois : gatez, sécurisez et devenez conforme

Avant que cela approche de près un vrai utilisateur, faites tourner tout de ce cours. Mettez le quality gate à quatre couches en place et rendez la CI requise. Appliquez les essentiels de sécurité - rate-limitez chaque endpoint public, posez une CSP, chiffrez chaque secret stocké et faites tourner l'audit d'historique pré-public si le repo devient public. S'il collecte n'importe quelle donnée personnelle, faites le passage confidentialité : base légale, un flux de consentement fonctionnel, une politique de confidentialité. C'est la partie que les débutants sautent et que les pros ne sautent jamais. C'est aussi ce qui sépare une démo d'un produit.

• Qualité : tsc, lint, Vitest et Playwright tous verts, imposés par un pre-push hook et une CI requise.
• Sécurité : rate limits, headers CSP, secrets chiffrés et un scan gitleaks propre avant chaque repo public.
• Droit : s'il touche des données personnelles, une base légale, un flux de consentement conforme et une politique de confidentialité.
• Agent-first : spec OpenAPI publié, erreurs structurées prévisibles, clés en self-service.

Étape quatre : livrez-le et rendez-le découvrable

Déployez sur Vercel, connectez un domaine si vous en avez un, et confirmez qu'il charge via HTTPS, avec les secrets posés comme variables d'environnement, pas dans le repo. Puis rendez-le découvrable par les deux canaux de la leçon SEO : de vrais titres et descriptions, un sitemap, la Search Console, un favicon net, des données structurées et un llms.txt plus des docs propres, pour que les assistants IA puissent le découvrir et le recommander. Un produit livré que personne ne peut trouver n'est qu'à moitié fini - donnez-lui un moyen d'être découvert par les humains et par les agents.

Étape cinq : partagez-le dans la communauté

La dernière étape n'est pas un accessoire optionnel, c'est la façon dont vous fermez la boucle. Postez votre produit livré dans la communauté : ce qu'il fait, ce que vous avez appris, où c'était plus dur qu'attendu, et le lien live. Partager vous force à effectivement finir, invite le feedback qui rend la version deux meilleure, et vous connecte à d'autres builders qui parcourent la même boucle. Le fondateur de cette School a livré des choses imparfaites publiquement bien avant qu'elles ne soient prêtes, et cette habitude - livrer, partager, apprendre, répéter - se capitalise plus vite que n'importe quelle quantité de polissage privé.

Erreurs fréquentes

Les tueurs de capstone : un scope si grand qu'il ne livre jamais ; sauter le quality gate, si bien qu'il casse dès que vous le changez ; sauter la sécurité, si bien que le premier bot l'abuse ; traiter l'API et la découvrabilité comme des arrière-pensées, si bien que ni humains ni agents ne peuvent le trouver ; et ne jamais le partager, si bien que vous perdez le feedback et la responsabilité qu'exige le fait de finir. Petit, gaté, sûr, découvrable, partagé - dans cet ordre.

ROI business

Un seul produit livré enseigne plus qu'un an de tutoriels, car livrer fait remonter chaque problème réel d'un coup et force une décision sur chacun. C'est aussi votre preuve de compétence - pour vous-même, pour les clients et pour quiconque vous voulez travailler avec. Et la boucle que vous venez de parcourir est l'actif, pas seulement le produit : une fois que vous pouvez amener une idée du scope à une chose live, testée, sûre, découvrable et agent-first, vous pouvez le refaire encore et encore, plus vite à chaque fois. Cette boucle répétable est tout le rendement de ce programme.

Checklist

Votre capstone est terminé - vraiment, pas presque - quand chacun de ces points est vrai. C'est le critère d'acceptation pour tout le programme.

• Le produit résout un vrai problème et est live sous une URL publique via HTTPS.
• Le quality gate à quatre couches est vert et requis en CI.
• Chaque endpoint public est rate-limité, les secrets sont chiffrés, et un repo public a passé un scan d'historique.
• S'il collecte des données personnelles, il a une base légale, un consentement fonctionnel et une politique de confidentialité.
• Il a un spec OpenAPI, des erreurs prévisibles, des clés en self-service et un llms.txt.
• Il a de vrais titres, un sitemap, un favicon et est vérifié dans la Search Console.
• Vous l'avez posté dans la communauté avec le lien live et ce que vous avez appris.

Ressources

Chaque leçon précédente est une ressource pour cette construction - gardez ouverts le template de spec-sheet, le workflow de quality gate, la checklist de sécurité, la checklist de confidentialité et la checklist agent-first pendant que vous travaillez. La section builds montre des projets finis de bout en bout, si vous voulez une référence pour le scope et la forme. La communauté est là où vous partagez le résultat et d'où vient la prochaine ronde de feedback.

Votre mission

Bâtissez-le et livrez-le. Choisissez le petit problème, écrivez le spec, bâtissez-le avec votre agent, passez le quality gate, sécurisez et devenez conforme, déployez-le, rendez-le découvrable et agent-first, puis postez-le dans la communauté avec le lien live. Cochez chaque case de la checklist ci-dessus. Quand la dernière case est cochée, vous n'avez pas juste fini un cours - vous avez prouvé que vous pouvez livrer un produit agentique de bout en bout, seul, encore et encore.

Ce qui vient ensuite

Vous avez terminé le programme, mais le domaine ne reste pas immobile et vous ne devriez pas non plus. Continuez de livrer de petites choses, intégrez de nouveaux outils dès qu'ils apparaissent, et utilisez le changelog comme votre hub quotidien d'actualités d'outils pour rester à jour. Amenez vos builds, vos succès et vos moments de blocage dans la communauté - c'est là que l'apprentissage se capitalise après la fin des cours. La boucle que vous possédez maintenant est tout le point : idée, bâtir, gater, sécuriser, livrer, partager, répéter. Allez la refaire.