create-architecture

Generate architecture documentation with ADRs, Mermaid diagrams, and tech-stack rationale.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/igot-ai/os-twin --skill create-architecture-igot-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-architecture
Source: https://github.com/igot-ai/os-twin/tree/main/.agents/skills/global/create-architecture
Command: npx skills add https://github.com/igot-ai/os-twin --skill create-architecture-igot-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of architecture documentation for an epic, aligning ADRs, component diagrams, data flows, and tech-stack rationale to project needs.

Core Features & Use Cases

  • ADR generation: Create architecture decision records for major design choices.
  • Diagram artifacts: Produce component diagrams and data-flow diagrams in Markdown with Mermaid support.
  • Tech-stack rationale: Document the chosen tech-stack and rationale for each layer.
  • Use Case: Example: generate a full architecture package for EPIC-XYZ with ADRs 001-003, components, and data flows.

Quick Start

Provide an epic description to generate ADRs, component diagrams, data-flow diagrams, and tech-stack rationale.

Frequently Asked Questions about create-architecture

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

FAQPage Schema
How do I generate architecture documentation for a new software epic?

To generate architecture documentation for a new software epic, provide an epic description to automatically produce ADRs, component diagrams, data-flow diagrams, and tech-stack rationale as structured Markdown artifacts.

What is the best way to create ADRs and component diagrams for a project wiki?

Creating ADRs and component diagrams for a project wiki is best handled by automating the generation of structured Markdown artifacts with Mermaid support, directly outputting architecture decision records and data flows for repository inclusion.

Can I produce Mermaid data-flow diagrams automatically from an epic description?

Yes, you can produce Mermaid data-flow diagrams automatically by providing an epic description, which generates diagram artifacts and data-flow visualizations formatted as structured Markdown files.

Does this architecture documentation approach work for evolving software initiatives?

Yes, this architecture documentation approach works for evolving software initiatives by applying structured architectural governance and alignment to generate comprehensive tech-stack rationale and ADRs for changing project needs.

How do I document tech-stack rationale and architecture decisions together?

To document tech-stack rationale and architecture decisions together, use an automated generation process that outputs structured Markdown artifacts, aligning your ADRs and tech-stack rationale directly to project needs.

When do I need structured architectural governance and alignment for my project?

You need structured architectural governance and alignment for your project when initiating new or evolving software initiatives that require comprehensive architecture documentation, including ADRs, data flows, and tech-stack rationale.