system-architect

Name: system-architect
Availability: InStock
Author: docaari

Generate versioned Mermaid architecture diagrams and ADRs from approved specs.

1|Updated Jun 26, 2025

Search Tags:#architecture #documentation #mermaid #adr #c4 #data-model

Ready to run

npx skills add https://github.com/Docaari/GrindfyManager --skill system-architect-docaari

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: system-architect
Source: https://github.com/Docaari/GrindfyManager/tree/main/.claude/skills/system-architect
Command: npx skills add https://github.com/Docaari/GrindfyManager --skill system-architect-docaari

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Software teams struggle to keep architecture artifacts up-to-date, versioned, and discoverable, translating complex designs into clear Mermaid diagrams and ADRs for engineers and stakeholders.

Core Features & Use Cases

Mermaid-based architecture diagrams (C4, containers, data models, flows, and sequence diagrams) to visualize the system.
Architecture Decision Records (ADRs) to capture trade-offs and rationale.
API documentation, data models, and feature flows to ensure a single source of truth that teams can reference.
Versioned artifacts that integrate into Git workflows, enabling diffable history and reviews.

Quick Start

Generate Mermaid diagrams and ADRs from an approved spec to document the system architecture.

Frequently Asked Questions about system-architect

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

FAQPage Schema

How do I generate Mermaid architecture diagrams from an approved specification?▼

To generate Mermaid architecture diagrams from an approved specification, you apply C4 diagrams, data models, and sequence diagrams to capture the system's structure and feature flows. Artifacts are produced only when a spec is approved or a decision requires documentation.

When do I need to create an Architecture Decision Record for my software project?▼

You need to create an Architecture Decision Record (ADR) when a meaningful architectural decision requires documentation to capture trade-offs and rationale. ADRs ensure a single source of truth that teams can reference during the system's evolution.

Does this approach support versioning architecture artifacts in Git workflows?▼

Yes, this approach supports versioning architecture artifacts in Git workflows by storing them in Mermaid format. This enables diffable history and reviews, ensuring architecture artifacts remain up-to-date, versioned, and discoverable.

What is the best way to document system architecture and its evolution over time?▼

The best way to document system architecture and its evolution is maintaining versioned Mermaid diagrams and ADRs. This captures C4 containers, data models, feature flows, and API documentation, ensuring stakeholders reference a single source of truth.

Can I use C4 diagrams and sequence diagrams together to visualize feature flows?▼

Yes, you can use C4 diagrams and sequence diagrams together to visualize feature flows. This combination captures the system's architecture alongside specific feature interactions, translating complex designs into clear Mermaid diagrams for engineers.