How does this skill generate diagrams?

It parses the project structure and dependency logic to generate Mermaid syntax diagrams, which can be rendered in Markdown viewers to visualize system components.

Where is the documentation stored?

The skill generates files in standardized locations within the project, including /docs/architecture/, /docs/api/, and /docs/adr/.

What is an ADR in this context?

An ADR (Architecture Decision Record) is a short text file that captures an important architectural decision made along with its context and consequences.

Can it detect undocumented code?

Yes, the skill includes validation workflows that scan the codebase for public functions and classes missing docstrings, ensuring documentation remains complete.

World Weaver Architecture Manager

Name: World Weaver Architecture Manager
Author: astoreyai

byastoreyai

•

Content Management

Generates and maintains comprehensive system architecture documentation, diagrams, and decision records directly from source code.

The World Weaver Architecture skill empowers Claude to automatically synchronize system documentation with implementation details. It parses Python modules to extract docstrings, maps complex dependency graphs, and generates visual Mermaid diagrams to illustrate system flow. By facilitating the creation of Architecture Decision Records (ADRs) and validating documentation accuracy against the actual codebase, it ensures that technical debt remains low and system transparency remains high throughout the development lifecycle.

Key Features

011 GitHub stars

02Architecture Decision Record (ADR) management and templating

03Dependency graph mapping to visualize internal module relationships

04Cross-validation between implementation and documentation to detect stale references

05Dynamic generation of Mermaid diagrams for system architecture visualization

06Automated extraction of module and class-level documentation from Python code

Use Cases

01Tracking the rationale behind major technical shifts using the built-in ADR workflow

02Automatically updating API and system diagrams after a significant refactor or feature addition

03Generating a comprehensive architecture overview for a new contributor onboarding to World Weaver

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astoreyai/claude-skills ww-architecture

For use in Claude.ai and ChatGPT

Download Skill