Anhang A. Brücken zum ersten Band
Der angewandte Band baut auf dem Material des ersten Bandes auf. Dieser Anhang sammelt an einer Stelle alle Brücken: welche Teile des ersten Bandes als Voraussetzung gelten, wie unser SDD-Dialekt zu Spec Kit und Kiro in Beziehung steht und wie die Produktionsszenarien des zweiten Bandes aus dem Lernprojekt AgentClinic hervorgehen.
Wenn Ihnen etwas davon unbekannt ist — arbeiten Sie zuerst den entsprechenden Teil des ersten Bandes durch, sonst werden viele Kapitel des zweiten Bandes wie ein Wust von Fachbegriffen wirken.
Vor Kapitel 1 lesen Sie Teil 0. Er überführt das grundlegende AgentClinic in ein Lehr-Produktionsmodell und legt die Mindestroute fest: welche Artefakte manuell ausgefüllt werden, welche Beispiele lokal ausgeführt werden und welche Blöcke nur zum vollständigen Einführungspfad gehören.
Mindestens erforderlich, um den zweiten Band zu lesen
| Was Sie verstehen müssen | 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 |
| Fakten zur Merge-Freigabe, EARS, Given/When/Then | Teil 9. Feature-Validierung: von Spezifikationen zu Fakten | | Neuplanung und Aktualisierung der Roadmap | Teil 10. Projektneuplanung | | Wartung der Legacy-Codebasis und Spec-Archäologie | Teil 13. Wartung eines bestehenden Projekts | | Agenten-Austauschbarkeit, Verweise auf ACP/AGENTS.md | Teil 15. Agenten-Austauschbarkeit | | Team-Review und Beweispaket | Teil 16. Teamarbeit und Code-Review | | Qwen-Code-Hooks, PreToolUse und PostToolUse | Teil 17. Qwen-Code-Hooks | | SDD-Anti-Pattern | Teil 20. SDD-Anti-Pattern | | Praxisprüfung als Kontrolle des gesamten Prozesses | Teil 22. Praxisprüfung |
SDD-Dialekte: Spec Kit, Kiro, der Autorendialekt des Lehrbuchs
Der angewandte Band verwendet denselben Autorendialekt wie der erste Band. Ein detaillierter Vergleich mit GitHub Spec Kit und AWS Kiro findet sich in Anhang A des ersten Bandes: Tabelle der Artefaktentsprechungen, Empfehlungen zur Prozessübertragung, Einschränkungen jedes Formats.
Wenn das Team bereits mit Spec Kit oder Kiro arbeitet, lesen Sie die Kapitel des zweiten Bandes und benennen Sie gedanklich um: requirements.md → /speckit.specify, plan.md → /speckit.plan + /speckit.tasks, validation.md → /speckit.analyze + Checklisten. Die Kapitel sind nicht starr an ein Format gebunden: Ihre Ideen lassen sich zwischen den Dialekten ohne Bedeutungsverlust übertragen.
Domänenkarte von AgentClinic
Die Produktionsszenarien des zweiten Bandes entfalten sich gedanklich auf dem Lernprojekt AgentClinic aus dem ersten Band. Eine vollständige Beschreibung der Domänenentitäten — Patienten-Agenten, Beschwerden, Therapien, Termine, Bewertungen, Feedback — ist in Anhang B des ersten Bandes zusammengestellt.
Der zweite Band setzt nicht voraus, dass das Ergebnis des ersten Bandes bereits in einer echten Produktionsinfrastruktur läuft. Alle externen Systeme in den Kapiteln sind didaktische Quellen für Ereignisse und Einschränkungen. Sie dienen dazu zu zeigen, wie sich derselbe SDD-Zyklus bei Risiko von Rollback, Eskalation, Metriken und Modellbudget verhält.
Wenn im zweiten Band Produktionsentitäten auftauchen (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 den Prüfungspfad verwenden Sie high_memory_usage als Hauptfall; die übrigen Zeilen helfen, die lokalen lauffähigen Beispiele zu verstehen, und erfordern kein eigenes Beweispaket.
| Lerncode des ersten Bandes | Abgeleitetes Produktionsszenario des zweiten Bandes |
|---|---|
Route GET / (Hello Hono, Teil 7) | node_not_ready: Repliken antworten nicht auf die Bereitschaftsprüfung (Health-Check) |
| Agenten-Seite mit Hono JSX (Teil 11) | appointment_latency / appointment_latency_spike: Latenz der Route /agents |
| SQLite + Migrationen der Bewertungen (Teil 12) | high_memory_usage: Lesespitze nach dem Deployment |
| Feedback-Formular (Teil 12) | rate_limit_breach: Strom identischer POST-Anfragen | | MVP-Phase (Teil 12) | autoscale_200pct: plötzlicher Lastanstieg | | Agenten-Log (Teil 11) | cdn_error_budget_burn: Abweichung der Dashboard-Metriken | | Tonfall des Klinikbetreibers (Teil 6) | Schattenspezifikationen aus informellen Signalen |
In der README des angewandten Bandes finden Sie eine kurze Lesekarte und einen Verweis auf diesen Anhang. Die vollständige Domänentabelle befindet sich hier, damit Sie beim Lesen eines beliebigen Kapitels des zweiten Bandes schnell nachschlagen können, welchem Lerncode ein Produktionssymptom entspricht.
Was der zweite Band zusätzlich hinzugefügt hat
| Schicht | Wo es im zweiten Band behandelt wird |
|---|---|
| Lab-Rahmen von AgentClinic-Produktion und Mindestpfad | Teil 0. AgentClinic-Produktionslabor |
| Wiederherstellung der Spezifikation aus Legacy-Systemspuren | Teil 1. Wiederherstellung von Spezifikationen aus Legacy |
| Kontrollierte Defekte in der Spezifikation | Teil 2. Diagnose von Spezifikationsdefekten |
| Produktionskonstitution mit unveränderlichen und veränderlichen Schichten | Teil 3. Projektkonstitution | | Adversative Validierung zwischen Rollen | Teil 4. LLM-Duell | | Mutationstests von Spezifikationen | Teil 5. Mutationstests 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 gestaffelte Budgets | Teil 9. Gestaffelte Budgets | | Anti-Goodhart-Wächtermetriken als Paare | Teil 10. Schutz von Metriken vor Goodhart | | Integration mit Produktions-API und automatische Behebung | Teil 11. Produktions-API | | Diagnosekarte der Anti-Pattern des angewandten Zyklus | Teil 12. Anti-Pattern des Produktions-SDD |
| Abschließende Produktionsprüfung und Beweispaket | Teil 13. Praxisprüfung |
Die obige Tabelle ist die Brücke, die ein abstraktes Produktionsszenario in die Fortsetzung des Lernprojekts verwandelt. In einzelnen Kapiteln des zweiten Bandes (zum Beispiel in Teil 12 — Anti-Pattern des Produktions-SDD) sind die Verweise auf den ersten Band ebenfalls als separater Block in die Fußzeile ausgelagert; in den übrigen Kapiteln sind sie an der jeweiligen Diskussionsstelle in den Text eingeflochten.