Skip to content

Commit 30c05a0

Browse files
Copilotrdmueller
andcommitted
feat: Add LASR nach Toth/Zörner semantic anchor (#134)
Co-authored-by: rdmueller <1856308+rdmueller@users.noreply.github.com>
1 parent 64cf411 commit 30c05a0

File tree

8 files changed

+154
-13
lines changed

8 files changed

+154
-13
lines changed

docs/all-anchors.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,6 +115,8 @@ include::anchors/gom.adoc[leveloffset=+2]
115115

116116
include::anchors/hexagonal-architecture.adoc[leveloffset=+2]
117117

118+
include::anchors/lasr.adoc[leveloffset=+2]
119+
118120
include::anchors/madr.adoc[leveloffset=+2]
119121

120122
<<<

docs/anchors/lasr.adoc

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
= LASR nach Toth/Zörner
2+
:categories: software-architecture
3+
:roles: software-architect, software-developer, technical-writer, team-lead, consultant
4+
:related: arc42, adr-according-to-nygard, c4-diagrams
5+
:proponents: Stefan Toth, Oliver Zörner
6+
:tags: architecture-documentation, solution-strategy, interfaces, risks, lightweight, communication
7+
8+
[%collapsible]
9+
====
10+
Full Name:: LASR – Lightweight Architecture Documentation by Toth/Zörner
11+
12+
Also known as:: Lightweight Architecture Communication, LASR Template
13+
14+
[discrete]
15+
== *Core Concepts*:
16+
17+
L – Lösungsstrategie (Solution Strategy):: High-level description of how the solution addresses the most important quality requirements and constraints; the central architectural ideas that shape the system
18+
19+
A – Architekturüberblick (Architecture Overview):: Key structural and runtime views showing the main building blocks, their responsibilities, and how they interact at runtime
20+
21+
S – Schnittstellen (Interfaces):: Definition of all relevant external interfaces (APIs, protocols, data formats) and important internal interfaces between major components
22+
23+
R – Risiken (Risks):: Identification of the most critical technical risks, open questions, and known weaknesses together with proposed mitigation strategies
24+
25+
Lightweight by design:: LASR intentionally focuses on the four most communication-relevant aspects of an architecture, omitting detail that does not aid stakeholder understanding
26+
27+
Living document:: Updated alongside the architecture; meant to communicate current state, not archive history
28+
29+
Key Proponents:: Stefan Toth ("Vorgehensmuster für Softwarearchitektur"), Oliver Zörner ("Softwarearchitekturen dokumentieren und kommunizieren")
30+
31+
[discrete]
32+
== *When to Use*:
33+
34+
* Communicating architecture to stakeholders who need a concise overview rather than full documentation
35+
* Agile projects where a lightweight alternative to arc42 is preferred
36+
* Architecture reviews where the four LASR aspects serve as a structured review checklist
37+
* Onboarding new team members to an existing system's key design decisions
38+
* Workshops where teams collaboratively capture the essential architecture decisions
39+
40+
[discrete]
41+
== *Related Anchors*:
42+
43+
* <<arc42,arc42 Architecture Documentation>>
44+
* <<adr-according-to-nygard,ADR according to Nygard>>
45+
* <<c4-diagrams,C4 Diagrams>>
46+
====

docs/anchors/lasr.de.adoc

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
= LASR nach Toth/Zörner
2+
:categories: software-architecture
3+
:roles: software-architect, software-developer, technical-writer, team-lead, consultant
4+
:related: arc42, adr-according-to-nygard, c4-diagrams
5+
:proponents: Stefan Toth, Oliver Zörner
6+
:tags: architecture-documentation, solution-strategy, interfaces, risks, lightweight, communication
7+
8+
[%collapsible]
9+
====
10+
Vollständiger Name:: LASR – Leichtgewichtige Architekturdokumentation nach Toth/Zörner
11+
12+
Auch bekannt als:: Leichtgewichtige Architekturkommunikation, LASR-Template
13+
14+
[discrete]
15+
== *Kernkonzepte*:
16+
17+
L – Lösungsstrategie:: Übergeordnete Beschreibung, wie die Lösung die wichtigsten Qualitätsanforderungen und Randbedingungen adressiert; die zentralen Architekturideen, die das System prägen
18+
19+
A – Architekturüberblick:: Wesentliche Struktur- und Laufzeitsichten mit den wichtigsten Bausteinen, deren Verantwortlichkeiten und ihrer Interaktion zur Laufzeit
20+
21+
S – Schnittstellen:: Definition aller relevanten Außenschnittstellen (APIs, Protokolle, Datenformate) sowie wichtiger interner Schnittstellen zwischen den Hauptkomponenten
22+
23+
R – Risiken:: Identifikation der kritischsten technischen Risiken, offener Fragen und bekannter Schwächen zusammen mit vorgeschlagenen Maßnahmen zur Risikoreduzierung
24+
25+
Bewusst leichtgewichtig:: LASR konzentriert sich gezielt auf die vier kommunikationsrelevantesten Aspekte einer Architektur und verzichtet auf Details, die das Stakeholder-Verständnis nicht verbessern
26+
27+
Lebendes Dokument:: Wird parallel zur Architektur aktualisiert; dient der Kommunikation des aktuellen Stands, nicht der Archivierung von Geschichte
28+
29+
Schlüsselvertreter:: Stefan Toth („Vorgehensmuster für Softwarearchitektur"), Oliver Zörner („Softwarearchitekturen dokumentieren und kommunizieren")
30+
31+
[discrete]
32+
== *Wann zu verwenden*:
33+
34+
* Kommunikation der Architektur an Stakeholder, die einen prägnanten Überblick statt vollständiger Dokumentation benötigen
35+
* Agile Projekte, in denen eine leichtgewichtige Alternative zu arc42 bevorzugt wird
36+
* Architektur-Reviews, bei denen die vier LASR-Aspekte als strukturierte Review-Checkliste dienen
37+
* Einarbeitung neuer Teammitglieder in die wesentlichen Entwurfsentscheidungen eines bestehenden Systems
38+
* Workshops, in denen Teams gemeinsam die wesentlichen Architekturentscheidungen erfassen
39+
40+
[discrete]
41+
== *Verwandte Anker*:
42+
43+
* <<arc42,arc42 Architekturdokumentation>>
44+
* <<adr-according-to-nygard,ADR nach Nygard>>
45+
* <<c4-diagrams,C4-Diagramme>>
46+
====

docs/metadata/roles.yml

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,15 @@ hexagonal-architecture:
104104
- software-developer
105105
rationale: "Architectural pattern; architects design, developers implement ports/adapters"
106106

107+
lasr:
108+
roles:
109+
- software-architect
110+
- software-developer
111+
- technical-writer
112+
- team-lead
113+
- consultant
114+
rationale: "Lightweight architecture documentation; architects create LASR docs, developers contribute interface and risk sections, tech writers format, team leads use for onboarding, consultants teach the approach"
115+
107116
clean-architecture:
108117
roles:
109118
- software-architect
@@ -386,17 +395,17 @@ feynman-technique:
386395

387396
# SUMMARY STATISTICS
388397

389-
# Total anchors mapped: 50
398+
# Total anchors mapped: 51
390399
#
391400
# Roles by frequency:
392-
# - software-developer: 25 anchors (50%)
393-
# - team-lead: 21 anchors (42%)
394-
# - software-architect: 18 anchors (36%)
395-
# - consultant: 16 anchors (32%)
396-
# - qa-engineer: 14 anchors (28%)
397-
# - business-analyst: 13 anchors (26%)
401+
# - software-developer: 26 anchors (51%)
402+
# - team-lead: 22 anchors (43%)
403+
# - software-architect: 19 anchors (37%)
404+
# - consultant: 17 anchors (33%)
405+
# - qa-engineer: 14 anchors (27%)
406+
# - business-analyst: 13 anchors (25%)
398407
# - devops-engineer: 10 anchors (20%)
399-
# - technical-writer: 9 anchors (18%)
408+
# - technical-writer: 10 anchors (20%)
400409
# - product-owner: 8 anchors (16%)
401410
# - data-scientist: 7 anchors (14%)
402411
# - educator: 7 anchors (14%)

website/public/data/anchors.json

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -482,6 +482,38 @@
482482
"tags": [],
483483
"filePath": "docs/anchors/jobs-to-be-done.adoc"
484484
},
485+
{
486+
"id": "lasr",
487+
"title": "LASR nach Toth/Zörner",
488+
"categories": [
489+
"software-architecture"
490+
],
491+
"roles": [
492+
"software-architect",
493+
"software-developer",
494+
"technical-writer",
495+
"team-lead",
496+
"consultant"
497+
],
498+
"related": [
499+
"arc42",
500+
"adr-according-to-nygard",
501+
"c4-diagrams"
502+
],
503+
"proponents": [
504+
"Stefan Toth",
505+
"Oliver Zörner"
506+
],
507+
"tags": [
508+
"architecture-documentation",
509+
"solution-strategy",
510+
"interfaces",
511+
"risks",
512+
"lightweight",
513+
"communication"
514+
],
515+
"filePath": "docs/anchors/lasr.adoc"
516+
},
485517
{
486518
"id": "madr",
487519
"title": "MADR",

website/public/data/categories.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,7 @@
8989
"domain-driven-design",
9090
"gom",
9191
"hexagonal-architecture",
92+
"lasr",
9293
"madr"
9394
]
9495
},

