Can I use this for both new designs and existing code?

Yes. It features two modes: Proposal Review for evaluating plans and specs, and Implementation Review for assessing the structural health and compliance of existing code.

How does it help with technical debt?

By evaluating 'Outcome Confirmation' and 'Iteration Assessment,' the skill identifies where implementation deviates from the architectural contract, highlighting areas of high risk or degradation.

Does this skill only work with Clean Architecture?

No. While it uses Clean Architecture terminology as a baseline, it is architecture-agnostic and includes mappings for MVC, Serverless, Event-Driven, and Microservices styles.

What are the 'Six Lenses' of evaluation?

The assessment covers Dependency Architecture, Component Design, Data Flow & Boundaries, Quality Attributes, Structural Integrity, and Database Architecture.

BD Software Architecture Reviewer

Name: BD Software Architecture Reviewer
Author: bitsydarel

bybitsydarel

0•

Herramientas de Colaboración

Conducts multi-dimensional architecture assessments to ensure structural integrity and long-term maintainability through the lens of 'why over how.'

This skill provides a structured framework for evaluating software designs and implementations against core architectural principles such as dependency inversion, boundary enforcement, and component cohesion. Grounded in the Second Law of Software Architecture, it uses six distinct lenses—ranging from dependency flow to database design—to audit proposals and codebases. Whether you are utilizing Clean Architecture, Hexagonal, or Microservices, this tool identifies anti-patterns and architectural drift, ensuring that every design choice is justified, documented via ADRs, and physically enforced through code structure.

Características Principales

01Six-lens evaluation framework covering dependency flow, data boundaries, and quality attributes.

02Architecture-agnostic assessment compatible with Clean, Hexagonal, and Microservices styles.

03Automated compliance checking for SOLID principles and dependency acyclicity.

04Quantifiable scoring system across 27 criteria to measure architectural health.

05Support for Architecture Decision Records (ADRs) to track the 'why' behind design choices.

060 GitHub stars

Casos de Uso

01Conducting architectural 'health checks' on legacy codebases to map technical debt and drift.

02Enforcing boundary and dependency rules during pull request reviews for complex systems.

03Reviewing product proposals and RFCs to identify structural flaws before implementation starts.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bitsydarel/bdskills bd-software-architecture

For use in Claude.ai and ChatGPT

Download Skill