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.