website/public/data/metadata.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
{
2-
"generatedAt": "2026-03-04T12:59:17.826Z",
2+
"generatedAt": "2026-03-06T17:54:22.119Z",
33
"version": "1.0.0",
44
"counts": {
5-
"anchors": 54,
5+
"anchors": 55,
66
"categories": 12,
77
"roles": 12
88
},
99
"statistics": {
10-
"averageRolesPerAnchor": "3.33",
10+
"averageRolesPerAnchor": "3.36",
1111
"averageCategoriesPerAnchor": "1.00",
12-
"anchorsWithTags": 9,
13-
"anchorsWithRelated": 8
12+
"anchorsWithTags": 10,
13+
"anchorsWithRelated": 9
1414
}
1515
}

website/public/data/roles.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,7 @@
3333
"gom",
3434
"iec-61508-sil-levels",
3535
"impact-mapping",
36+
"lasr",
3637
"mece",
3738
"mental-model-according-to-naur",
3839
"morphological-box",
@@ -144,6 +145,7 @@
144145
"gom",
145146
"hexagonal-architecture",
146147
"iec-61508-sil-levels",
148+
"lasr",
147149
"madr",
148150
"mece",
149151
"morphological-box",
@@ -175,6 +177,7 @@
175177
"fowler-patterns",
176178
"hexagonal-architecture",
177179
"iec-61508-sil-levels",
180+
"lasr",
178181
"madr",
179182
"mental-model-according-to-naur",
180183
"morphological-box",
@@ -212,6 +215,7 @@
212215
"fowler-patterns",
213216
"gom",
214217
"impact-mapping",
218+
"lasr",
215219
"madr",
216220
"mental-model-according-to-naur",
217221
"moscow",
@@ -237,6 +241,7 @@
237241
"diataxis-framework",
238242
"docs-as-code",
239243
"ears-requirements",
244+
"lasr",
240245
"pyramid-principle",
241246
"todotxt-flavoured-markdown"
242247
]

0 commit comments

Comments
 (0)