architecture

Generate and update architecture documentation in markdown with Mermaid diagrams.

1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/operator-auteng-ai/hq --skill architecture-operator-auteng-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/operator-auteng-ai/hq/tree/main/skills/architecture
Command: npx skills add https://github.com/operator-auteng-ai/hq --skill architecture-operator-auteng-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you create and maintain clear, comprehensive architecture documents, ensuring your system designs are well-understood and effectively communicated.

Core Features & Use Cases

  • Generate Architecture Docs: Create new ARCH.md files from scratch for greenfield projects.
  • Update Existing Docs: Incrementally update ARCH.md or feature-specific architecture documents.
  • Visualize System Design: Produce diagrams (Mermaid) for system overview, component architecture, data models, and key flows.
  • Document Decisions: Capture key architectural decisions, trade-offs, and justifications.
  • Use Case: When designing a new microservice, use this Skill to generate an ARCH.md detailing its components, APIs, data schema, and integration points with existing systems.

Quick Start

Use the architecture skill to generate a new ARCH.md document for a system that handles user authentication and profile management.

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 greenfield software project?

To generate architecture documentation for a greenfield project, this Skill creates a new ARCH.md file from scratch, populating it with system overviews, component breakdowns, data models, and integration points using Mermaid diagrams.

What is the best way to update existing architecture docs during incremental development?

The best way to update existing architecture docs is using this Skill to incrementally modify your ARCH.md or feature-specific documents, capturing new component architecture, data models, and key architectural decisions as they evolve.

Can I use Mermaid diagrams to visualize system design and integration points?

Yes, you can use Mermaid diagrams to visualize system design. This Skill automatically produces Mermaid diagrams for system overviews, component architecture, data models, and key flows to ensure designs are effectively communicated.

Does this architecture documentation tool support both microservices and cross-cutting concerns?

Yes, this architecture documentation tool supports both microservices and cross-cutting concerns. It addresses architectural levels from system-wide down to specific integration points, detailing components, APIs, and data schemas.

How do I document architectural decisions and trade-offs in markdown?

To document architectural decisions and trade-offs in markdown, this Skill captures key architectural justifications directly within the generated ARCH.md, ensuring system designs and their rationales are well-understood and effectively communicated.