How does the architecture-review skill work?

It simulates a team of architectural specialists who each analyze the codebase from their unique perspective, then synthesizes their findings into a unified, prioritized report.

When should I use this skill instead of a specialist-review?

Use architecture-review for comprehensive, high-stakes evaluations like new features or major releases. Use specialist-review for focused feedback from a single perspective.

What is Pragmatic Mode in this skill?

It is a configuration setting that ensures architectural recommendations are balanced against real-world delivery timelines and project constraints.

Where are the review results stored?

Reviews are automatically saved as Markdown files in the .architecture/reviews/ directory for easy sharing and version control tracking.

Architecture Reviewer

Name: Architecture Reviewer
Author: codenamev

bycodenamev

•

Collaboration Tools

Conducts comprehensive, multi-perspective software architecture audits by simulating a diverse team of specialist reviewers.

This skill automates the software architecture review process by coordinating multiple specialist perspectives to evaluate a system's design, quality, and technical debt. It guides Claude through a structured workflow—from defining the scope of a version or feature to facilitating a collaborative discussion among simulated team members—resulting in a detailed, prioritized review document. It is ideal for teams looking to maintain high architectural standards, identify risks early in the development lifecycle, and ensure design consistency across complex projects.

Key Features

01Collaborative consensus-building to prioritize architectural risks

02Pragmatic mode integration to balance ideal design with delivery constraints

0333 GitHub stars

04Standardized review templates for versions, features, and components

05Automated system discovery using git, glob, and grep tools

06Multi-perspective analysis from a diverse simulated specialist team

Use Cases

01Evaluating the design and integration patterns of a new complex feature

02Assessing technical debt and component boundaries in legacy systems

03Performing a full architectural audit before a major version release

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codenamev/ai-software-architect architecture-review

For use in Claude.ai and ChatGPT

Download Skill