planning-hld

Generate a per-story high-level design with contract-gated integration decisions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/gleeb/ai-registry --skill planning-hld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-hld
Source: https://github.com/gleeb/ai-registry/tree/main/systems/sdlc/skills/planning-hld
Command: npx skills add https://github.com/gleeb/ai-registry --skill planning-hld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It produces a per-story high-level design (HLD) that keeps architecture consistent, prevents contract drift, and ensures each user story’s scope and integrations are explicitly traceable.

Core Features & Use Cases

  • Per-story HLD delivery: Generates an HLD scoped to a single user story for Phase 3 (HLD work dispatched by the Planning Hub).
  • Contract-gated integration design: Reads consumed contracts and designs integration realization (mock, interface-only, real, or realize) without redefining shared interfaces.
  • Traceability and review-ready structure: Uses the HLD template and maps design units to story acceptance criteria for sparring review with the user.
  • Correct output artifact: Writes the resulting document to plan/user-stories/US-NNN-name/hld.md.

Quick Start

Use the planning-hld skill to generate the HLD for story US-NNN-name by ensuring story.md, plan/system-architecture.md, consumed contracts in plan/contracts/, and the relevant plan/prd.md sections are present for context.

Frequently Asked Questions about planning-hld

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

FAQPage Schema
How do I generate a per-story high-level design that prevents contract drift?

A per-story high-level design scoped to a single user story defines component responsibilities, data flows, and integration points while enforcing REQUIRE/DENY gates against consumed contracts to prevent interface drift.

What do I need to prepare before creating a contract-safe high-level design?

Before creating a contract-safe high-level design, ensure story.md, plan/system-architecture.md, plan/prd.md, and consumed contracts in plan/contracts/ are present to provide the required context for Phase 3 HLD generation.

How does integration realization work when designing per story in the SDLC planning phase?

Integration realization during per-story HLD design selects mock, interface-only, real, or realize modes by reading consumed contracts, ensuring shared interfaces are utilized without redefinition under REQUIRE/DENY gate enforcement.

Can I map high-level design components to user story acceptance criteria for traceability?

Yes, per-story high-level design maps design units directly to user story acceptance criteria using the HLD template, producing a review-ready structure that ensures explicit traceability for sparring review.

What is the correct output artifact location for a user story high-level design document?

The correct output artifact for a user story high-level design document is written to plan/user-stories/US-NNN-name/hld.md, using the standardized HLD template with explicit integration realization decisions.

When should I not use a per-story HLD approach for integration strategy?

You should not use a per-story HLD approach when system-architecture.md or consumed contracts are missing, as the REQUIRE/DENY gates require these inputs to validate integration points and prevent contract drift.