Anhang A. Brücken zum ersten Band
Der Anwendungsband baut auf dem Material des ersten Bandes auf. Dieser Anhang versammelt alle Brücken an einem Ort: welche Teile des ersten Bandes als Voraussetzung gelten, wie sich unser SDD-Dialekt zu Spec Kit und Kiro verhält, und wie die Production-Szenarien des zweiten Bandes aus dem Lernprojekt AgentClinic erwachsen.
Falls etwas aus der Aufzählung unbekannt ist – absolvieren Sie zunächst den entsprechenden Teil des ersten Bandes, sonst werden viele Kapitel des zweiten Bandes wie ein Aneinanderhäufen von Fachbegriffen wirken.
Vor Kapitel 1 lesen Sie Teil 0. Er übersetzt den grundlegenden AgentClinic in ein Lernmodell für Production und fixiert die minimale Route: welche Artefakte manuell ausgefüllt werden, welche Beispiele lokal gestartet werden, und welche Blöcke nur zur vollständigen Implementierungsspur gehören.
Minimum, ohne das der zweite Band nicht lesbar ist
| Was verstanden sein muss | Wo es im ersten Band eingeführt wird |
|---|---|
Struktur von mission.md, tech-stack.md, roadmap.md | Teil 6. Erstellung der Konstitution |
Format von requirements.md, plan.md, validation.md | Teil 7. Feature-Spezifikation |
| Merge-Fakten, EARS, Given/When/Then | Teil 9. Feature-Validierung: von Spezifikationen zu Fakten |
| Neuplanung und Aktualisierung der Roadmap | Teil 10. Neuplanung des Projekts |
| Wartung einer Legacy-Codebasis und Spec-Archäologie | Teil 13. Betreuung eines bestehenden Projekts |
| Agentenersetzbarkeit, Verweise auf ACP/AGENTS.md | Teil 15. Agentenersetzbarkeit |
| Team-Review und Beweispaket | Teil 16. Teamarbeit und Code-Review |
Qwen Code-Hooks, PreToolUse und PostToolUse | Teil 17. Qwen Code-Hooks |
| SDD-Antipatterns | Teil 20. SDD-Antipatterns |
| Praktische Prüfung als Validierung des gesamten Prozesses | Teil 22. Praktische Prüfung |
SDD-Dialekte: Spec Kit, Kiro, der autorenseigene Dialekt des Lehrbuchs
Der Anwendungsband verwendet denselben autorenseigenen Dialekt wie der erste Band. Ein detaillierter Vergleich mit GitHub Spec Kit und AWS Kiro findet sich in Anhang A des ersten Bandes: eine Tabelle der Artefakt-Entsprechungen, Empfehlungen zur Prozessübertragung, Einschränkungen jedes Formats.
Falls das Team bereits mit Spec Kit oder Kiro arbeitet, lesen Sie die Kapitel des zweiten Bandes und benennen Sie gedanklich requirements.md → /speckit.specify, plan.md → /speckit.plan + /speckit.tasks, validation.md → /speckit.analyze + Prüflisten um. Die Kapitel sind nicht starr an das Format gebunden: ihre Ideen lassen sich zwischen Dialekten übertragen, ohne Bedeutung zu verlieren.
Domänenkarte AgentClinic
Die Production-Szenarien des zweiten Bandes entfalten sich gedanklich auf dem Lernprojekt AgentClinic aus dem ersten Band. Die vollständige Beschreibung der Domänenentitäten – Agenten-Patienten, Leiden, Therapien, Terminvereinbarungen, Bewertungen, Feedback – ist in Anhang B des ersten Bandes zusammengestellt.
Der zweite Band erfordert nicht, dass das Ergebnis des ersten Bandes bereits in einer echten Production-Infrastruktur läuft. Alle externen Systeme in den Kapiteln sind Lernquellen für Ereignisse und Einschränkungen. Sie dienen dazu zu zeigen, wie derselbe SDD-Zyklus sich bei Rollback-Risiko, Eskalation, Metriken und Modellbudget verhält.
Wenn im zweiten Band Production-Entitäten auftreten (appointments-api, node_not_ready, appointment_latency, appointment_latency_spike, high_memory_usage, autoscale_200pct, cdn_error_budget_burn, rate_limit_breach), sind sie wie folgt an AgentClinic gebunden. Für die Prüfungsroute verwenden Sie high_memory_usage als Hauptfall; die übrigen Zeichenketten helfen, lokale runnable-Beispiele zu verstehen, und erfordern kein separates Beweispaket.
| Lern-Code des ersten Bandes | Abgeleitetes Production-Szenario des zweiten Bandes |
|---|---|
Route GET / (Hello Hono, Teil 7) | node_not_ready: Repliken antworten nicht auf Readiness-Prüfung (health-check) |
| Agenten-Seite auf Hono JSX (Teil 11) | appointment_latency / appointment_latency_spike: Latenz der Route /agents |
| SQLite + Bewertungsmigrationen (Teil 12) | high_memory_usage: Lesespitze nach Deployment |
| Feedback-Formular (Teil 12) | rate_limit_breach: Strom identischer POST-Anfragen |
| MVP-Phase (Teil 12) | autoscale_200pct: plötzliche Lastzunahme |
| Agenten-Logbuch (Teil 11) | cdn_error_budget_burn: Abweichung der Dashboard-Metriken |
| Tonfall der Klinikbetreiber (Teil 6) | Schattenspezifikationen aus informellen Signalen |
Im README des Anwendungsbandes ist eine kurze Lesekarte und ein Verweis auf diesen Anhang gegeben. Die vollständige Domänentabelle lebt hier, damit beim Lesen jedes Kapitels des zweiten Bandes schnell nachvollziehbar ist, welchem Lern-Code welches Production-Symptom entspricht.
Was der zweite Band hinzufügt
| Ebene | Wo es im zweiten Band diskutiert wird |
|---|---|
| Laborrahmen AgentClinic-production und minimale Route | Teil 0. Labor AgentClinic-production |
| Wiederherstellung der Spezifikation aus Spuren eines Legacy-Systems | Teil 1. Spezifikationsarchäologie aus Legacy |
| Kontrollierte Defekte in der Spezifikation | Teil 2. Diagnose von Spezifikationsdefekten |
| Production-Konstitution mit unveränderlicher und veränderlicher Schicht | Teil 3. Projektkonstitution |
| Konkurrierende Validierung zwischen Rollen | Teil 4. LLM-Duell |
| Mutationstesten von Spezifikationen | Teil 5. Mutationstesten von Spezifikationen |
| Formalisierung impliziter Heuristiken | Teil 6. Auswahl von Schattenspezifikationen |
| Spezifikations-Gateway als obligatorisches Gate | Teil 7. Specification CI |
| Datei-Schiedsgericht für strittige Änderungen | Teil 8. Datei-Schiedsgericht für strittige Änderungen |
| Modell-Routing und gestufte Budgets | Teil 9. Gestufte Budgets |
| Paarige Wächter-Metriken anti-Goodhart | Teil 10. Metrikschutz vor Goodhart |
| Integration mit Production API und Auto-Remediation | Teil 11. Production API |
| Diagnosekarte der Antipatterns des Anwendungszyklus | Teil 12. Antipatterns des Production SDD |
| Abschließende Production-Prüfung und Beweispaket | Teil 13. Praktische Prüfung |
Die Tabelle oben ist genau jene Brücke, die das abstrakte Production-Szenario in eine Fortsetzung des Lernprojekts verwandelt. In einzelnen Kapiteln des zweiten Bandes (zum Beispiel in Teil 12 – Antipatterns des Production SDD) sind Verweise auf den ersten Band ebenfalls als eigener Block in der Fußzeile ausgewiesen; in den übrigen Kapiteln sind sie an der jeweiligen Stelle der Diskussion in den Text eingewoben.