arch-arc42

Generate and update arc42 narrative sections from existing architecture artifacts.

Updated Apr 8, 2026

Search Tags:#narrative generation #architecture documentation #arc42 #quality attributes #architecture decision records

Ready to run

npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill arch-arc42

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: arch-arc42
Source: https://github.com/VictorHueni/homemade-claude-kit/tree/main/skills/arch-arc42
Command: npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill arch-arc42

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires arch-c4, arch-uml, arch-adr, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the authoring and updating of arc42 narrative sections, ensuring consistency and up-to-date content across the architecture documentation.

Core Features & Use Cases

arc42 Narrative Generation: Automatically generates the arc42 narrative sections (§2, §4, §6, §8, §11) based on existing artifacts like ADRs, quality attributes, bounded contexts, and use cases.
Content Refresh: Updates the arc42 narrative with new ADRs or quality attribute updates, maintaining the most current architecture view.
Use Case: When a new ADR is created or a quality attribute is updated, this Skill can be used to refresh the relevant arc42 sections, ensuring the documentation reflects the latest decisions.

Quick Start

Run the arch-arc42 generate command to generate or update arc42 narrative sections.

Frequently Asked Questions about arch-arc42

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

FAQPage Schema

How do I automate arc42 architecture documentation generation?▼

Automate arc42 architecture documentation generation by scanning existing artifacts like ADRs and quality attributes to generate prose for sections §2-11. This ensures narrative consistency across the documentation without manual authoring.

What is arc42 narrative generation from architecture artifacts?▼

Arc42 narrative generation is the process of creating prose content for arc42 sections §2-11 by analyzing existing architecture artifacts. It syncs documented decisions and quality attributes directly into the narrative structure.

Can I refresh arc42 sections when new architecture decision records are added?▼

You can refresh arc42 sections when new architecture decision records are added by running the content refresh mode. This updates the narrative to reflect the latest ADRs and quality attribute changes automatically.

Does arch-arc42 work with C4 and UML architecture tools?▼

arch-arc42 works directly with arch-c4, arch-uml, and arch-adr tools to integrate existing diagrams and decision records into the narrative generation workflow. It requires access to these architecture artifacts for scanning.

What is the best way to keep architecture documentation consistent with ADRs?▼

The best way to keep architecture documentation consistent with ADRs is automating narrative updates upon every new decision record. This eliminates manual synchronization errors and maintains an up-to-date architecture view across sections §2-11.

Do I need existing architecture artifacts to generate arc42 sections?▼

You need existing architecture artifacts such as ADRs, bounded contexts, and use cases to generate arc42 sections. The Skill scans these inputs to produce the narrative prose, requiring access to the documentation repository.