skills.rest
miyake-san
miyake-sanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

architecture-blueprint-generator

Generates architecture blueprint documents by analyzing codebase structure and technology stacks.

Updated Aug 28, 2026
Search Tags:#architecture#documentation#design patterns#codebase analysis#blueprint#technical documentation#c4 diagrams
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill architecture-blueprint-generator-miyake-san
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-blueprint-generator
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/core/architecture-blueprint-generator
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill architecture-blueprint-generator-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often lack up-to-date architectural documentation, making it hard to onboard developers, maintain consistency, and plan new features. This Skill analyzes an existing codebase and produces a comprehensive Project_Architecture_Blueprint.md that captures the real, implemented architecture rather than theoretical diagrams. ## Core Features & Use Cases - Automatic Stack and Pattern Detection: Identifies technology stacks (.NET, Java, React, Angular, Python, Node.js, Flutter) and architectural patterns (Clean Architecture, Microservices, MVC, Hexagonal, Event-Driven, and more) from project files and dependencies. - Configurable Documentation Depth: Control diagram type (C4, UML, Flow, Component), detail level, code examples, implementation patterns, and architectural decision records through template variables. - Extensibility Guidance: Documents extension points, feature-addition workflows, and common pitfalls so new development follows existing architectural conventions. - Use Case: Point the Skill at a legacy monorepo before a major refactor to generate a blueprint covering layers, data architecture, cross-cutting concerns, and deployment topology, then share it with the team as the authoritative reference. ## Quick Start Ask the AI to analyze this repository and generate a comprehensive architecture blueprint document with C4 diagrams and architectural decision records.

Frequently Asked Questions about architecture-blueprint-generator

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

FAQPage Schema
How do I generate architecture documentation from an existing codebase?▼

Run the blueprint generator against your repository and it analyzes project files, dependencies, and folder organization to detect stacks and patterns. It then produces a Project_Architecture_Blueprint.md covering components, layers, data architecture, and deployment topology.

What architectural patterns can the blueprint generator detect?▼

It detects Clean Architecture, Microservices, Layered, MVVM, MVC, Hexagonal, Event-Driven, Serverless, and Monolithic patterns by analyzing folder organization, dependency flow, interface segregation, and component communication. You can also specify a pattern manually instead of auto-detection.

Does it support .NET, Java, React, and Python projects?▼

Yes, it includes technology-specific analysis sections for .NET, Java, React, Angular, Python, Node.js, and Flutter. In auto-detect mode it examines configuration files and imports to identify which stacks are present and documents only the relevant patterns.

Can I generate C4 or UML diagrams with the architecture blueprint?▼

Yes, set the DIAGRAM_TYPE variable to C4, UML, Flow, or Component to include diagrams at multiple abstraction levels. Choose None to receive textual descriptions of component relationships and data flow instead.

When should I not use automated architecture documentation?▼

Avoid relying on it alone for greenfield design decisions, since it documents what exists rather than what should be built. It also cannot infer business intent behind decisions, so supplement generated decision records with team knowledge.

Related Skills

Explore More Software Engineering Skills→
JimmyTranDevJimmyTranDev
1

git-gitignore

Detect software stacks from manifest files and generate optimized .gitignore rules.

Community
Intermediate
KILWA73KILWA73

project-planner

Generate structured project blueprints and Mermaid roadmaps from project briefs.

Community
Advanced
icartshicartsh
4

code-analyze

Analyze .NET solutions for code quality, security, and dependency issues.

Community
Advanced
Brave-LabsBrave-Labs

Dev10x-adr

Create Architecture Decision Records using project templates and PlantUML diagrams.

Official
Advanced