hld-review

Evaluate High-Level Design documents against ADRs, requirements, and architecture principles.

49|12|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill hld-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hld-review
Source: https://github.com/DavidROliverBA/ArchitectKB/tree/main/.claude/skills/hld-review
Command: npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill hld-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the comprehensive review of High-Level Design (HLD) documents, ensuring they align with architectural principles, requirements, and best practices, thereby reducing design flaws and improving system quality.

Core Features & Use Cases

  • Automated HLD Evaluation: Assesses HLDs across six critical dimensions: ADR Coverage, Requirements Traceability, Principle Compliance, Security Architecture, Integration Clarity, and Operational Readiness.
  • Structured Feedback: Generates a detailed report with scores, severity-rated findings (Blocking, Advisory, Informational), and actionable next steps.
  • Use Case: Before a new microservice is approved, run this Skill on its HLD to identify any gaps in ADR coverage or security considerations, ensuring a robust design from the outset.

Quick Start

Review the HLD note titled 'HLD - User Authentication Service'.

Frequently Asked Questions about hld-review

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

FAQPage Schema
What does a high-level design evaluation check for in a software architecture?▼

To evaluate an HLD, review the document against linked architecture decision records and project requirements. The process generates a structured report with scores across six critical dimensions, severity-rated findings, and actionable next steps for design improvement.

How do I evaluate an HLD against architecture decision records?▼

To evaluate an HLD against architecture decision records, compare the design document to your ADRs, project requirements, and architecture principles. This yields a scored report across six dimensions with severity-rated findings and actionable next steps for improvement.

What dimensions are scored during an architecture design review?▼

An architecture design review scores six dimensions: ADR Coverage, Requirements Traceability, Principle Compliance, Security Architecture, Integration Clarity, and Operational Readiness. These scores quantify alignment with project requirements and established architecture principles.

Can I automate compliance and security checks for a new microservice design?▼

Yes, you can automate compliance and security checks by running an HLD evaluation on the microservice design. The review identifies gaps in security architecture and ADR coverage, generating severity-rated findings and actionable next steps to ensure robust design.

What types of findings are generated during an HLD evaluation?▼

An HLD evaluation generates severity-rated findings categorized as Blocking, Advisory, or Informational. It provides scores across six dimensions and suggests actionable next steps to resolve identified design flaws and improve system quality.