hld-writer

Converts PRD and API contracts into structured high-level designs with traceability.

79|23|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/TestAny-io/testany-agent-skills --skill hld-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hld-writer
Source: https://github.com/TestAny-io/testany-agent-skills/tree/main/plugins/testany-eng/skills/hld-writer
Command: npx skills add https://github.com/TestAny-io/testany-agent-skills --skill hld-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts PRD and API contracts into structured high-level designs.

Core Features & Use Cases

  • End-to-end mapping: maps PRD requirements to HLD sections including architecture, data design, and API references.
  • Traceability enforcement: ensures API contracts are cited and PRD traceability is maintained across documents.
  • Use Case: Given a PRD FR-001 and an API contract, generate a complete HLD outlining architecture decisions, component boundaries, and API integration points.

Quick Start

To begin, provide the PRD document path and the API contract path, then request an HLD for the target FR. Example: /hld-writer PRD: docs/prd-login.md API: api/openapi.yaml FR-001 HLD

Frequently Asked Questions about hld-writer

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

FAQPage Schema
How do I generate high-level design documentation from a PRD and API contracts?

To generate high-level design documentation from a PRD and API contracts, provide the document paths and target functional requirement ID to map architecture decisions, component boundaries, and API integration points into a structured HLD.

What is end-to-end mapping for architecture and data design in an HLD?

End-to-end mapping in an HLD translates PRD requirements into structured architecture, data design, and API reference sections, ensuring API contracts are cited and traceability is maintained across all documentation.

How do I maintain PRD traceability and enforce API contract references in technical documentation?

Maintain PRD traceability and enforce API contract references by generating high-level designs that map target functional requirements directly to architecture decisions and component boundaries, ensuring downstream design work remains aligned.

Can I use Mermaid diagrams to visualize component boundaries and architecture decisions in my HLD?

Yes, you can use Mermaid to visualize component boundaries and architecture decisions within your HLD, as the generated high-level design documentation supports structured diagrams for clear, decision-focused technical communication.

What's the best way to structure an HLD for downstream low-level design work?

The best way to structure an HLD for downstream LLD work is to enforce end-to-end mapping from PRD requirements across architecture, data design, and API references, ensuring clear, decision-focused documentation ready for detailed implementation.

Do I need a complete PRD and OpenAPI contract before writing architecture documentation?

Yes, you need a complete PRD and API contract before writing architecture documentation, because the HLD generation process relies on mapping specific functional requirements and citing API contracts to establish component boundaries and traceability.