describe-design

You document codebase architecture by researching directory structures and configuration files to generate human-readable Markdown with Mermaid diagrams and stable code references. This workflow produces onboarding materials that explain system interactions and main components to new developers.

Generating Mermaid diagrams for a codebase overview involves a multi-stage workflow of scope definition, exploration, and deep research. The process outputs Markdown documents containing architectural diagrams and stable code references that map how system components interact.

Yes, you can research and document specific feature architecture by defining the exploration scope before analyzing the codebase. The multi-stage drafting process supports generating targeted feature documentation and system overviews with accurate code references.

Codebase research for knowledge transfer works by exploring READMEs and configuration files to build a mental model of the system. It produces human-readable Markdown documentation that captures architectural interactions, making complex systems easier for developers and AI agents to grasp.

No external dependencies are required to generate Markdown architectural documentation. The research workflow operates independently to explore the codebase and output human-readable Markdown files with Mermaid diagrams and stable code references.