Architecture Design Review

What it does

This skill provides automated architecture and design review capabilities. It analyzes architectural diagrams, code snippets, or design documents to identify potential issues related to scalability, security, and maintainability. The tool aims to improve the quality of software designs by proactively flagging risks and suggesting improvements.

When to use it

• Early-stage planning: Review high-level architecture diagrams before significant development begins to catch fundamental flaws.
• Code review process: Integrate into code reviews to automatically check for architectural compliance and potential design weaknesses.
• Refactoring initiatives: Assess the impact of proposed changes on existing system architecture.
• Onboarding new team members: Quickly familiarize a new developer with an existing system's architecture through automated analysis.

Key capabilities

• Architecture diagram analysis
• Code snippet review for architectural patterns
• Design document assessment
• Identification of scalability concerns
• Security vulnerability detection in design
• Maintainability improvement suggestions

Example prompts

• "Review this sequence diagram and identify potential bottlenecks."
• "Analyze this code snippet for adherence to the microservices architecture pattern."
• "Assess this database schema design for security vulnerabilities."

Tips & gotchas

The quality of the review depends heavily on the clarity and completeness of the input (diagrams, code, documents). Ensure inputs are well-defined and accurately represent the intended architecture.