arch-check

Validate Clean Architecture dependency rules across Python codebase directories.

1|Updated Dec 2, 2025
One-click install
npx skills add https://github.com/Junghyun99/StockAsset --skill arch-check-junghyun99
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-check
Source: https://github.com/Junghyun99/StockAsset/tree/main/.claude/skills/arch-check
Command: npx skills add https://github.com/Junghyun99/StockAsset --skill arch-check-junghyun99

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically verifies if your project adheres to Clean Architecture principles, ensuring a maintainable and scalable codebase.

Core Features & Use Cases

  • Dependency Direction Check: Ensures core layers do not depend on infra or utils.
  • Interface Implementation Verification: Checks if interfaces defined in core are correctly implemented in infra and backtest.
  • Backtest Reusability: Validates that backtesting logic reuses core components without introducing backtest-specific code into the core.
  • Cyclic Dependency Detection: Identifies and reports circular dependencies between modules.

Quick Start

Run the arch-check skill to validate the clean architecture rules for the current project.

Frequently Asked Questions about arch-check

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

FAQPage Schema
How do I check if my Python codebase follows clean architecture rules?

To check clean architecture compliance in a Python codebase, you can automatically validate dependency directions to ensure core layers do not depend on infra or utils, verify interface implementations, and detect cyclic dependencies between modules.

Why does my core layer depend on infra and how do I validate dependency directions?

Validating dependency directions ensures core layers remain isolated from infra and utils. You can detect these violations by running an automated analysis that checks if your core modules improperly import outer layer components.

How do I detect cyclic dependencies in a Python project?

Detecting cyclic dependencies in a Python project requires analyzing module imports to identify and report circular references. This validation prevents tangled architecture and maintains a maintainable codebase structure.

Can I verify backtest logic reusability without introducing backtest-specific code into core?

You can verify backtest logic reusability by checking that backtesting components reuse core logic without leaking backtest-specific code into the core layer, ensuring separation of concerns across the analyzed directories.

Does clean architecture validation support analysis of src/utils and src/backtest directories?

Clean architecture validation supports analysis of src/core, src/infra, src/utils, and src/backtest directories. It checks interface implementation across these layers to ensure correct architectural boundaries and dependency flows.