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.