c4-architecture-c4-architecture

You can generate C4 architecture documentation by running an automated bottom-up analysis on your repository. This process scans directories to produce code-level markdown files, then synthesizes them into Component, Container, and Context docs with Mermaid diagrams and OpenAPI specs.

Bottom-up code discovery is an approach that analyzes the deepest code directories first to generate per-directory c4-code-*.md files. It systematically builds up Component, Container, and Context documentation by synthesizing these granular code-level artifacts upwards.

Yes, the workflow generates container API specifications in OpenAPI format and aligns them with deployment definitions. It automatically outputs these specs under the C4-Documentation/apis directory while producing Mermaid diagrams throughout the architecture documentation.

Automated C4 documentation applies to software projects of any size. It guides analysts through code discovery, component synthesis, container mapping, and context documentation regardless of repository scale, producing consistent multi-level architectural artifacts.

The best way is to use phase-based synthesis that converts code docs into c4-component-*.md and c4-container.md files, then creates a c4-context.md file. This structure outputs link-rich artifacts with Mermaid diagrams saved under C4-Documentation/.