Capstone: dein eigenes agentisches Produkt von Anfang bis Ende bauen und ausliefern

Überblick

Hier wird alles zu einem Workflow. Nicht fünf separate Fähigkeitssets, sondern eine einzige Schleife von der Idee zum Live-Produkt: ein echtes Problem abstecken, das Spec schreiben, es mit deinem Agent bauen, das Quality Gate fahren, die Security härten, es auffindbar und agent-first machen, deployen und vor Leute stellen. Das Ergebnis ist ein ausgeliefertes Ding, wie klein auch immer, plus der Beweis - für dich selbst -, dass du jede Idee wieder durch diese Schleife bringen kannst. Diese Lektion ist ein geführter Bau mit einer konkreten Akzeptanz-Checkliste, keine Lektüre.

Was du lernst

Du fährst die volle End-to-End-Schleife einmal, bewusst: erbarmungslos auf etwas Machbares abstecken, es so spezifizieren, wie Kurs 1 es lehrte, es mit Claude Code auf einem echten Stack bauen, es mit den Tests und der Security aus diesem Kurs schützen, es mit SEO und einer llms.txt auffindbar machen, ihm eine agent-first API-Oberfläche geben, es deployen und es teilen. Der Output ist ein Live-Produkt und ein wiederholbarer Prozess.

Voraussetzungen

Alle fünf Kurse. Der Capstone zieht auf jede Fähigkeit: Modellwahl und Prompting (Kurs 1), Agent-Meisterschaft (Kurs 2), der moderne Stack aus Auth, Daten und Zahlungen (Kurs 3), Automation und agentische Systeme (Kurs 4) und die Qualitäts-, Security-, Rechts-, SEO- und agent-first Lektionen dieses Kurses. Wenn sich eine davon wackelig anfühlt, mach einen schnellen Durchgang, bevor du startest - der Capstone setzt sie voraus.

Das Problem

Der mit Abstand häufigste Weg, auf dem ein Capstone stirbt, ist der Scope. Leute wählen etwas Riesiges und Inspirierendes, bauen vierzig Prozent davon, treffen die unordentliche Mitte und geben still auf. Ein unfertiges ambitioniertes Projekt lehrt weit weniger als ein fertiges winziges, denn das Ausliefern ist, wo du jedem Problem begegnest, das die Tutorials übersprungen haben. Die ganze Disziplin dieser Lektion ist, etwas zu wählen, das klein genug ist, um es fertig zu bekommen, und echt genug, um zu zählen, und es dann den ganzen Weg bis live zu tragen.

Schritt eins: auf etwas abstecken, das du fertig bekommst

Wähle ein kleines, echtes Problem - idealerweise eines, das du tatsächlich hast, oder eines, das an eine Chance aus der vorherigen Lektion anknüpft. Schneid es runter, bis es dir leicht peinlich ist, wie klein es ist, dann schneid noch einmal. Ein Tool, das eine nützliche Sache gut macht und live ist, schlägt eine Plattform, die zehn Dinge tut und nie ausliefert. Schreib den Scope als einen einzigen Satz, den du einem Fremden erklären könntest.

• Ein Problem, ein Nutzer, ein klares Ergebnis. Wenn du es nicht in einem Satz sagen kannst, ist es zu gross.
• Bevorzug ein echtes eigenes Jucken - du wirst wissen, wann es gut ist, und du wirst es tatsächlich nutzen.
• Vertage erbarmungslos alles, was nicht die Kernschleife ist. Ein zweites Feature ist ein zweites Projekt.
• Definiere fertig, bevor du startest, sodass du auslieferst, statt für immer zu polieren.

Schritt zwei: spezifiziere es und bau es mit deinem Agent

Verwandle den Scope in ein echtes Spec-Sheet - Ziel, Kontext, Constraints, Akzeptanzkriterien - so, wie Kurs 1 es lehrte, mit deinen Axiomen eingebacken. Wähle die richtige Modellstufe für jede Aufgabe, wähle einen Stack, den du deployen kannst, und fahr Claude Code mit Projektregeln in deiner CLAUDE.md, sodass es deinen Konventionen automatisch folgt. Bau zuerst die Kernschleife und bring sie lokal zum Laufen, bevor du irgendetwas drumherum hinzufügst. Bitte den Agent, vor dem Start gegen deinen Plan zu argumentieren - manche der besten Entscheidungen in einem Bau kommen daher, dass der Agent früh einen Fehler fängt.

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

Schritt drei: gate, sichere und werde konform

Bevor das irgendwo in die Nähe eines echten Nutzers kommt, fahr alles aus diesem Kurs. Bring das vierschichtige Quality Gate in Stellung und mach CI erforderlich. Wende die Security-Essentials an - rate-limite jeden öffentlichen Endpunkt, setz eine CSP, verschlüssele jedes gespeicherte Secret und fahr das Pre-Public-Historie-Audit, falls das Repo öffentlich wird. Wenn es beliebige personenbezogene Daten sammelt, mach den Datenschutz-Durchgang: Rechtsgrundlage, ein funktionierender Einwilligungs-Flow, eine Datenschutzerklärung. Das ist der Teil, den Einsteiger überspringen und Profis nie. Es ist auch, was eine Demo von einem Produkt trennt.

• Qualität: tsc, lint, Vitest und Playwright alle grün, erzwungen durch einen Pre-Push-Hook und erforderliches CI.
• Security: Rate Limits, CSP-Header, verschlüsselte Secrets und ein sauberer gitleaks-Scan vor jedem öffentlichen Repo.
• Recht: wenn es personenbezogene Daten berührt, eine Rechtsgrundlage, ein konformer Einwilligungs-Flow und eine Datenschutzerklärung.
• Agent-first: veröffentlichtes OpenAPI-Spec, vorhersehbare strukturierte Fehler, Self-Service-Keys.

