documenting-system-architecture

Synthesize subsystem catalogs and diagrams into structured architecture reports.

1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/tachyon-beep/hamlet --skill documenting-system-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documenting-system-architecture
Source: https://github.com/tachyon-beep/hamlet/tree/main/.claude/skills/axiom-system-archaeologist/skills/documenting-system-architecture
Command: npx skills add https://github.com/tachyon-beep/hamlet --skill documenting-system-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill helps teams translate scattered subsystem catalogs and architecture diagrams into a single, navigable architecture report that stakeholders can read and act on.

Core Features & Use Cases

  • Executive-ready synthesis: Convert inputs like 02-subsystem-catalog.md and 03-diagrams.md into a structured final report that serves multiple audiences.
  • Navigation-first structure: Produce a multi-level document with a comprehensive Table of Contents, cross-references, and appendices.
  • Pattern & concern synthesis: Extract architectural patterns and technical concerns, then present actionable recommendations for improvement.

Quick Start

Provide the inputs 02-subsystem-catalog.md and 03-diagrams.md, then run the documenting-system-architecture skill to generate 04-final-report.md.

Frequently Asked Questions about documenting-system-architecture

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

FAQPage Schema
How do I generate an architecture report from subsystem catalogs and diagrams?

To generate an architecture report, provide subsystem catalogs and architecture diagrams as inputs to synthesize a structured final document with executive summaries, cross-references, and appendices for stakeholders.

What is the best way to document system architecture for multiple stakeholders?

Documenting system architecture for multiple stakeholders involves synthesizing technical diagrams and subsystem catalogs into a navigation-first report that extracts architectural patterns and presents actionable recommendations.

How do I turn scattered architecture diagrams into a navigable stakeholder document?

Turning scattered architecture diagrams into a navigable document requires integrating them with subsystem catalogs to produce a multi-level report featuring a comprehensive table of contents and cross-references.

What inputs do I need to create a final architecture report?

Creating a final architecture report requires subsystem catalog files and diagram files as inputs, which are then synthesized into a comprehensive document with front matter, system overview, and multi-audience delivery sections.

Can I extract architectural patterns and recommendations from existing subsystem catalogs?

Yes, extracting architectural patterns and recommendations from subsystem catalogs is achieved by synthesizing them with diagrams to identify technical concerns and present actionable improvement suggestions in the final report.

Does this approach to architecture documentation work without a coordinator?

This architecture documentation approach applies when a coordinator manages the inputs, needing a final report for stakeholders, so it requires centralized coordination of the subsystem catalogs and diagrams.