skills.rest
masa-codehub
masa-codehubCOMMUNITY
Explore all skills by this author →
GitHub

drafting-architecture

Draft Mermaid architecture diagrams and design documentation from planning artifacts.

Updated Aug 18, 2025
Search Tags:#planning#architecture#mermaid#ddd#diagram#clean-architecture#design-docs
One-click install
npx skills add https://github.com/masa-codehub/gemini_agent --skill drafting-architecture
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: drafting-architecture
Source: https://github.com/masa-codehub/gemini_agent/tree/main/.gemini/skills/drafting-architecture
Command: npx skills add https://github.com/masa-codehub/gemini_agent --skill drafting-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This skill reduces the manual effort of creating and updating architecture diagrams (Mermaid) and the accompanying design documents by synthesizing structural and quality design based on planning artifacts, while aligning with Clean Architecture and DDD principles.

Core Features & Use Cases

  • Drafts and updates architecture diagrams (C4 structure, Sequence, State, ER) from planning inputs.
  • Integrates structural design with quality policy definitions to produce coherent, navigable diagrams and docs.
  • Supports self-audit-ready outputs, retrospectives, and PR-ready artifacts for team collaboration.

Quick Start

Generate Mermaid diagrams and associated design documentation from planning-architecture inputs to begin immediate collaboration.

Frequently Asked Questions about drafting-architecture

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

FAQPage Schema
How do I generate Mermaid architecture diagrams from planning artifacts?▼

To generate Mermaid architecture diagrams from planning artifacts, use this skill to synthesize structural inputs into C4, sequence, state, and ER visualizations. It drafts the diagrams automatically while aligning the outputs with Clean Architecture and DDD terminology.

Can I automate design documentation alongside C4 model diagrams?▼

Yes, you can automate design documentation alongside C4 model diagrams. This skill integrates structural design with quality policy definitions to produce coherent, navigable docs and visualizations that are ready for team collaboration and pull requests.

Does this skill enforce Domain-Driven Design and Clean Architecture principles?▼

Yes, this skill enforces Domain-Driven Design and Clean Architecture principles. It processes planning artifacts to draft architecture diagrams and accompanying design documents, ensuring the generated outputs consistently align with DDD terminology and structural boundaries.

What is the best way to create audit-ready architecture documentation for a software project?▼

The best way to create audit-ready architecture documentation is synthesizing planning artifacts into self-audit-ready outputs. This skill drafts structural and quality design components, producing coherent diagrams and templates that fulfill retrospective and compliance requirements.

How do I update existing Mermaid sequence and state diagrams when project plans change?▼

To update existing Mermaid sequence and state diagrams when plans change, feed the new planning artifacts into this skill. It reduces manual effort by automatically drafting and updating the visualizations and accompanying design documents to reflect the latest structural design.

Related Skills

Explore More Software Engineering Skills→
GenerativeAgentsGenerativeAgents

functional-design

Generate functional design documents from PRD inputs with Mermaid diagrams and TypeScript interfaces.

Official
Advanced
adriannoesadriannoes
46

mermaid-class-diagram-generator

Generate and validate mermaid class diagrams for software visualization.

Community
Intermediate
jrmatherlyjrmatherly
1

mermaid-diagrams

Generate software diagrams from text using Mermaid syntax.

Community
Advanced
Alone-Y154Alone-Y154

architecture-patterns

Implement Clean Architecture and DDD patterns with Python examples.

Community
Advanced