Skip to content

Commit 6561ed3

Browse files
raifdmuellerclaude
andcommitted
docs: add ADR admonition to Skills documentation
Add IMPORTANT block to both DE/EN Skills sections explaining that risk assessments should be documented as ADRs nach Nygard. Content: - /risk-assess offers automatic ADR generation (optional) - ADR saved to docs/adr/, referenced in arc42 chapter 9 if present - /risk-mitigate updates ADR with mitigation status - Why ADRs: transparency, traceability, reviewability Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent 10c07f3 commit 6561ed3

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

src/i18n.js

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -333,6 +333,17 @@ Dieses Framework bietet eine https://github.com/LLM-Coding/Semantic-Anchors?tab=
333333
334334
*/risk-mitigate* — Liest die Risikobewertung aus \`CLAUDE.md\`, erkennt bereits vorhandene Maßnahmen (Linter, CI, SAST etc.) und hilft fehlende Mitigations Schritt für Schritt umzusetzen — von Tool-Installation bis CI-Konfiguration.
335335
336+
[IMPORTANT]
337+
====
338+
*Risk-Assessments sind Architekturentscheidungen*
339+
340+
Tier-Klassifizierungen und Mitigation-Strategien sollten als https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions[Architecture Decision Records (ADR nach Nygard)] dokumentiert werden.
341+
342+
\`/risk-assess\` bietet automatische ADR-Generierung an (optional). Der ADR wird in \`docs/adr/\` gespeichert und — falls vorhanden — in arc42 Kapitel 9 referenziert. \`/risk-mitigate\` aktualisiert den ADR mit dem Umsetzungsstatus der Maßnahmen.
343+
344+
*Warum ADRs?* Transparenz (warum wurde Tier X gewählt?), Nachvollziehbarkeit (wer hat wann entschieden?), Reviewbarkeit (Team kann vor Umsetzung diskutieren).
345+
====
346+
336347
*Installation — Plugin (empfohlen):*
337348
338349
\`\`\`
@@ -684,6 +695,17 @@ This framework provides a https://github.com/LLM-Coding/Semantic-Anchors?tab=rea
684695
685696
*/risk-mitigate* — Reads the risk assessment from \`CLAUDE.md\`, detects already-present measures (linter, CI, SAST, etc.), and helps implement missing mitigations step by step — from tool installation to CI configuration.
686697
698+
[IMPORTANT]
699+
====
700+
*Risk Assessments are Architectural Decisions*
701+
702+
Tier classifications and mitigation strategies should be documented as https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions[Architecture Decision Records (ADR nach Nygard)].
703+
704+
\`/risk-assess\` offers automatic ADR generation (optional). The ADR is saved to \`docs/adr/\` and — if present — referenced in arc42 chapter 9. \`/risk-mitigate\` updates the ADR with mitigation implementation status.
705+
706+
*Why ADRs?* Transparency (why was Tier X chosen?), traceability (who decided when?), reviewability (team can discuss before implementation).
707+
====
708+
687709
*Installation — Plugin (recommended):*
688710
689711
\`\`\`

0 commit comments

Comments
 (0)