arch-review-guide

Identify architectural violations and dependency direction issues across Kotlin, Python, and TypeScript codebases.

3|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/Dokkabei97/hardened-claude-code --skill arch-review-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-review-guide
Source: https://github.com/Dokkabei97/hardened-claude-code/tree/main/skills/arch-review-guide
Command: npx skills add https://github.com/Dokkabei97/hardened-claude-code --skill arch-review-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly identify architectural violations, improper dependency directions, and structural health issues in codebases to accelerate safe, scalable reviews.

Core Features & Use Cases

  • Quick reference for detecting common architecture violations across Kotlin, Python, and TypeScript projects.
  • Step-by-step workflow guidance for macro structure discovery, dependency direction tracking, and data-modeling strategy.
  • Use cases include code reviews, architecture refactors, and onboarding new engineers to project architecture decisions.

Quick Start

Provide a repository path to run an architecture-review quick reference and generate a structured assessment.

Frequently Asked Questions about arch-review-guide

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

FAQPage Schema
Does architecture review support Kotlin, Python, and TypeScript projects?▼

Yes, architecture review supports multi-module Kotlin, Python, and TypeScript projects. The review process applies consistently across these languages to detect layer and hexagonal architecture violations.

How do I run an architecture review to detect structural health risks in a repository?▼

Checking for hexagonal architecture violations involves tracking dependency direction to ensure dependencies point inward toward the core domain. A structured assessment generates a scoring checklist to highlight improper structural dependencies.

When do I need to perform a dependency direction analysis for a codebase refactor?▼

Running an architecture review requires providing a repository path to trigger discovery and analysis. The workflow outputs a structured assessment containing violation scores and data-modeling strategy guidance.

How do I identify architectural violations and improper dependency directions in my codebase?▼

Perform dependency direction analysis when planning architecture refactors or onboarding new engineers to project decisions. It identifies improper layer dependencies that threaten structural health and scalability.