generate-design-guidelines

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

3|Updated Apr 20, 2026

Search Tags:#documentation #adr #design-principles #architecture-decisions #design-guidelines #madr

Ready to run

npx skills add https://github.com/mor-duongmh/morkit-plugin --skill generate-design-guidelines

💬 Prompt for ChatGPT / Claude Chat▼

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.