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.