Where does the skill look for documentation?

It specifically scans for Architecture Decision Records in docs/decisions/ and general architecture documents in docs/architecture/.

Can I export the architecture map?

Yes, by using the --output flag, you can write the entire rendered architecture map to a Markdown file for sharing or archival purposes.

What is the Arch-Map skill?

It is a specialized capability for Claude Code that automatically links your source code modules to their corresponding architectural decisions and documentation to ensure project traceability.

What does 'Full' coverage mean in the report?

Full coverage indicates that a specific module is referenced by at least one 'accepted' ADR and at least one general architecture document.

How does it identify code modules?

The skill uses a discovery script to scan your repository for directories containing a CLAUDE.md file, which identifies them as distinct modules.

Architecture Governance Map

Name: Architecture Governance Map
Author: alexnodeland

byalexnodeland

•

콘텐츠 관리

Maps code modules to Architecture Decision Records (ADRs) and technical documentation to visualize and audit architectural coverage.

The arch-map skill provides a vital governance layer for complex projects by automatically tracing the relationship between implementation and intent. By scanning your codebase for modules and cross-referencing them against accepted ADRs and architectural documents, it generates a comprehensive gap analysis. This tool is essential for engineering leaders and architects who need to ensure that every part of their system is governed by documented decisions, classifying each module's documentation status as Full, Partial, or None to highlight where architectural oversight may be lacking.

주요 기능

01Analyzes architecture document mentions for every code module

02Generates detailed Markdown reports based on customizable templates

03Cross-references accepted ADRs from docs/decisions/

04Three-tier coverage classification (Full, Partial, None)

05Automated module discovery via CLAUDE.md file scanning

063 GitHub stars

사용 사례

01Onboarding new developers by providing a clear map of the 'why' behind each codebase component

02Auditing project health and compliance with architectural standards during release cycles

03Identifying undocumented modules that require architectural justification

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled arch-map

For use in Claude.ai and ChatGPT

Download Skill