Architecture Documentation

Generate architecture documentation with Mermaid diagrams and JSON summaries.

1|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/normcrandall/claudeskills --skill architecture-documentation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architecture Documentation
Source: https://github.com/normcrandall/claudeskills/tree/main/architecture
Command: npx skills add https://github.com/normcrandall/claudeskills --skill architecture-documentation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves? This Skill automatically documents existing software architecture or helps design new systems, providing a clear, up-to-date reference for development teams and stakeholders. It eliminates the manual effort of creating and maintaining complex architectural diagrams and descriptions.

Core Features & Use Cases

  • Existing System Analysis: Analyzes codebases to document tech stack, components, data flow, API patterns, and architectural decisions.
  • New Project Design: Guides the design of new architectures based on user requirements, recommending appropriate tech stacks, patterns, and deployment strategies.
  • Visual Diagrams: Embeds clear Mermaid diagrams directly into the Markdown documentation for high-level and component-level architecture.
  • Decision Recording: Documents key architectural decisions with context, rationale, and consequences.
  • Use Case: Run this on an unfamiliar codebase to instantly generate a comprehensive architecture.md document, saving days of manual discovery and accelerating onboarding for new team members.

Quick Start

Document existing architecture (first time)

Skill(command: "architecture")

Or, for a new project, describe your requirements

Frequently Asked Questions about Architecture Documentation

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

FAQPage Schema
How do I automatically document my existing codebase architecture?

Architecture documentation can be automatically generated by analyzing your codebase to extract tech stack, components, data flow, and API patterns. The Skill produces a comprehensive architecture.md file with Mermaid diagrams and architectural decision records, eliminating manual discovery work and accelerating team onboarding.

Can I use architecture documentation to design a new system before coding?

Yes, architecture documentation supports both existing systems and new projects. For new systems, you describe your requirements and the Skill recommends appropriate tech stacks, architectural patterns, and deployment strategies, helping you define architecture before implementation begins.

What diagrams and outputs does architecture documentation generate?

Architecture documentation generates Mermaid system and component-level diagrams embedded directly in Markdown, a detailed architecture.md file, and a JSON summary capturing key architectural decisions with rationale, data-flow mapping, and explicit component and dependency analysis.

How does architecture documentation handle missing or outdated docs?

The Skill automatically regenerates architecture documentation from your current codebase or design inputs, making it ideal when docs/architecture.md is missing, outdated, or needs refreshing as part of feature-delivery workflows or team transitions.

What information do I need to provide for new project architecture design?

For new projects, you provide your system requirements and constraints. The Skill then recommends tech stacks, architectural patterns, and deployment strategies tailored to your needs, delivering a complete architecture design with diagrams and decision documentation.

Does architecture documentation work without modifying my codebase?

Yes, architecture documentation analyzes existing codebases without requiring modifications. It extracts architectural information directly from your code structure, dependencies, and patterns to generate documentation and diagrams reflective of your current system design.