Can it verify compliance with custom architecture principles?

Yes, it queries your vault for Concept notes tagged as principles and checks the HLD design against their specific statements and implications.

What dimensions does the HLD review cover?

The skill evaluates designs across six key dimensions: ADR Coverage, Requirements Traceability, Principle Compliance, Security Architecture, Integration Clarity, and Operational Readiness.

Does it integrate with existing Architecture Decision Records (ADRs)?

Yes, it automatically scans your repository for linked ADRs and verifies if significant design choices have corresponding accepted records.

What is the output format of the review?

It generates a structured markdown report in the console including a scoring summary, detailed findings, context analyzed, and a checklist of actionable next steps.

How are architectural gaps reported?

Gaps are identified and categorized by severity as Blocking (requires rework), Advisory (address before go-live), or Informational findings.

HLD Architecture Reviewer

Name: HLD Architecture Reviewer
Author: DavidROliverBA

byDavidROliverBA

•

Learning & Documentation

Performs comprehensive automated reviews of High-Level Design notes against architectural standards, ADRs, and requirements.

The hld-review skill automates the rigorous evaluation of architectural designs within a Solutions Architect's knowledge management system. It cross-references High-Level Design (HLD) documents with linked Architecture Decision Records (ADRs), requirements, and core principles to identify critical gaps in security, operational readiness, and integration clarity. By producing structured scores and severity-rated findings, it helps architects ensure design consistency, compliance, and implementation-readiness through an AI-driven auditing process.

Key Features

01Evaluates designs across six dimensions including security and operational readiness

02Automates traceability checks between requirements and architectural components

03Cross-references design choices with established Architecture Decision Records (ADRs)

04Validates compliance with organization-specific architecture principles

0528 GitHub stars

06Generates structured reports with blocking, advisory, and informational findings

Use Cases

01Auditing HLD notes for operational readiness and monitoring strategies before implementation

02Reviewing complex cloud infrastructure designs for security and integration gaps

03Ensuring new system architectures align with existing ADRs and organizational principles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add davidroliverba/architectkb hld-review

For use in Claude.ai and ChatGPT

Download Skill