change-architecture-doc

Analyze git changes to generate architecture documentation with Mermaid diagrams.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/gihwan-dev/claude-setup --skill change-architecture-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: change-architecture-doc
Source: https://github.com/gihwan-dev/claude-setup/tree/main/skills/change-architecture-doc
Command: npx skills add https://github.com/gihwan-dev/claude-setup --skill change-architecture-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the process of documenting architectural changes within a project, ensuring that system structure and flow are clearly communicated without manual overhead.

Core Features & Use Cases

  • Git Change Analysis: Analyzes git status and git diff to understand code modifications.
  • Automated Documentation Generation: Creates or updates architecture documentation, prioritizing existing documentation folders.
  • Mermaid Diagram Integration: Embeds system structure and flow diagrams using Mermaid syntax.
  • Use Case: After a significant refactoring effort, use this Skill to generate an updated architecture diagram and explanation, ensuring all stakeholders understand the new system boundaries and data flows.

Quick Start

Use the change-architecture-doc skill to document the architectural changes in the current branch.

Frequently Asked Questions about change-architecture-doc

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

FAQPage Schema
How do I automatically generate architecture documentation from git changes?

You can automatically generate architecture documentation from git changes by analyzing git status and git diff to create or update docs with Mermaid diagrams. This process prioritizes existing documentation folders like docs or guides, falling back to the project root if none are found.

What is the best way to document system boundaries and data flows after refactoring?

Documenting system boundaries and data flows after refactoring is best handled by analyzing git diffs to visualize structural changes. This approach focuses on structural modifications rather than implementation details, using Mermaid diagrams to map module interactions and impact areas.

Can I use Mermaid diagrams to visualize module interactions in my existing documentation folders?

Yes, you can use Mermaid diagrams to visualize module interactions in existing documentation folders. The system prioritizes directories like docs, packages/docs, guides, and documentation, automatically embedding system structure and flow diagrams into your current documentation setup.

How do I update architecture docs to focus on structural changes instead of implementation details?

To update architecture docs focusing on structural changes, analyze git changes to generate Mermaid diagrams of system boundaries and data flows. This method specifically targets structural modifications and impact areas, deliberately excluding implementation details from the generated documentation.

Does this architecture documentation generator work without a dedicated docs folder?

Yes, the architecture documentation generator works without a dedicated docs folder by falling back to the project root. It first searches for existing documentation directories such as docs, packages/docs, guides, or documentation, and generates the files in the root if none are found.

How do I track event flows and impact areas using git diff analysis?

You can track event flows and impact areas using git diff analysis by generating architecture documentation with Mermaid diagrams. This visualizes system boundaries, module interactions, and data flows based on the structural changes detected in your git status.