generate-design-guidelines

Generate MADR-compliant design guidelines and ADR stubs from a ProjectModel JSON.

3|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/mor-duongmh/morkit-plugin --skill generate-design-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-design-guidelines
Source: https://github.com/mor-duongmh/morkit-plugin/tree/main/plugins/morkit/skills/generate-design-guidelines
Command: npx skills add https://github.com/mor-duongmh/morkit-plugin --skill generate-design-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires docs-hero-orchestrator, and includes scripts (resource) components.

What problem does it solve?

This tool automates the creation and ongoing maintenance of design guidelines and architecture decisions by deriving them from a ProjectModel, reducing manual drafting and ensuring consistency.

Core Features & Use Cases

  • Renders docs/design-guidelines.md from a ProjectModel.
  • Generates per-ADR stubs under docs/adr/NNN-slug.md for each ADR.
  • Supports init and update modes (sync is not supported).

Quick Start

Run the CLI with a ProjectModel to render the design guidelines and ADR stubs.

Frequently Asked Questions about generate-design-guidelines

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

FAQPage Schema
How do I generate architecture decision records from a project model?

To generate architecture decision records from a project model, you need a ProjectModel JSON file and an orchestrator tool to render MADR-compliant ADR stubs and a centralized design guide, automating architecture documentation.

What is the best way to centralize architecture documentation for a software project?

Centralizing architecture documentation is best achieved by deriving design principles and patterns from a ProjectModel JSON, rendering a cohesive design guide and individual ADR stubs to ensure consistency and reduce manual drafting.

Can I sync generated design guidelines with an updated project model?

No, syncing generated design guidelines with an updated project model is not supported; the tool only provides init and update modes to manage the rendering of design guidelines and ADR stubs.

Do I need a specific orchestrator tool to render MADR-compliant design guidelines?

Yes, you need the docs-hero orchestrator tooling to render MADR-compliant design guidelines, as the CLI requires both a ProjectModel JSON and this orchestrator to manage outputs and ADR stubs.

When do I need to generate per-ADR stubs under a docs directory?

You need to generate per-ADR stubs under a docs directory when establishing or updating architecture documentation for product teams, ensuring each architectural decision is recorded as a separate slug-named markdown file.