architecture

Generate architecture documentation with Mermaid diagrams for codebases.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/skylarsabo/code-ops --skill architecture-skylarsabo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/skylarsabo/code-ops/tree/main/plugins/code-ops-suite/skills/architecture
Command: npx skills add https://github.com/skylarsabo/code-ops --skill architecture-skylarsabo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a deep, diagram-rich architecture reference for a codebase, eliminating the need for a separate architecture document.

Core Features & Use Cases

  • Comprehensive Documentation: Documents the system context, containers, components, critical flows, cross-cutting concerns, and architectural decisions.
  • Code-Grounded Diagrams: Mermaid diagrams with narrative explanations for responsibilities, boundaries, and split rationale.
  • Use Case: Use this Skill to create an architecture overview for a new codebase, ensuring that the system's structure and flows are well-documented and easily understood.

Quick Start

Use the /code-ops-suite:architecture command to initiate the documentation process for your codebase.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I generate architecture documentation for a codebase?▼

To generate architecture documentation, analyze your codebase to produce system context, container diagrams, component breakdowns, critical flow diagrams, and architectural decisions using Mermaid visualizations.

How do I create system context and container diagrams for a complex codebase?▼

Creating system context and container diagrams involves mapping the codebase structure to generate Mermaid diagrams with narrative explanations for responsibilities, boundaries, and split rationale.

Can I document architectural decisions and critical flows automatically?▼

Yes, documenting architectural decisions and critical flows is possible by generating code-grounded Mermaid diagrams with narrative explanations for responsibilities, boundaries, and split rationale.

Is this architecture documentation tool suitable for senior engineers?▼

This architecture documentation tool is designed for senior engineers working on complex systems, focusing on system understanding, structure, and flows with code-grounded diagrams.

What's the best way to visualize codebase architecture without a separate document?▼

The best way to visualize codebase architecture without a separate document is to generate a deep, diagram-rich architecture reference detailing system context, containers, components, and critical flows.

Are Mermaid diagrams required for codebase architecture visualization?▼

Yes, Mermaid diagrams are required for codebase architecture visualization to detail system context, containers, components, critical flows, and architectural decisions with narrative explanations.