architecture-blueprint-generator

Run the architecture blueprint generator against your project root. It analyzes project files, dependencies, and folder organization to detect the technology stack and architectural pattern, then produces a Project_Architecture_Blueprint.md document covering components, layers, and data flow.

It detects Clean Architecture, Microservices, Layered, MVVM, MVC, Hexagonal, Event-Driven, Serverless, and Monolithic patterns. Detection is based on folder organization, dependency flow, interface segregation, and communication mechanisms found in the actual code.

Supported stacks include .NET, Java, React, Angular, Python, Node.js, and Flutter, with an auto-detect mode for mixed codebases. Each stack has dedicated sections covering framework-specific patterns like dependency injection, middleware pipelines, and state management.

Yes, set the DIAGRAM_TYPE variable to C4, UML, Flow, or Component. The generator creates diagrams at multiple abstraction levels, including subsystem overviews, component interactions, and data flow, based on actual code dependencies rather than theoretical patterns.

Yes, the blueprint includes an extensibility section with feature addition patterns, implementation templates, and common pitfalls. It documents where to place new components, dependency introduction guidelines, and integration patterns for external systems.

Auto-detection relies on conventions visible in code structure and configuration files, so highly unconventional or hybrid architectures may need manual pattern specification. Diagrams reflect implemented dependencies and may not capture runtime-only or externally orchestrated interactions.