Schritt vier: liefere es aus und mach es auffindbar

Deploye auf Vercel, verbinde eine Domain, falls du eine hast, und bestätige, dass es über HTTPS lädt, mit Secrets als Umgebungsvariablen gesetzt, nicht im Repo. Dann mach es durch beide Kanäle aus der SEO-Lektion auffindbar: echte Titel und Beschreibungen, eine Sitemap, Search Console, ein knackiges Favicon, strukturierte Daten und eine llms.txt plus saubere Docs, damit KI-Assistenten es entdecken und empfehlen können. Ein ausgeliefertes Produkt, das niemand finden kann, ist nur halb fertig - gib ihm einen Weg, von Menschen und von Agents entdeckt zu werden.

Schritt fünf: teile es in der Community

Der letzte Schritt ist kein optionaler Schnickschnack, er ist, wie du die Schleife schliesst. Poste dein ausgeliefertes Produkt in der Community: was es tut, was du gelernt hast, wo es schwerer war als erwartet, und den Live-Link. Teilen zwingt dich, tatsächlich fertig zu werden, lädt das Feedback ein, das Version zwei besser macht, und verbindet dich mit anderen Bauenden, die durch dieselbe Schleife gehen. Der Gründer dieser School lieferte unvollkommene Dinge öffentlich aus, lange bevor sie bereit waren, und diese Gewohnheit - ausliefern, teilen, lernen, wiederholen - verzinst sich schneller als jede Menge privaten Polierens.

Typische Fehler

Die Capstone-Killer: ein Scope so gross, dass er nie ausliefert; das Quality Gate überspringen, sodass es bricht, sobald du es änderst; Security überspringen, sodass der erste Bot es missbraucht; die API und Auffindbarkeit als Nachgedanken behandeln, sodass weder Menschen noch Agents es finden können; und es nie teilen, sodass du das Feedback und die Verantwortlichkeit verlierst, die das Fertigwerden verlangt. Klein, gegated, sicher, auffindbar, geteilt - in dieser Reihenfolge.

Business-ROI

Ein einziges ausgeliefertes Produkt lehrt mehr als ein Jahr Tutorials, denn das Ausliefern bringt jedes echte Problem auf einmal an die Oberfläche und erzwingt eine Entscheidung zu jedem. Es ist auch dein Fähigkeitsbeweis - für dich selbst, für Kunden und für jeden, mit dem du arbeiten willst. Und die Schleife, die du gerade gefahren bist, ist der Vermögenswert, nicht nur das Produkt: sobald du eine Idee vom Scope zu einem live, getesteten, sicheren, auffindbaren, agent-first Ding bringen kannst, kannst du es wieder und wieder tun, jedes Mal schneller. Diese wiederholbare Schleife ist die ganze Rendite dieses Programms.

Checkliste

Dein Capstone ist abgeschlossen - wirklich, nicht fast -, wenn jedes davon stimmt. Das ist das Akzeptanzkriterium für das ganze Programm.

• Das Produkt löst ein echtes Problem und ist live unter einer öffentlichen URL über HTTPS.
• Das vierschichtige Quality Gate ist grün und in CI erforderlich.
• Jeder öffentliche Endpunkt ist rate-limitiert, Secrets sind verschlüsselt, und ein öffentliches Repo hat einen Historie-Scan bestanden.
• Wenn es personenbezogene Daten sammelt, hat es eine Rechtsgrundlage, funktionierende Einwilligung und eine Datenschutzerklärung.
• Es hat ein OpenAPI-Spec, vorhersehbare Fehler, Self-Service-Keys und eine llms.txt.
• Es hat echte Titel, eine Sitemap, ein Favicon und ist in der Search Console verifiziert.
• Du hast es in der Community mit dem Live-Link gepostet und mit dem, was du gelernt hast.

Ressourcen

Jede vorherige Lektion ist eine Ressource für diesen Bau - halt das Spec-Sheet-Template, den Quality-Gate-Workflow, die Security-Checkliste, die Datenschutz-Checkliste und die agent-first Checkliste offen, während du arbeitest. Der Builds-Abschnitt zeigt fertige Projekte von Anfang bis Ende, wenn du eine Referenz für Scope und Form willst. Die Community ist, wo du das Ergebnis teilst und wo die nächste Runde Feedback herkommt.

Deine Aufgabe

Bau es und liefere es aus. Wähle das kleine Problem, schreib das Spec, bau es mit deinem Agent, besteh das Quality Gate, sichere und werde konform, deploye es, mach es auffindbar und agent-first, dann poste es in der Community mit dem Live-Link. Hak jede Box auf der Checkliste oben ab. Wenn die letzte Box abgehakt ist, hast du nicht nur einen Kurs beendet - du hast bewiesen, dass du ein agentisches Produkt von Anfang bis Ende ausliefern kannst, allein, wieder und wieder.

Was als Nächstes kommt

Du hast das Programm abgeschlossen, aber das Feld hält nicht still und du solltest es auch nicht. Liefere weiter kleine Dinge aus, falte neue Tools ein, sobald sie auftauchen, und nutze das Changelog als deinen täglichen Tool-News-Hub, um aktuell zu bleiben. Bring deine Builds, deine Erfolge und deine festgefahrenen Momente in die Community - dort verzinst sich das Lernen weiter, nachdem die Kurse enden. Die Schleife, die du jetzt besitzt, ist der ganze Punkt: Idee, bauen, gaten, sichern, ausliefern, teilen, wiederholen. Geh und fahr sie nochmal.