hld-writer

Create High-Level Design documents with architecture decisions and data flows.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Prathmesh2000/cursor_agent-orchestrator --skill hld-writer-prathmesh2000
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hld-writer
Source: https://github.com/Prathmesh2000/cursor_agent-orchestrator/tree/main/agent-system/skills/hld-writer
Command: npx skills add https://github.com/Prathmesh2000/cursor_agent-orchestrator --skill hld-writer-prathmesh2000

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often embark on system design without a clear, testable high-level design, leading to misaligned scope and rework. This skill helps produce a structured High-Level Design that communicates goals, boundaries, data flows, and architectural decisions to stakeholders.

Core Features & Use Cases

  • Define system context, goals, constraints, and success criteria to align multiple teams
  • Capture architecture decisions, data flows, capacity planning, and trade-offs for early alignment
  • Provide a reusable HLD template to accelerate handoffs to LLD and implementation teams
  • Real-world use case: design a multi-service platform with bounded contexts and service boundaries

Quick Start

Create an initial High-Level Design document for a new feature, starting with an executive summary and sections on goals, constraints, architecture, data flows, and non-functional requirements.

Frequently Asked Questions about hld-writer

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

FAQPage Schema
How do I create a high-level design document for a multi-service system?

To create a high-level design document, define the system scope, architecture decisions, and non-functional requirements. Structure the document with an executive summary, goals, constraints, data flows, and success criteria to articulate system boundaries for stakeholders.

What should be included in system architecture trade-offs and capacity planning?

System architecture trade-offs and capacity planning should include architecture decision records, data flow mappings, and non-functional requirements. Capturing these elements early ensures alignment across product, engineering, and DevOps teams during design reviews.

When do I need a high-level design before starting low-level design?

You need a high-level design before low-level design when building multi-service systems to prevent misaligned scope and rework. It establishes bounded contexts, service boundaries, and testable architecture decisions required for smooth handoffs to implementation teams.

Can I use an HLD template to align engineering and DevOps teams?

Yes, you can use an HLD template to align engineering and DevOps teams by standardizing executive summaries, constraints, and architecture decisions. This reusable format ensures all stakeholders share a clear understanding of data flows and system goals.

Does high-level design require alignment with a product requirements document?

High-level design requires alignment with a product requirements document (PRD) to accurately define system context and success criteria. Mapping architecture decisions and constraints to the PRD ensures the design meets product goals across multiple teams.

What is the best way to document service boundaries and bounded contexts?

The best way to document service boundaries and bounded contexts is through a structured high-level design that captures data flows and architecture decisions. Defining these elements early clarifies system scope and prevents overlapping responsibilities across services.