architecture-check

Validate architecture boundaries, import direction, and code duplication in repositories.

5|1|Updated Dec 10, 2025
One-click install
npx skills add https://github.com/Pravin-surawase/structural_engineering_lib --skill architecture-check-pravin-surawase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-check
Source: https://github.com/Pravin-surawase/structural_engineering_lib/tree/main/.github/skills/architecture-check
Command: npx skills add https://github.com/Pravin-surawase/structural_engineering_lib --skill architecture-check-pravin-surawase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams catch architecture violations early, including broken layer boundaries, invalid import direction, and duplicated logic that can destabilize a codebase.

Core Features & Use Cases

  • Boundary validation: Confirms Core, IS 456 Code, Services, and UI layers stay properly separated.
  • Import checking: Detects circular, broken, or upward imports across Python modules and app layers.
  • Duplication review: Flags repeated hooks, routes, and service logic during refactors and code review.
  • Use case: Before merging a cross-layer change, run this Skill to verify the repository still follows the intended architecture rules.

Quick Start

Use the architecture-check skill to review the repository for boundary violations, import issues, and duplication before you merge changes.

Frequently Asked Questions about architecture-check

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

FAQPage Schema
How do I check architecture layer boundaries and prevent upward imports before merging?

To check architecture layer boundaries, run a boundary scan during code review to confirm Core, Services, and UI layers stay properly separated. This prevents upward imports and enforces strict layer ordering before merging cross-layer changes.

What is the best way to detect code duplication and circular imports in a Python codebase?

Detect code duplication and circular imports by running an import and duplication scan on Python modules. This flags repeated hooks, routes, and service logic while identifying broken or upward imports across app layers during refactoring.

Can I enforce strict layer ordering and prevent I/O in math layers during a pull request review?

Yes, you can enforce strict layer ordering and prevent I/O in math layers during pull request review. Boundary validation confirms Core, IS 456 Code, Services, and UI layers stay properly separated when verifying repository architecture rules.

How do I validate repository architecture rules after a cross-layer refactor?

Validate repository architecture rules after a refactor by running boundary, import, and duplication scans. This confirms the repository still follows intended layer ordering rules and catches duplicated logic before merging cross-layer changes.

Why does my Python module import validation fail with upward imports across app layers?

Python module import validation fails with upward imports because strict layer ordering rules are enforced. Import checking detects circular, broken, or upward imports across app layers to prevent architecture violations from destabilizing the codebase.