design-doc-high-level

Generate a high-level architecture design document with Mermaid diagrams from requirements.

11|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/awood45/claude-coding-commands --skill design-doc-high-level
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-doc-high-level
Source: https://github.com/awood45/claude-coding-commands/tree/main/.claude/skills/design-doc-high-level
Command: npx skills add https://github.com/awood45/claude-coding-commands --skill design-doc-high-level

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you convert a requirements document into a clear high-level architecture design that stakeholders can review before implementation begins. It focuses on choosing the right system shape and technology stack while keeping implementation details out of scope.

Core Features & Use Cases

  • Architecture Planning: Defines the major components, boundaries, and responsibilities of a software system.
  • Technology Selection: Evaluates runtime, compute, storage, networking, security, deployment, and observability choices with rationale.
  • Visual Documentation: Produces Mermaid diagrams for architecture, data models, data flows, and security boundaries.
  • Use Case: A team has an approved requirements document and needs a reviewable architecture proposal that explains what to build, why those choices were made, and what is deferred for later.

Quick Start

Use this skill to create a high-level architecture design document from the attached requirements file for the current project.

Frequently Asked Questions about design-doc-high-level

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

FAQPage Schema
How do I generate a high-level architecture design document from a requirements document?

To generate a high-level architecture design document, input your approved requirements document and interactively clarify runtime, compute, storage, networking, security, deployment, and observability decisions. The output includes Mermaid diagrams and decision rationale for stakeholders to review.

What is included in a high-level architecture design for a new software system?

A high-level architecture design includes major component boundaries, technology selection rationale, and Mermaid diagrams for data models, data flows, and security boundaries. It explicitly keeps implementation details out of scope while establishing the system shape for stakeholder review.

Can I use this approach to evaluate technology choices for deployment and observability?

Yes, evaluating technology choices for deployment and observability is a core part of this architecture design process. The interactive clarification specifically targets these decisions, ensuring your technology selection includes documented rationale for runtime, compute, and storage choices.

Does this architecture design process produce visual diagrams for system boundaries?

Yes, the architecture design process produces Mermaid diagrams specifically for system boundaries, data models, and data flows. These visual documentation elements help stakeholders review the proposed system shape before implementation begins.

When do I need to create a high-level architecture design document?

You need a high-level architecture design document when a team has an approved requirements document and requires a reviewable architecture proposal. It applies to product planning, system architecture discovery, and review cycles for new or evolving software systems before implementation.

What are the limitations of a high-level architecture design document?

The main limitation of a high-level architecture design document is that implementation details are explicitly kept out of scope. It focuses purely on choosing the right system shape and technology stack, deferring detailed implementation decisions for later phases.