senior-architect
von alirezarezvanisenior-architect ist ein Software-Architecture-Skill für Systemdesign, ADRs, Stack-Entscheidungen, Skalierbarkeits-Reviews, Dependency Analysis und Architekturdiagramme mit enthaltenen Python-Skripten und Referenzen.
Dieser Skill erreicht 84/100 Punkte und ist damit ein überzeugender Kandidat für Verzeichnisnutzer, die einen Agenten für Architekturentwurf, Reviews und Analysen mit wiederverwendbaren Workflows und unterstützenden Skripten suchen. Er bietet genügend Trigger-Hinweise, Referenzmaterial und ausführbare Tools, um deutlich nützlicher zu sein als ein generischer Prompt. Nutzer sollten jedoch beachten, dass Installationsanweisungen fehlen und die Analysewerkzeuge heuristisch arbeiten.
- Sehr gute Auslösbarkeit: Das Frontmatter nennt ausdrücklich typische Nutzerabsichten wie Systemarchitektur-Design, Bewertung von Microservices vs Monolith, Datenbankauswahl, Dependency Analysis, ADRs und Diagrammerstellung.
- Solide operative Substanz: SKILL.md enthält Quick-Start-Befehle, Tool-Übersichten, Entscheidungs-Workflows, gängige Befehle und Links zur Referenzdokumentation.
- Hoher Nutzwert für Agenten: Drei Skripte unterstützen Architekturdiagramme, Dependency Analysis und Projektarchitektur-Bewertungen; die Referenzen liefern Trade-offs zu Patterns, System-Design-Workflows und Matrizen für Technologieentscheidungen.
- Im Skill-Pfad gibt es keinen Installationsbefehl und kein README. Nutzer müssen daher ggf. selbst ableiten, wie sie den Skill in ihrem Agent/Claude-Skills-Setup kopieren oder ausführen.
- Die Analyse-Skripte wirken heuristisch und musterbasierend. Ihre Ergebnisse sollten daher als Hilfen für Architektur-Reviews verstanden werden, nicht als endgültige Systembewertungen.
Überblick über den senior-architect skill
Wofür senior-architect gedacht ist
senior-architect ist ein Software-Architecture-skill, der vage Systemdesign-Fragen in strukturierte Architekturentscheidungen, Diagramme, Dependency-Reviews und Implementierungs-Trade-offs überführt. Der senior-architect skill eignet sich besonders für Nutzer, die einen Architekturplan, ADR-ähnliche Begründungen, Stack-Vergleiche, Skalierbarkeitsreviews oder eine Architekturbeurteilung auf Codebase-Ebene benötigen — nicht nur eine allgemeine Brainstorming-Antwort.
Passende Nutzer und typische Aufgaben
Nutzen Sie den senior-architect skill, wenn Sie zwischen Monolith, modular monolith, microservices, event-driven, CQRS, hexagonal oder clean architecture patterns entscheiden. Er ist außerdem hilfreich für Teams, die ein bestehendes Repository prüfen, weil die enthaltenen Python-Skripte die Projektstruktur scannen, Architekturschichten ableiten, Kopplung erkennen und Mermaid-, PlantUML- oder ASCII-Diagramme erzeugen können.
Was den skill anders macht
Der skill kombiniert Prompt-Anleitung mit konkretem Repository-Tooling. Die Referenzen decken Architekturpatterns, Systemdesign-Workflows und Technologiematrizen für Entscheidungen ab; die Skripte liefern Projektdiagramme, Dependency-Analysen und Architekturbewertungen. Damit ist er praktischer als ein einfacher „act as a senior architect“-Prompt, wenn Sie belastbare Hinweise aus einer Codebase brauchen.
Wichtige Einschränkungen bei der Einführung
Die Skripte sind heuristische Scanner, keine formalen Architekturvalidatoren. Sie funktionieren am besten mit konventionellen Projektstrukturen und gängigen Ökosystemen wie Node, Python, Go, Rust, Java, Docker und Kubernetes. Bei stark angepassten Monorepos sollte die generierte Ausgabe als Ausgangspunkt für ein Review verstanden werden, nicht als endgültige Entscheidungsgrundlage.
So verwenden Sie den senior-architect skill
senior-architect installieren und die ersten Dateien lesen
Installieren Sie den skill aus dem GitHub skill directory mit:
npx skills add alirezarezvani/claude-skills --skill senior-architect
Lesen Sie nach der Installation zuerst SKILL.md, um Trigger-Scope und Befehlsbeispiele zu verstehen. Sehen Sie sich anschließend diese Dateien an:
references/architecture_patterns.mdfür Pattern-Trade-offs und Hinweise, wann ein Pattern nicht verwendet werden solltereferences/system_design_workflows.mdfür Workflows zu Capacity Planning, API-Design, Migration und Skalierbarkeitreferences/tech_decision_guide.mdfür Entscheidungen zu Datenbank, Caching, Queue, Auth, Frontend, Cloud und API-Stilscripts/architecture_diagram_generator.pyscripts/dependency_analyzer.pyscripts/project_architect.py
Dieser Lesepfad hilft Ihnen, sowohl das Entscheidungsframework als auch die ausführbaren Analysewerkzeuge zu verstehen, bevor Sie sich auf die Ergebnisse stützen.
Eingaben, die bessere Architektur-Ergebnisse liefern
Der senior-architect skill funktioniert am besten, wenn Sie sowohl den geschäftlichen Kontext als auch die technischen Rahmenbedingungen angeben. Ein schwacher Prompt wäre: „Design a scalable backend.“ Ein deutlich stärkerer Prompt ist:
Use senior-architect for Software Architecture. Design an architecture for a B2B analytics app with 50k tenants, 5M daily events, PostgreSQL today, Python/FastAPI backend, React frontend, AWS deployment, 99.9% availability target, small team of 6, and a requirement to support tenant-level data isolation. Compare modular monolith vs microservices, include risks, ADR summary, and a Mermaid component diagram.
Hilfreiche Eingaben sind erwartete Nutzerzahlen, Request-Volumen, Read/Write-Verhältnis, Latenzziel, Verfügbarkeitsziel, Datenaufbewahrung, Compliance-Anforderungen, Teamgröße, Deployment-Umgebung, aktueller Stack, Migrationsbeschränkungen und bereits verworfene Optionen.
Praktischer Workflow mit senior-architect
Für ein neues System starten Sie mit den Referenz-Workflows: funktionale Anforderungen klären, Größenordnung abschätzen, nicht-funktionale Anforderungen identifizieren und anschließend nach Architekturvorschlägen mit Trade-offs fragen. Für eine bestehende Codebase sollten Sie zuerst die Skripte ausführen, bevor Sie Empfehlungen anfordern:
python scripts/architecture_diagram_generator.py ./my-project --format mermaid
python scripts/dependency_analyzer.py ./my-project --output json
python scripts/project_architect.py ./my-project --verbose
Fügen Sie die relevantesten Ergebnisse in Ihren Prompt ein: erkanntes Pattern, Kopplungswert, zirkuläre Abhängigkeiten, fehlende Schichten, Package Manager und etwaige Empfehlungen. So erhält das Modell belastbare Hinweise, statt die Architektur aus einer vagen Beschreibung ableiten zu müssen.
Prompt-Muster für Entscheidungen und Reviews
Fragen Sie bei Designentscheidungen nach einem expliziten Entscheidungsformat: Kontext, Optionen, Entscheidungskriterien, empfohlene Option, verworfene Alternativen, Risiken, Migrationsplan und offene Fragen. Bitten Sie bei Reviews darum, „beobachtete Fakten“, „Interpretation“ und „empfohlene Änderungen“ zu trennen. Das reduziert übermäßig selbstsichere Architekturberatung und erleichtert es, das Ergebnis in ein ADR, einen Roadmap-Eintrag oder einen Engineering-Vorschlag zu überführen.
FAQ zum senior-architect skill
Ist senior-architect nur für große Systeme gedacht?
Nein. Er kann kleinen Teams helfen, eine einfache Architektur zu wählen und verfrühte Microservices zu vermeiden. Die enthaltene Referenz zu Architekturpatterns behandelt ausdrücklich die Trade-offs von Monolith und modular monolith. Der skill ist also auch dann nützlich, wenn die beste Antwort lautet: „Keep it simpler.“
Was macht ihn besser als einen gewöhnlichen Architektur-Prompt?
Ein normaler Prompt hängt vor allem davon ab, woran Sie beim Formulieren denken. Der senior-architect skill ergänzt wiederverwendbare Entscheidungs-Workflows, Pattern-Referenzen, Technologiematrizen und Skripte zum Scannen von Codebases. Diese Kombination ist besonders wertvoll, wenn Sie ein wiederholbares Architekturreview statt einer einmaligen Empfehlung brauchen.
Können Einsteiger diesen senior-architect skill nutzen?
Ja, aber Einsteiger sollten ihn als geführte Entscheidungshilfe verwenden, nicht als Autorität. Bitten Sie ihn, Trade-offs zu erklären, Begriffe zu definieren und Annahmen zu kennzeichnen. Wenn Sie Ihre Skalierung, Ihr Verfügbarkeitsziel oder Ihre betrieblichen Randbedingungen noch nicht kennen, lassen Sie den skill zuerst die fehlenden Fragen auflisten, bevor er ein Design empfiehlt.
Wann sollte ich ihn nicht verwenden?
Verwenden Sie ihn nicht als alleinige Grundlage für sicherheitskritische, compliance-intensive oder produktionsrelevante Migrationsentscheidungen. Er ersetzt außerdem kein Profiling, keine Lasttests, kein Cloud-Kostenmodell und kein Expertenreview für eine besondere Fachdomäne. Bei Low-Level-Implementierungsfehlern ist ein sprachspezifischer Debugging-skill möglicherweise besser geeignet.
So verbessern Sie den senior-architect skill
senior-architect-Eingaben mit messbaren Rahmenbedingungen verbessern
Der häufigste Fehlermodus ist Architekturberatung, die plausibel klingt, aber nicht umsetzbar ist. Verbessern Sie die Ergebnisse, indem Sie Zahlen ergänzen: Nutzer, Requests pro Sekunde, Speicherwachstum, Peak-Multiplikator, Latenzbudget, Uptime-Ziel, Teamgröße, Release-Frequenz und Kostengrenze. Selbst grobe Schätzungen sind besser als Adjektive wie „high scale“ oder „enterprise grade“.
Repository-Evidenz nutzen, bevor Sie Änderungen anfragen
Bei bestehenden Projekten sollten Sie Skriptausgaben und eine kurze File-Tree-Zusammenfassung mitgeben. Erwähnen Sie, ob der Code controllers/services/repositories, domain/application/infrastructure-Ordner, Docker, Kubernetes, Message Queues oder mehrere deploybare Services verwendet. So kann senior-architect besser unterscheiden, ob eine Architektur bewusst gestaltet wurde oder nur zufällig durch Ordnernamen so wirkt.
Von grobem Design zu konkreten Artefakten iterieren
Bleiben Sie nicht beim ersten Architekturvorschlag stehen. Fragen Sie in Folgeprompts nach einem ADR, einem Mermaid-Diagramm, einer Migrationssequenz, einem Risikoregister, einer Datenbankentscheidung, einer API-Grenze oder einem Modell für Service Ownership. Ein guter Iterationspfad ist: High-Level-Design → Trade-off-Vergleich → gewählte Architektur → Diagramm → ADR → phasenweiser Implementierungsplan.
Auf Overengineering und fehlende Annahmen achten
Wenn die Ausgabe microservices, event sourcing, CQRS oder distributed messaging empfiehlt, fragen Sie nach, warum die zusätzliche betriebliche Komplexität gerechtfertigt ist. Wenn Annahmen fehlen, fordern Sie eine überarbeitete Antwort an, die Unbekanntes klar benennt und eine einfachere Standardoption anbietet. Die beste Nutzung von senior-architect hält das Design an den Fähigkeiten des Teams ausgerichtet — nicht nur an theoretischer Skalierbarkeit.