Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 24 additions & 24 deletions docs/spec-driven-workflow.de.html
Original file line number Diff line number Diff line change
Expand Up @@ -544,7 +544,7 @@ <h2 id="_einleitung">Einleitung</h2>
</td>
<td class="content">
<div class="paragraph">
<p>Semantic Anchors sind im Dokument mit <span class="icon"><i class="fa fa-anchor"></i></span> gekennzeichnet.
<p>Semantic Anchors sind im Dokument mit gekennzeichnet.
Ein Klick auf einen Anker führt zur vollständigen Definition auf der Semantic Anchors Website.</p>
</div>
</td>
Expand Down Expand Up @@ -613,16 +613,16 @@ <h2 id="_querschnittsthemen">Querschnittsthemen</h2>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1"><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/plain-english-strunk-white"><strong>Plain English nach Strunk &amp; White</strong></a></dt>
<dt class="hdlist1"> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/plain-english-strunk-white"><strong>Plain English nach Strunk &amp; White</strong></a></dt>
<dd>
<p>Alle Dokumentation verwendet kurze Sätze, aktive Sprache und keine überflüssigen Wörter.
Für deutschsprachige Dokumentation gilt analog <span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/gutes-deutsch-wolf-schneider"><strong>Gutes Deutsch nach Wolf Schneider</strong></a>.</p>
Für deutschsprachige Dokumentation gilt analog <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/gutes-deutsch-wolf-schneider"><strong>Gutes Deutsch nach Wolf Schneider</strong></a>.</p>
</dd>
<dt class="hdlist1"><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/conventional-commits"><strong>Conventional Commits</strong></a></dt>
<dt class="hdlist1"> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/conventional-commits"><strong>Conventional Commits</strong></a></dt>
<dd>
<p>Alle Commits folgen einem standardisierten Format für eine saubere, maschinenlesbare Git-History.</p>
</dd>
<dt class="hdlist1"><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/docs-as-code"><strong>Docs-as-Code nach Ralf D. Müller</strong></a></dt>
<dt class="hdlist1"> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/docs-as-code"><strong>Docs-as-Code nach Ralf D. Müller</strong></a></dt>
<dd>
<p>Dokumentation lebt im Repository als AsciiDoc, gebaut von <a href="https://doctoolchain.org">docToolchain</a>.
Docs-as-Code behandelt Dokumentation wie Quellcode: versioniert, reviewt und automatisch gebaut.</p>
Expand All @@ -647,7 +647,7 @@ <h2 id="_voraussetzungen">Voraussetzungen</h2>
<p>Git-Repository initialisieren</p>
</li>
<li>
<p><a href="https://doctoolchain.org">docToolchain</a> installieren und das <span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/arc42"><strong>arc42</strong></a>-Template herunterladen</p>
<p><a href="https://doctoolchain.org">docToolchain</a> installieren und das <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/arc42"><strong>arc42</strong></a>-Template herunterladen</p>
</li>
<li>
<p>KI-Coding-Umgebung mit einer <code>AGENTS.md</code> konfigurieren (oder toolspezifisches Äquivalent wie <code>CLAUDE.md</code>)</p>
Expand Down Expand Up @@ -761,7 +761,7 @@ <h3 id="_schritt_1_vision_beschreiben">Schritt 1: Vision beschreiben</h3>
<div class="sect2">
<h3 id="_schritt_2_anforderungen_mit_der_sokratischen_methode_klären">Schritt 2: Anforderungen mit der Sokratischen Methode klären</h3>
<div class="paragraph">
<p>Die KI auffordern, die <span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/socratic-method"><strong>Sokratische Methode</strong></a> zur Klärung der Anforderungen zu nutzen.</p>
<p>Die KI auffordern, die <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/socratic-method"><strong>Sokratische Methode</strong></a> zur Klärung der Anforderungen zu nutzen.</p>
</div>
<div class="listingblock">
<div class="content">
Expand All @@ -783,7 +783,7 @@ <h3 id="_schritt_2_anforderungen_mit_der_sokratischen_methode_klären">Schritt 2
</div>
</div>
<div class="paragraph">
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/mece"><strong>MECE</strong></a> (Mutually Exclusive, Collectively Exhaustive) stellt sicher, dass die Fragen alle Bereiche überlappungsfrei abdecken.</p>
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/mece"><strong>MECE</strong></a> (Mutually Exclusive, Collectively Exhaustive) stellt sicher, dass die Fragen alle Bereiche überlappungsfrei abdecken.</p>
</div>
<div class="paragraph">
<p>Den Dialog fortführen, bis man mit der KI zufrieden ist, dass die Anforderungen klar sind.</p>
Expand Down Expand Up @@ -817,7 +817,7 @@ <h3 id="_schritt_4_detaillierte_spezifikation_erstellen">Schritt 4: Detaillierte
</div>
</div>
<div class="paragraph">
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/gherkin"><strong>Gherkin</strong></a> (Given/When/Then) liefert Akzeptanzkriterien, die sowohl für Menschen lesbar als auch maschinell testbar sind.
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/gherkin"><strong>Gherkin</strong></a> (Given/When/Then) liefert Akzeptanzkriterien, die sowohl für Menschen lesbar als auch maschinell testbar sind.
Diese Kriterien werden später die Grundlage für TDD.</p>
</div>
<div class="paragraph">
Expand All @@ -842,21 +842,21 @@ <h3 id="_schritt_5_arc42_architekturdokumentation_erstellen">Schritt 5: arc42-Ar
</div>
</div>
<div class="paragraph">
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/arc42"><strong>arc42</strong></a> bietet 12 Abschnitte, die alles von Kontextabgrenzung bis Deployment abdecken.
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/arc42"><strong>arc42</strong></a> bietet 12 Abschnitte, die alles von Kontextabgrenzung bis Deployment abdecken.
Die KI kennt die Template-Struktur und füllt sie passend.</p>
</div>
<div class="paragraph">
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/c4-diagrams"><strong>C4 Diagrams</strong></a> kombiniert mit PlantUML ermöglichen textbasierte Architektur-Visualisierung auf vier Ebenen: Context, Container, Component, Code.
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/c4-diagrams"><strong>C4 Diagrams</strong></a> kombiniert mit PlantUML ermöglichen textbasierte Architektur-Visualisierung auf vier Ebenen: Context, Container, Component, Code.
Die KI kann diese Diagramme ohne grafische Tools erstellen und ändern.</p>
</div>
<div class="sect3">
<h4 id="_architecture_decision_records">Architecture Decision Records</h4>
<div class="paragraph">
<p>Architekturentscheidungen werden als <span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/adr-according-to-nygard"><strong>ADRs nach Nygard</strong></a> dokumentiert.
<p>Architekturentscheidungen werden als <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/adr-according-to-nygard"><strong>ADRs nach Nygard</strong></a> dokumentiert.
Jedes ADR folgt der Struktur: Titel, Status, Kontext, Entscheidung, Konsequenzen.</p>
</div>
<div class="paragraph">
<p>Für jede Entscheidung wird eine <span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/pugh-matrix"><strong>Pugh-Matrix</strong></a> mit 3-Punkt-Skala (-1, 0, +1) erstellt, um Alternativen gegen Qualitätskriterien zu bewerten.</p>
<p>Für jede Entscheidung wird eine <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/pugh-matrix"><strong>Pugh-Matrix</strong></a> mit 3-Punkt-Skala (-1, 0, +1) erstellt, um Alternativen gegen Qualitätskriterien zu bewerten.</p>
</div>
<div class="listingblock">
<div class="content">
Expand All @@ -878,7 +878,7 @@ <h4 id="_architecture_decision_records">Architecture Decision Records</h4>
<div class="sect2">
<h3 id="_schritt_6_architektur_review_atam">Schritt 6: Architektur-Review (ATAM)</h3>
<div class="paragraph">
<p>Ein Architektur-Review mit der <span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/atam"><strong>Architecture Tradeoff Analysis Method (ATAM)</strong></a> durchführen:</p>
<p>Ein Architektur-Review mit der <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/atam"><strong>Architecture Tradeoff Analysis Method (ATAM)</strong></a> durchführen:</p>
</div>
<div class="listingblock">
<div class="content">
Expand Down Expand Up @@ -912,10 +912,10 @@ <h3 id="_schritt_7_backlog_erstellen">Schritt 7: Backlog erstellen</h3>
</div>
</div>
<div class="paragraph">
<p><span class="icon"><i class="fa fa-anchor"></i></span> <strong>INVEST</strong> stellt sicher, dass User Stories Independent, Negotiable, Valuable, Estimable, Small und Testable sind.</p>
<p> <strong>INVEST</strong> stellt sicher, dass User Stories Independent, Negotiable, Valuable, Estimable, Small und Testable sind.</p>
</div>
<div class="paragraph">
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/moscow"><strong>MoSCoW</strong></a> (Must have, Should have, Could have, Won&#8217;t have) liefert klare Priorisierung.</p>
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/moscow"><strong>MoSCoW</strong></a> (Must have, Should have, Could have, Won&#8217;t have) liefert klare Priorisierung.</p>
</div>
<div class="paragraph">
<p>Die initiale Backlog-Reihenfolge folgt der EPIC-Sequenz.
Expand Down Expand Up @@ -969,15 +969,15 @@ <h3 id="_schritt_8_issue_für_issue_implementieren">Schritt 8: Issue für Issue
</ol>
</div>
<div class="paragraph">
<p><span class="icon"><i class="fa fa-anchor"></i></span> <strong>TDD</strong> (Test-Driven Development) gibt es in zwei Schulen:</p>
<p> <strong>TDD</strong> (Test-Driven Development) gibt es in zwei Schulen:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/tdd-london-school"><strong>London School</strong></a> (Mockist): Unit Under Test isolieren, Abhängigkeiten mocken. Gut für interaktionslastigen Code.</p>
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/tdd-london-school"><strong>London School</strong></a> (Mockist): Unit Under Test isolieren, Abhängigkeiten mocken. Gut für interaktionslastigen Code.</p>
</li>
<li>
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/tdd-chicago-school"><strong>Chicago School</strong></a> (Classicist): Verhalten über die öffentliche API testen, echte Kollaborateure nutzen. Gut für zustandsbasierte Logik.</p>
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/tdd-chicago-school"><strong>Chicago School</strong></a> (Classicist): Verhalten über die öffentliche API testen, echte Kollaborateure nutzen. Gut für zustandsbasierte Logik.</p>
</li>
</ul>
</div>
Expand All @@ -990,16 +990,16 @@ <h3 id="_schritt_8_issue_für_issue_implementieren">Schritt 8: Issue für Issue
<div class="ulist">
<ul>
<li>
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/dry-principle"><strong>DRY</strong></a> (Don&#8217;t Repeat Yourself)</p>
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/dry-principle"><strong>DRY</strong></a> (Don&#8217;t Repeat Yourself)</p>
</li>
<li>
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/solid-principles"><strong>SOLID</strong></a>-Prinzipien</p>
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/solid-principles"><strong>SOLID</strong></a>-Prinzipien</p>
</li>
<li>
<p><span class="icon"><i class="fa fa-anchor"></i></span> <strong>KISS</strong> (Keep It Simple, Stupid)</p>
<p> <strong>KISS</strong> (Keep It Simple, Stupid)</p>
</li>
<li>
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/domain-driven-design"><strong>Ubiquitous Language</strong></a> aus Domain-Driven Design: dieselben Begriffe im Code wie in der Spezifikation</p>
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/domain-driven-design"><strong>Ubiquitous Language</strong></a> aus Domain-Driven Design: dieselben Begriffe im Code wie in der Spezifikation</p>
</li>
</ul>
</div>
Expand Down Expand Up @@ -1084,7 +1084,7 @@ <h3 id="_schritt_10_security_review">Schritt 10: Security Review</h3>
</div>
</div>
<div class="paragraph">
<p><span class="icon"><i class="fa fa-anchor"></i></span> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/owasp-top-10"><strong>OWASP Top 10</strong></a> deckt die kritischsten Sicherheitsrisiken für Webanwendungen ab.
<p> <a href="https://llm-coding.github.io/Semantic-Anchors/#/anchor/owasp-top-10"><strong>OWASP Top 10</strong></a> deckt die kritischsten Sicherheitsrisiken für Webanwendungen ab.
Auch für CLI-Tools oder Libraries identifiziert die Methodik gängige Schwachstellenmuster.</p>
</div>
</div>
Expand Down
Loading
Loading