architecture-docs

Generate ARCHITECTURE.md documents and ADRs across multiple architecture types.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/shadowX4fox/solutions-architect-skills --skill architecture-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-docs
Source: https://github.com/shadowX4fox/solutions-architect-skills/tree/main/skills/architecture-docs
Command: npx skills add https://github.com/shadowX4fox/solutions-architect-skills --skill architecture-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires officegen.

What problem does it solve?

The Architecture Documentation Skill helps teams create, update, and validate ARCHITECTURE.md documents, enabling consistent, governance-aligned architecture artifacts that are easy to navigate and load into context for Claude Skills.

Core Features & Use Cases

  • Workflow-driven documentation: Generate ARCHITECTURE.md from templates, ADRs, and supporting guides.
  • Diagram & Diagram Generation: Create Mermaid architecture diagrams and visuals from the ARCHITECTURE.md.
  • Validation & Governance: Validate structure against templates, manage ADRs, and ensure BIAN/META alignment.
  • Use Case: A team regenerates ARCHITECTURE.md after major refactors to ensure all sections stay aligned with governance.

Quick Start

Activate the skill and run generation: load ARCHITECTURE.md, apply ADR guidance, and produce updated diagrams and validation status.

Frequently Asked Questions about architecture-docs

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

FAQPage Schema
How do I generate an ARCHITECTURE.md document from my codebase?

ARCHITECTURE.md generation applies templates and ADR guidance to produce structured, governance-aligned documentation. Load your existing architecture notes, apply the ARCHITECTURE_GUIDE standards, and the Skill generates Section 4 and Section 5 mappings with validation status for Microservices, META, 3-Tier, N-Layer, or BIAN architectures.

What architecture patterns does this support?

The Skill handles Microservices, META, 3-Tier, N-Layer, and BIAN architectures. It produces architecture-specific Section 4 and Section 5 mappings, enforces indexing standards, applies metric validation, and generates governance-ready ADR templates tailored to each pattern type.

Can I automatically generate ADRs alongside architecture documentation?

Yes. The Skill auto-generates ADR templates and integrates them into your ARCHITECTURE.md workflow. It enforces ADR structure, applies validation rules, and ensures decisions align with your architecture type and governance requirements.

How do I validate my architecture documentation against governance standards?

Architecture validation runs structured checks against your ARCHITECTURE_GUIDE templates and indexing rules. The Skill validates Section 4 and Section 5 compliance, confirms metric requirements are met, and surfaces governance gaps before documents are finalized.

Does this Skill support multiple languages?

Yes. Language localization is built in. The Skill generates ARCHITECTURE.md, ADRs, and validation artifacts in your target language while maintaining governance-aligned structure and metric enforcement across all supported architecture types.

Can I create architecture diagrams from ARCHITECTURE.md?

Yes. The Skill generates Mermaid architecture diagrams directly from your ARCHITECTURE.md document. Diagrams are created from the structured content, keeping visuals synchronized with your documentation and governance standards.