architecture-review

Evaluate software stories or systems against eight architecture dimensions.

8|9|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/vibercoder79/KI-Masterclass-Koerting- --skill architecture-review-vibercoder79
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/vibercoder79/KI-Masterclass-Koerting-/tree/main/architecture-review
Command: npx skills add https://github.com/vibercoder79/KI-Masterclass-Koerting- --skill architecture-review-vibercoder79

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Prevents architecture review from becoming a vague gut check by forcing a complete, documented read of your architecture design and ADRs before judging a story or the full system.

Core Features & Use Cases

  • Story Review or System Review modes: Use it for a single story going into implementation or for a quarterly/full-system architectural audit.
  • 8 architecture dimensions with actionable outputs: Produces per-dimension Status (OK/Warnung/Kritisch), Finding, and Recommendation, including concrete changes or suggested backlog issues.
  • Enforced documentation-first workflow: Requires reading ARCHITECTURE_DESIGN.md sections §1–§8 plus all ADRs before evaluation to ensure traceability.
  • Optional dimension add-ons: Privacy/GDPR, Cost Efficiency, Signal Quality, and Compliance can be activated based on your bootstrap configuration.

Quick Start

Ask for an architecture check by saying: "/architecture-review" before a story is implemented.

Frequently Asked Questions about architecture-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check software architecture for security and scalability risks before implementation?

Architecture review evaluates stories or systems against eight dimensions like security, scalability, and observability to surface cross-cutting risks early. It requires reading your ARCHITECTURE_DESIGN.md and ADRs before generating per-dimension status, findings, and recommendations.

What is an architecture review process based on ADR governance?

An architecture review based on ADR governance maps proposed changes to affected components by enforcing a read-through of architecture decision records. This ensures traceability and produces dimension-scoped findings for reliability, performance, and tech debt risks.

How do I run a full system architecture audit for tech debt and observability?

Run a system-level review by loading your ARCHITECTURE_DESIGN.md sections and all ADRs. The evaluation generates a per-dimension status of OK, Warning, or Kritisch, detailing findings and concrete recommendations for backlog issues.

Can I include GDPR privacy and compliance checks in my architecture review?

Yes, optional dimension add-ons for Privacy/GDPR, Cost Efficiency, Signal Quality, and Compliance can be activated. These dimensions are loaded based on your bootstrap configuration alongside the standard eight architecture dimensions.

Do I need ARCHITECTURE_DESIGN.md to perform an architecture risk assessment?

Yes, an enforced documentation-first workflow requires reading ARCHITECTURE_DESIGN.md sections one through eight plus all ADRs before evaluation. This prevents architecture review from becoming a vague gut check and ensures traceability.

When should I not use a documentation-first architecture review?

Avoid this approach if your project lacks an ARCHITECTURE_DESIGN.md or existing ADRs. The evaluation strictly enforces a read-through of these documents to map changes and produce dimension-scoped findings, making it unsuitable for undocumented systems.